What Reloque reads from Sanity
Reloque reads the dataset through Sanity's API, drafts included. Sanity keeps its schema in the Studio's code, so document types and their fields are read from the documents themselves, and told apart by name and fields: a type for posts, one for pages, your own types as types of their own, authors, and categories and tags. Images and files come as media. Portable Text keeps its headings, lists, links, formatting and images, and references between documents point at the moved records. Translations made with document internationalisation come as each record's languages, an SEO object reaches the other CMS's SEO fields, and menu and redirect documents come as menus and redirects.
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.
What to plan for
Better to know now than after the switch. The free scan names anything on your site that cannot move.
- Sanity: Sanity has no members or comments, so neither moves into or out of it.
- Sanity: A block of your own in Portable Text, such as a call to action, keeps only a link to what it points at.
- Sanity: Translations kept field by field inside one document (internationalised arrays) are not read yet; translations as documents of their own are.
- Sanity: Documents Reloque writes into types your Studio has no schema for are stored, but the Studio shows them only once its schema has those types.
- Sanity: Site settings and dictionary items have no place in Sanity, so they are left out.
- 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
Sanity: One hosted service, so there are no versions to choose. Any Studio version works, as Reloque talks to the project's API.
Payload: Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB).
Questions
Can Reloque migrate Sanity to Payload?
Yes. Reloque moves content from Sanity to Payload, for early-access members now. One hosted service, so there are no versions to choose. Any Studio version works, as Reloque talks to the project's API. Checked on Payload 3.92 (Postgres), 2.32 and 1.15 (MongoDB).
What does a migration from Sanity 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. Sanity is only ever read.