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 installment of the Cosmic Developer Spotlight Series, we sat down with Sumit Kharche, a Full Stack Software Developer residing in Pune, India. Submit is an active member of the Cosmic Community, having recently built the new React Static Blog, which is available in the Cosmic Apps Marketplace. With more community projects on the way, we're excited to interview one of our own for this Spotlight. 😎 Follow Sumit on Twitter, LinkedIn and GitHub, and enjoy the conversation.

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.

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

We’re excited to announce the official release of Gatsby Preview for Cosmic that enables you to add powerful content preview functionality to your Cosmic Gatsby website.

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 released our additional users Add-on a few weeks ago and it has become one of the most popular products. We think customers really like the flexibility it gives their team to upgrade just a portion of their usage plan instead of jumping up to the next plan. With that flexibility in mind, we are happy to offer two more add-ons to help you get the most out of Cosmic while allowing more billing flexibility.

Get Started with Cosmic

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