Moving Content Within ButterCMS

Do you want to migrate content within ButterCMS?

Enterprise customers enjoy Multisite + Multi-environment capability and our Migrations tool which can be used for easily migrating content across sites and environments in ButterCMS.

Migrating Content Schema Within Butter

Using multiple environments is a development best practice for creating new content experiences. Working in a non-production environment helps separate experimental changes so you can safely work without accidentally impacting your production application.

ButterCMS Migrations make migrating configuration data across your sites and environments dead simple. Simply create a Migration from a test environment that specifies what you want to migrate and to which environment.

For example, let's say we are working on creating a new FAQ section for our ButterCMS site, so we've developed an FAQ Page Type in our ButterCMS site's Dev environment. Now we are ready to move it to our Staging environment, simply create a Migration:

Migrating Content Within Butter

Content migrations support cross-site and multiple destinations. You can migrate an entire site, pages, components, and collections across websites and to multiple environments. With a few clicks, you can migrate a Page, a Page Type and its associated pages, or a Collection and all of its items, making it easy to stage new content experiences and instantly launch them into your production environment when ready.

Entire site migration

  1. If you request a migration from Production to any other environment, a system-generated email will be sent to our Customer Success Team with the clone details. You should expect feedback on your request within 24-48 hours.

  2. If you request a migration TO a Production environment from any other environment, a system-generated email will be sent to our Dev Team. The turnaround time for those requests usually take longer but rest assured that we will update you as soon as it has been completed.

IMPORTANT: This action will remove any existing content from the selected environment(s)!

You can also view a log of all the migrations that took place in each environment so you can keep track of everything:

Note: Our migrations feature does not support incremental updates, yet.

Configuration versus content

A quick note on migrating configuration data versus content across ButterCMS environments. Configuration data (Page Types and Collections) in Butter is akin to a schema for a database. They are distinct from the content (data in a database). We recommend using ButterCMS environments for Migrating schema only. For example, testing out launching a new PageType or Collection or making changes to an existing one. Since this impacts the structure of the JSON from our API, you will want to test this in coordination with code changes in your application to display this new content. You can do this safely via ButterCMS environments and migrate across environments using our schema Migration feature.

How to handle References

ButterCMS has a powerful feature called References which allows you to create relationships between your content types. In database terminology, this is like a foreign key from one table to another. Here's how to handle this when migrating:

  • PageTypeA has Reference to PageTypeB
  • Migrate PageTypeB first
  • Then migrate PageTypeA

Still have a question?

Our Customer Success team is standing by to help.