Forking + Merging: A Conflict Resolution Solution

One of our New Year’s resolutions at Postman is to avoid unnecessary conflict and to help our users do the same, which is why we’re excited to introduce version control in Postman 6.7! Similar to branching and merging in version control systems, this new functionality gives Postman teams more control over their collaborative workflows.

Forking a collection creates a linked version of that collection that syncs for teammates who are in the workspace where the the fork was created. This makes it simple for teams to make and test changes without affecting the base collection. After making changes, users can view the diff, verify changes, resolve conflicts, and merge those changes back to the base collection.

This functionality improves collaboration for teams by allowing multiple teammates to work off of different versions of Postman Collections in real time.

How to Fork a Collection in Postman

1. Go to your collection and click the ellipsis ()

2. Select “Create a fork”

Creating a new fork in Postman.

3. Give your fork a label – this will be used to identify this fork, and distinguish it from the parent

Give your fork a label to distinguish it from the parent.

4. That’s it! You'll see your fork added as a new collection with its given label

Forked collection with fork label.

How to Merge a Collection and View the Diff in Postman


1. Go to your collection and click the ellipsis ()

2. Select “Merge changes” and you’ll be taken to your dashboard

Merge changes in Postman.

3. Within your dashboard, you can view the diff, select which changes you’d like to use, and resolve any conflicts

View the diff and select changes within the Postman dashboard.

4. Once you’ve addressed all changes and conflicts, select “Merge all changes”

Select changes, and view the diff from the Postman dashboard.

5. You’ll be prompted on whether you want to:

  • update the destination (the original) with the changes,
  • update both the source (the fork) and destination with the changes, or
  • update the destination and delete the source.
Select how you want the destination and source to be updated.

This new functionality paired with another recent Postman launch, comments on collections makes it even easier to collaborate with your team in Postman!

Happy forking and merging everybody!

Author: stacee

Marketing @ Postman 👋