Create a mergebot

Automate repository merges and tasks by creating a mergebot in Unity Version Control.

Read time 1 minute

Last updated 10 months ago

Mergebots automate tasks and merges in your repository. To understand mergebots and what you can use them for, refer to Mergebots.

You can create a mergebot in your Unity Dashboard:

Open the Version Control repository, and select the Settings button.
Select the New mergebot button.
Select either Trunk bot or Conflicts bot as your Mergebot type.
Select the branch you want to use as your Destination branch.
Enter an identifying name and description for the mergebot.
Configure your mergebot.
Note
For more information on the mergebot configuration options, refer to the Mergebot configuration section of the Mergebots page.
Select Save.

Apply the mergebot to a branch

Your mergebot processes branches that have the

resolved

status attribute. You can add the status attribute through either the desktop client or the Cloud dashboard.

Select the arrow icon on a branch to expand the details.
Scroll to Attributes.
In the Name dropdown, select the status attribute you created with the mergebot.
Enter the resolved status value you defined when you created the mergebot.
Select Add.

On the Branches tab, select the branch.
Select Show properties > Apply attributes.
Select status from the Attribute name dropdown, and select resolved from the value dropdown.
Select Apply.

You can also set an attribute through the CLI:

cm attribute set att:status br:/main/example-branch resolved

For more information, refer to the

attribute set

For a full tutorial on how to create a Trunk bot, refer to the Create a mergebot Unity Learn tutorial.