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 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.
- 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.
- 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
Sanity: One hosted service, so there are no versions to choose. Any Studio version works, as Reloque talks to the project's API.
Contentful: One hosted service, so there are no versions to choose. Both regions, main and EU, work.
Questions
Can Reloque migrate Sanity to Contentful?
Yes. Reloque moves content from Sanity to Contentful, 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. One hosted service, so there are no versions to choose. Both regions, main and EU, work.
What does a migration from Sanity 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. Sanity is only ever read.