OneMerge Custom Merge Rule
The purpose of this article is to provide step-by-step instructions on OneMerge Custom Merge Rule and how to create them for a Merge Ruleset. This can be up to 50 Merge Rules per 5 Merge Rulesets for OneMerge Enterprise Edition, 10 Merge Rules per 1 Merge Ruleset OneMerge Standard Edition and 5 Merge Rules per 1 Merge Ruleset OneMerge Free Edition.
Option 1 – Guided Setup Free Edition
Follow these steps to create a OneMerge Custom Merge Rule:
- From the OneMerge Application Home page, click Guided Setup in the footer.
- On the first screen select the Setup Action Configure Merge for a Salesforce Object, and click the Next button (as shown below).
- On the next screen select the Salesforce Object and click the Next button.
- On the next screen select Manage Merge Rules and click the Next button.
- The next screen displays a list of the existing Merge Rules for the Salesforce Object, click Create New and the Next button.
- On the next screen, enter the Merge Rule values, click Save and the Next Button.
- The next screen should show a success message, click the Finish button.

Option 2 – Guided Setup Standard and Enterprise Edition
To create a Merge Rule, follow these steps:
- From the OneMerge Application Home page, click Guided Setup in the footer.
- On the first screen select the Setup Action Manage Merge Rulesets, and click the Next button (as shown below).
- On the next screen, select Standard Merge Rulesets for Accounts , click Edit the Selected Setting and click the Next button.
- On the next screen select Manage Merge Rules, and click the Next button.
- The next screen displays a list of the existing Merge Rules for the Salesforce Object, click Create New and the Next button.
- On the next screen, enter the Merge Rule values, click Save and the Next Button.
- The next screen should show a success message, click the Finish button.

Option 3 – Custom Metadata Types
To create a new Merge Rule, follow these steps:
- Open the Salesforce Setup menu.
- Select Custom Code>Custom Metadata Types.
- Click Manage Records Merge Rule.
- Click on the New button.
- Enter the details for the Merge Rule and click the Save button.


Example:
- Label = Billing Address
- Merge Rule Name = Account_Billing_Address
- Merge Ruleset = Standard Merge Ruleset for Accounts (You can select the Standard Merge Rulesets or Custom ones)
- Is Active = TRUE
- Priority = Newest (You have the option here of selecting newest, oldest or quality for the Billing Address Merge rule, so in this example, when records match and merge, the newest Billing Address will be appended to the Master Record)
- Click on Save.

Option 4 – Merge Rule Setup Tab (Free, Standard and Enterprise Editions.
There is the ability to be able to setup new Merge Rules within the Merge Rule Setup Tab. The following Training Articles provide further information.
The following demo shows how to edit existing Merge Rules using the Merge Rule Setup Tab.
Article last reviewed: 2026-02-19