Migration routeIn early access

Migrate from Payload to Contentful

Reloque moves your Payload content into Contentful: posts, pages, media, SEO data and redirects. It maps every field, previews every record and tests a sample on Contentful before the real move.

Join early access Free for early-access members: we look at your Payload site with you before anything moves.

What Reloque reads from Payload

Reloque reads your collections, uploads and relationships with a user's API key, from Payload 1, 2 or 3, with blocks, arrays and groups read as structured content, not flattened. A localized site is read in every locale, and its globals (site settings, header, footer) go to the new site's globals or single types of the same name. A header's or footer's links become menus on WordPress, and the redirects plugin's redirects move too, each to its page's new address. Payload has no front end, so you can give the public site's address when connecting, and links to it in the content are pointed at the migrated records.

How it lands in Contentful

Records go into the space's own content types, matched by name, or into Blog post and Page types Reloque adds when the space has none and your role allows it. Bodies become Rich Text, with images uploaded as assets and links between records as links between entries. Categories, tags and authors become entries of the types the space links to, or Contentful tags. Each language goes into the locale of the same language, in the fields that are localized. SEO data goes into the type's SEO fields or an SEO entry, menus into menu and menu item entries and redirects into redirect entries, with types added for them where the space has none. Published records are published.

What to plan for

Better to know now than after the switch. The free scan names anything on your site that cannot move.

  • 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.
  • Contentful: Contentful has no members or comments, so neither moves into or out of it.
  • Contentful: An entry embedded in Rich Text, rather than linked, keeps only its title, as a link.
  • Contentful: Reloque does not add locales: add each language under Settings › Locales first, or it is left out with a note.
  • Contentful: Contentful sets its own publish date, so the original date goes into a date field of the type where it has one.
  • Contentful: Site settings and dictionary items have no place in Contentful, so they are left out.

Versions checked

  • Payload: Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB).
  • Contentful: One hosted service, so there are no versions to choose. Both regions, main and EU, work.

Questions

Can Reloque migrate Payload to Contentful?

Yes. Reloque moves content from Payload to Contentful, for early-access members now. Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB). One hosted service, so there are no versions to choose. Both regions, main and EU, work.

What does a migration from Payload to Contentful 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 Contentful where it keeps redirects, or ready as a CSV for your host or front end. SEO titles, descriptions and social images move where Contentful has a place for them.

Is anything written to Contentful before I approve it?

No. You see every record in the Preview first, then a small sample is written to Contentful so you can check it on the real site, and undo it. Payload is only ever read.

Early access

Planning this move?

Reserve a free assessment and tell us you are moving Payload to Contentful. We will look at your site with you before anything moves.

Plan this move with us

Early access is free. Tell us both systems when you reserve.

Free assessment

Moving Payload to Contentful?

Reserve a free assessment and we look at your Payload site with you: what moves to Contentful, what stays, and the price. Nothing is written until you approve it.

Get your free assessment
Early-access members get a free migration assessment.
  1. Connect both sitesReloque reads the source and checks it may write to the destination.
  2. Check the mappingEvery field is matched, and the uncertain ones are yours to decide.
  3. Test a sampleA few records are written to the destination, read back and removed.
  4. Move the restEvery record is written and checked, with redirects for old addresses.