Introducing Merge Requests

Cosmic Blog
Cosmic Blog Introducing Merge Requests
by Cosmic on January 12, 2021

Traditionally, CMS systems have long relied on a draft / published model for content updates within a single database. And for many use cases this is fine. But what we’ve noticed with our users, is that they want to create multiple environments to stage updates for review, preview the changes, then push the changes to production.

The problem with this is that there wasn't an easy way to merge content changes between environments in review stages (such as Development, Staging, Production). This is especially true when you want to make bulk edits to lots of content.

It's for this reason, we're excited to announce a huge leap forward for content management...

Introducing Merge Requests

What are Merge Requests?
Merge Requests is a new feature that enables Git-like workflows between your Cosmic Bucket environments. With Merge Requests, you are now able to merge content between Bucket environments with bulk edits, preview, and approval workflows. Here's how it works...

Edit Content - A content editor creates or edits content in a source Bucket.

Create Merge Request - The content editor then creates a merge request from the source Bucket into a target Bucket. Diffs are displayed in a list for review.

Request Approvals - Team admins may be invited to review and approve the updates.

Approve and Merge Changes  - The team admin can then use preview links to preview changes on the user-facing application or website. Once all approvals are submitted, the admin merges the request into the target Bucket.

Revert Changes - If there is a need to revert, a backup will automatically be made prior to the merge, and you will be able to restore to this backup instantly, and at anytime in the future. (Automatic backups will need to be enabled on the Production Bucket)

When is it available?

How much does it cost?
It's free on every Cosmic account.

Next Steps

There's a few ways to get started and learn more:

  1. Install the Starter - Install the Next Merge starter which includes merge request preview capabilities.
  2. Preview API - View the docs to get more information on how to implement the merge request preview content for your applications. Currently available via the REST API and NPM module.
  3. Dashboard - Log into your Cosmic dashboard and click the merge request icon on any Bucket.


Merge Requests enables your team to move beyond the rigid draft / publish content process into a more fluid, collaborative, and comprehensive workflow.

We hope you enjoy using Merge Requests to optimize your content management workflows. This feature is still a work in progress (currently in beta), and we would greatly appreciate any feedback or bug reports. If you have any questions, please feel free to reach out on Slack, let us know what you think on Twitter, and join the conversation around this feature on Product Hunt.

Cosmic Team

You may also like

In this episode of the Cosmic Developer Spotlight Series, we chatted with Lydia Hallie, remote software developer and active contributor on She has been getting a lot of attention for her easy-to-follow (and beautifully visual!) educational resources for JavaScript. Follow Lydia on Twitter, GitHub, LinkedIn, and enjoy the conversation.

For the last few months, we've been hard at work building an entirely new Cosmic dashboard. Built from the ground up, our new dashboard promises to be faster, easier to use, and more beautiful than any CMS dashboard you have ever seen.

Is it time to give REST a rest? GraphQL is a language and database agnostic querying language that might just leave RESt in its dust.

GraphQL vs. ReST - which works better for your application? This article compares similarities and key differences, and provides considerations for when to choose one or the other.

Both Gatsby and Next.js are among the most popular frameworks for websites and online applications. In this article, we’re going to compare Gatsby vs. Next.js to help you choose the right framework for your next web project. We’ll talk about how they handle data and render static websites.

We're excited to announce a new way to collaborate with your team on your digital projects. Introducing Workspaces.

Get Started with Cosmic

Build personal projects for free. Add your team at unbeatable prices.
Start Building Talk to Sales