Migrate your content to Prismic with speed and confidence
Experience a smooth content migration with Prismic's Migration API. Transfer content to Prismic fast and without hiccups.
Hi everyone,
Alaina here, excited to bring you a significant update from our team at Prismic! After numerous discussions with developers across our community, especially those working in agencies, we’ve recognized a critical challenge: migrating content from other CMS platforms to Prismic is often seen as a tedious and lengthy process.
So, I’m thrilled to announce the launch of our brand new Migration API!
This API will allow you to streamline your development processes and support you in launching faster with Prismic.
Why did we create the Migration API?
Our interviews highlighted the need for a native content migration process. In most cases, the primary use is to facilitate the transfer of your content from any CMS to Prismic. A secondary use case we also heard about is to manage bulk updates efficiently or import externally generated content, such as translations. The Migration API is designed to simplify these tasks significantly.
Key release milestones:
- Beta release: We launched the beta version to get your firsthand feedback in September 2023.
- Localization capabilities: Creation of a document that is a translation of an existing document was introduced in October, 2023.
- Enhanced support: The API now supports legacy slices and integration fields as of January 2024.
- Quicker publication: We added the migration release, which allowed publication of up to 1,000 migrated documents with one click, in December, 2024 and are now planning on scaling that capacity further in Q3 2024.
- Simplified content transformation: We provided scripts to facilitate every step of migration, demonstrating how to go from HTML files to Prismic pages with images, document links and Prismic RichText format, in March 2024.
- Future-ready: We deprecated our older Import/Export functionality in April 2024 in favor of this more robust API.
How this benefits you
The Migration API isn’t just about making migrations quicker; it’s about enhancing your overall workflow, enabling you to launch websites faster and with fewer complications, and allowing you to spend your development time on features that will generate growth for your company.
This is part of our ongoing commitment to refine our tools in alignment with your direct needs, collected through continuous interactions with you, our user community.
See the Migration API in action
For a more detailed understanding and to see the Migration API firsthand, please visit the Migration API docs.
Thank you for your ongoing support and for sharing your needs with us. As always, your feedback is invaluable. It shapes our roadmap and helps us refine our new tools and features to better serve you. Together, we’re not just building websites; we’re crafting exceptional digital experiences.
Lucie Haberer
New helpers are released in beta
This week we released two new helpers in beta as part of our @prismicio/client package: unstable_htmlAsRichText and unstable_markdownAsRichText. Those new helpers respectively help you convert your existing HTML and Markdown content to Prismic rich text format with flexibility when migrating to Prismic.
Why unstable_?
While carefully tested and capable, the new helpers' APIs, names, and implementations may still change in the future not following SemVer. We will announce in a future update when their APIs become set in stone.
Getting started
You can use those helpers as part of @prismicio/client v7.7 or higher. Learn more about their usage in the updated client technical references.
Alaina Koerber
Coming soon: Update document display titles in Prismic via migration API
We heard your feedback and we're enabling programmatic update of document titles.
This enhancement should be available by the end of May.
Alaina Koerber
A bulk update script to quickly update existing content
Often, you need to update your documents in bulk – for example if you decide to change a translation of a common term or replace a widely-used asset with a different one.
With the help of a bulk update script, automating these updates via the Migration API saves time and ensures you cover all affected documents. We cover the following examples:
- Retrieving all existing documents from the Document API
- Or fetching documents in batches if you have a repo with a lot of content
- Inserting a new field with new content in each document
- Making a PUT request to the Migration API using the updated document content
Fresh out of the oven
What else is cooking?
General availability of the Migration API
A performant Migration API that no longer requires an API key to use
Publish 3,000 migrated documents at once
Scaling the capacity to publish migrated documents from 1,000 to 3,000 in one click.
Stay in the loop
Subscribe to our newsletter to be the first one to learn about upcoming and freshly released features.
Have questions? We have answers.
Which plans include Migration API?
Migration API is available on every plan. Check out our pricing page to find a plan that suits your needs.
How do I get started with the Migration API?
There's more to explore
Discover the latest features and get a sneak peek at what's coming next.
