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.

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/_current_year_ folder, for example https://github.com/XRPLF/xrpl-dev-portal/tree/master/blog/2025

4. Refer to the template file _blog_template.md to compose your draft blog.

5. Update the blog/sidebar.yaml file to include the newly created file.

6. Once the draft is ready for review, save and commit your updates.

7. Create a new PR to merge your changes to master.