# Contribute a Blog Post

Thanks for considering a contribution to the XRP Ledger Dev Blog!

This page includes high-level instructions to create a new blog post. Detailed instructions and guidelines to contribute to the XRPL Developer Portal are available in [Contribute Documentation](/es-es/resources/contribute-documentation).

Blog posts are currently only available in English and are not yet translated.

## Directory Structure for Blog Posts

The source files are located in the `blog` directory of the public `xrpl-dev-portal` repository.

The image files used in blog posts are located in the `blog/img` directory.

The blog posts are grouped by year, so all blog posts published in year 2025 are located in the `blog/2025` directory.

## Steps to Create a New Blog Post

To create a new post, follow these steps:

1. Before you begin, ensure that you pull the most recent updates from the upstream `master` branch of the `xrpl-dev-portal` repository.
2. Create a new branch for the blog post using the format `blog-{short-desc-of-update}`.
3. Create a new markdown file in the `blog/{YEAR}` folder, for example https://github.com/XRPLF/xrpl-dev-portal/tree/master/blog/2025
4. Refer to the template file [`_blog_template.md`](https://github.com/XRPLF/xrpl-dev-portal/tree/master/resources/contribute-blog/_blog-template.md) to compose your draft blog.
5. Update the `blog/sidebars.yaml` file to include the newly created file.
6. When the draft is ready for review, save and commit your updates.
7. Create a new PR to merge your changes to master.