Title: Write a Migration Guide for WordPress Author: WordPress.org Published: May 8, 2026 --- # Write a Migration Guide for WordPress ## In this article * [Before you start](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#before-you-start) * [Steps](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#steps) * [Contribution checklist](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#contribution-checklist) * [What happens next](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#what-happens-next) * [Help](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#help) [↑ Back to top](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#wp--skip-link--target) **Function:** Write **Type:** Project **Level:** Beginner Help people move their content to WordPress by writing a migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. guide. Pick a platform, document the step-by-step migration process, and submit your guide to the Data Liberation project. Migration guides are one of the most direct ways to make the web more open, and every new guide helps someone make the switch. ## 󠀁[Before you start](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#before-you-start)󠁿 Complete the [common setup](https://make.wordpress.org/handbook/pathways/before-you-begin/?output_format=md) first, then: * **Setup:** You’ll need a GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. [https://github.com/](https://github.com/) account to submit your guide as a pull request. If you want to test the migration process yourself, set up [WordPress Playground](https://playground.wordpress.net/) or a local WordPress install * **Read:** Read through the [Data Liberation project overview](https://wordpress.org/data-liberation/) to understand the vision and how migration guides fit into the bigger picture * **Connect:** Join [#data-liberation](https://wordpress.slack.com/archives/data-liberation) on SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/). The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/) and introduce yourself ## 󠀁[Steps](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#steps)󠁿 1. **Find a guide to write or update.** There are two ways to contribute. You can write a new guide by browsing the [good first issues](https://github.com/WordPress/data-liberation/labels/good%20first%20issue) and [guide issues](https://github.com/WordPress/data-liberation/labels/guide) on GitHub to see which platforms still need a migration guide. Or you can update an existing guide by reviewing the [published migration guides](https://wordpress.org/data-liberation/guides/) and checking whether the steps are still accurate and up to date. 2. **Study the existing guides.** Look at the guides in the [guides folder](https://github.com/WordPress/data-liberation/tree/trunk/guides) on GitHub to understand the format and structure. Use these as your template. 3. **Walk through the migration yourself.** If possible, set up an account on the source platform, create some test content, and migrate it to WordPress. Document each step as you go, including any workarounds or gotchas you encounter. 4. **Write your guide.** Follow the same structure as the existing guides. Be specific, include screenshots where helpful, and write for someone who has never used WordPress before. 5. **Submit a pull request.** Add your guide to the [guides folder](https://github.com/WordPress/data-liberation/tree/trunk/guides) in the Data Liberation repo and open a PR. Reference the relevant issue if one exists. Let the team know in #data-liberation that your PR is ready for review. ## 󠀁[Contribution checklist](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#contribution-checklist)󠁿 * New guide written or existing guide reviewed and updated * Guide follows the same structure as existing guides in the repo * Pull request submitted to the Data Liberation repo ## 󠀁[What happens next](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#what-happens-next)󠁿 A project maintainer will review your PR and may suggest changes. If there’s no response after two weeks, follow up in #data-liberation. Once your guide is merged, it will be published on the [Data Liberation guides page](https://wordpress.org/data-liberation/guides/) and help real people migrate their content to WordPress. Pick another platform and write another guide, or explore the other [phases of the Data Liberation project](https://github.com/WordPress/data-liberation/discussions/77). ## 󠀁[Help](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#help)󠁿 Stuck? Check the [getting help guide](https://make.wordpress.org/handbook/pathways/before-you-begin/?output_format=md#getting-help), then ask in [#data-liberation](https://wordpress.slack.com/archives/data-liberation). **Further reading:** – [Phase 1: Migration Guides and Community Tools](https://github.com/WordPress/data-liberation/discussions/77)– [Data Liberation GitHub repository](https://github.com/WordPress/data-liberation)– [Published migration guides](https://wordpress.org/data-liberation/guides/) – [Data Liberation project plan](https://make.wordpress.org/core/2024/05/03/data-liberation-project-plan/) First published May 8, 2026 Last updated May 8, 2026 Edit article [ Improve it on GitHub: [article_title] ](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fhandbook%2Fpathways%2Fwrite%2Fwrite-a-migration-guide-for-wordpress%2F&locale=en_US) Changelog [ See list of changes: [article_title] ](https://make.wordpress.org/handbook/pathways/write/write-a-migration-guide-for-wordpress/?output_format=md#) [ Previous: Update Theme Check Plugin Documentation](https://make.wordpress.org/handbook/pathways/write/update-theme-check-plugin-documentation/) [ Next: Test](https://make.wordpress.org/handbook/pathways/test/)