Updates/Migration API
AnnouncementIn progress
Migration API

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.

Alaina Koerber
Warm regards,Alaina KoerberProduct Manager
Alaina Koerber

Alaina Koerber

May 20, 2024

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

Alaina Koerber

May 15, 2024

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

Alaina Koerber

Alaina Koerber

April 22, 2024

Example scripts for Migration API to automate your content import

On the basis of an example of migrating HTML content of a 2 language website into a new Prismic repo, the Migration API scripts demonstrate the following steps:

  • Extracting and uploading of media to the Asset API, either via URL or via files
  • Inserting media ids into your document content
  • POSTing documents
  • Creating localized translations of original language documents
  • Updating content to resolve links between documents

Fresh out of the oven


Enabling update of display title in migration API

Shipped May 31, 2024
PUT request with Migration API showing a title field that will update the document title in Prismic

Scripts for mapping content migration

Shipped May 2, 2024
An image of Prismic Migration API scripts GitHub repo.

Deprecate the legacy import/export feature

Shipped April 30, 2024

View and edit migration release documents

Shipped March 18, 2024

More capabilities for bulk updates

Shipped March 15, 2024

What else is cooking?

Updated Invalid Date

General availability of the Migration API

Updated Invalid Date

Publish 3,000 migrated documents at once

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.

There's more to explore

Discover the latest features and get a sneak peek at what's coming next.