Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
  • On-Prem
    • Server configuration
    • Client configuration
    • Manage On-Prem licenses
    • Stop, start, or restart server
    • Server administration console
    • Configure UVCS
      • Server configuration files
      • Configure lock rules
      • Merge rules
        • Set up merge rules
        • Types of merge rule
      • Configure file compression
      • Proxy servers
      • Use a proxy server
      • Support alternative connections to a server
      • Configure repository storage
    • Use server read-only mode
    • Back up and restore data
    • Archive revisions
    • Force client upgrades
    • SSL certificates
    • GitServer
    • Use SAML authentication with Microsoft Entra
  • Gluon
  • CLI and shortcut references
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Set up merge rules

Set the rules for merging branches.
Read time 1 minute
Last updated a year ago

Edit the
mergerules.conf
file in your
server
directory to configure your merge rules.
Note
You can also set up merge rules in your webadmin server administration console.
The mergerules.conf file is a JSON file that contains your merge rules. To add a merge rule, you need to place the rule inside an array:
[{ "enabled": true, "repositories": "code*", "rule": "only_allow_merges_if_reviewed", "to": { "branchNames": ["main"], "branchesWithAttribute": [ { "attribute": "merge_only_reviewed", "value": "enabled" } ] }, "from": { "branchNames": ["scm*"], "branchesWithAttribute": [ { "attribute": "task", } ] }}]
You can use the following parameters to define your merge rules:

Parameter

Description

enabled
Enter
true
to enable the merge rule, and
false
to disable the merge rule.
repositories
Use patterns to match any repositories you want the merge rule to apply to.
rule
Specify the merge rule to use. To find the available merge rules, refer to the page on types of merge rules.
to
Specify any destination branches you want to apply the merge rule to.
from
Specify any source branches you want to apply the merge rule to.
You can filter the branches that you apply the merge rule to. Use the following parameters under either
to
or
from
:

Parameter

Description

branchNames
Use this key to specify the branch names or that you want to apply the merge rule to. Use an
*
to represent any sub string.
brancheswithAttribute
Use this key to filter branches by attribute. Specify the
attribute
name and, if necessary, a
value
.
    
attribute
If you filter branches by attribute, use this key to specify which attribute to use.
    
value
If you filter branches by attribute, you can specify a value for the attribute.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.


    Report a problem with this page