Back to all posts

Use Migrations for Smoother Multi-Environment Workflow

Posted by Jake Lumetta on July 31, 2019

Last month we announced our multi-site dashboard which allows you to manage multiple websites and environments all from one place. So you get a really nice admin level view and can quickly switch between your various websites and their environments all from one central place, which is a great capability. 

buttercms migration dashboard

The reason why you want to use multiple environments is because it's a development best practice. So what this allows you to do is using multiple environments you can work in a non-production environment which helps separate experimental changes away from your production environments so that you can safely work on new content experiences or changes to your current content experiences without accidentally impacting your production application. 

So you do the development and testing in the dev and or stage environments, and once you're satisfied and everything is production ready you can then deploy those changes to production. 

And this month we're really excited to announce a feature called migrations. ButterCMS migrations make migrating configuration data across your environments that simple. Simply create a Migration from a test environment that specifies what you want to migrate and to which environment.

ButterCMS migration dashboard

Here's the new migration dashboard where you'll have this enabled in your account if you have multiple environments set up in your ButterCMS account. 

And to migrate data let's say from your development environment to your staging environment, you simply click on new migration, and from here you can then pick what content type you want to migrate, from which environment you want to migrate from and which environment you want to migrate to.

ButterCMS migration dashboard

In this particular example I happen to be logged in to the production instance but normally you'd be logged into like a diverse staging and you could target any of your other environments. And then it's as simple as clicking migrate content and the rest is taken care of. 

ButterCMS migration dashboard

Here's another example. You can see in this particular account we're logged into the dev environment and we want to migrate one of our page types, our FAQ page type to our production environment. So again you can do all of those changes and configuration in your dev environment safely without worry of impacting a production environment. And then when you're ready to deploy that to production, you simply click migrate content and the rest is taken care of for you.You can have any number of environments configured exactly how you want in Butter.

Be sure to check out our documentation; we have full docs that take you through the entire workflow here, best practices and how to handle certain scenarios when working with multiple environments and migrating content between them. 

So again really excited to announce our migration feature and it'll make migrating content across your environments dead simple. Please let us know your thoughts and feedback. We'd love to hear what you think. Cheers! 

Related Articles