What Reloque reads from WordPress
Reloque reads posts, pages, your own post types, media, categories, tags, your own taxonomies, authors, menus, comments, SEO data, the Redirection plugin's redirects and custom fields through the REST API, an export file or the bridge file. The REST API shows only the fields a plugin registers, such as ACF's; the export file and the bridge read every one. SEO data comes from Yoast SEO or Rank Math: the SEO title and description you set, the focus keyword, the canonical address, noindex and nofollow, and the social title, description and image, but not what the plugin makes from its templates.
How it lands in Payload
Bodies become Payload rich text, images are uploaded to your upload collection, and categories, tags and authors are created where missing and linked, categories under their parents where your categories have a parent field. Blocks, arrays and groups are filled field by field, and relationships point at the migrated records. Each record keeps its old address in sourceUrl, for redirects, and with the redirects plugin installed each old address redirects to its new one, along with the old site's own redirects. A site in several languages moves into each locale of your localized fields. Members can move too, into a collection with sign-in other than your admins', without their passwords. Menus from another CMS fill a global's list of links, a main menu the header's and a footer the footer's.
A WordPress post, written into Payload
| WordPress | becomes | Payload |
|---|---|---|
| Title | title | |
| Content (blocks or classic) | content, as Lexical rich text | |
| Excerpt | excerpt | |
| Featured image | featuredImage, uploaded to Media | |
| Categories and tags | categories and tags, linked | |
| Your own taxonomies | a relationship to a collection of terms, created where missing | |
| Author | author, linked | |
| Slug and permalink | slug, and a row in redirects.csv |
What to plan for
Better to know now than after the switch. The free scan names anything on your site that cannot move.
- WordPress: Rank Math's REST API does not show its SEO data, so connect a Rank Math site with its export file or the bridge file to move it. Yoast's REST API takes SEO data on posts only, and of it only the SEO title, description and focus keyword (older Yoast, such as 19.6, takes none); what a WordPress destination with Yoast cannot take is named in the run report.
- WordPress: Page-builder layouts move as the HTML they render, not as builder settings.
- Payload: Payload has no front end, so redirects assume pages at /<slug> and posts at /blog/<slug> until you change them to your routes.
- Payload: Original publish dates are kept when the collection has a publishedAt field.
- Payload: With GraphQL turned off, fields are learned from your existing documents, so a collection with none yet takes plain values and leaves out what Payload refuses.
- Payload: Payload's locales are set in its config only, so add each language the old site has to localization, and mark the fields to translate localized, before you migrate.
- Payload: Payload has no comments of its own, so comments from another CMS are listed in the handover package.
- Payload: SEO data goes into an SEO group, your own or the SEO plugin's meta group, field by field; what the group has no field for is named in the run report.
Versions checked
WordPress: Checked on WordPress 7.1 and 6.0, and 5.5 as a source.
Payload: Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB).
Questions
Can Reloque migrate WordPress to Payload?
Yes. Reloque moves content from WordPress to Payload, for early-access members now. Checked on WordPress 7.1 and 6.0, and 5.5 as a source. Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB).
What does a migration from WordPress to Payload cost?
The assessment is free and gives your exact price: you pay for the records a migration writes, and media files do not count. Packages start at £99, and records are shared across any number of migrations for 12 months.
Will my addresses and SEO survive the move?
Every address that changes gets a redirect, written to Payload where it keeps redirects, or ready as a CSV for your host or front end. SEO titles, descriptions and social images move where Payload has a place for them.
Is anything written to Payload before I approve it?
No. You see every record in the Preview first, then a small sample is written to Payload so you can check it on the real site, and undo it. WordPress is only ever read.