OneMerge Configure a Merge Ruleset
This article provides step-by-step instructions on OneMerge Configure Merge Ruleset and how to do this. The Master Record is created for the Salesforce Object according to the Merge Ruleset definition. OneMerge installs default Merge Rulesets for the Account, Contact, Lead objects, and also for PersonAccounts. NOTE: It is advisable to Clone the Standard Merge Ruleset first and use the cloned one for making configuration changes. That way you will have the original Merge Ruleset to reference back to if required.
Option 1 – Guided Setup Free Edition
Follow these steps to configure a Merge Ruleset:
- 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 Edit the Merge Ruleset and click the Next button.
- You can retain the default values for the Merge Ruleset displayed on the next screen, or amend them. Click the Next button.
- The next screen shows the default values for the Merge Ruleset Priority that determine the Master Record during Merge. You can keep them as they are or make changes. Click the Next button.
- The next screen shows the Merge Ruleset Fields that appear on the Master Record. You can keep them as they are or make changes. Click the Next button.
- Click the Finish button on the next screen to see a success message.

Option 2 – OneMerge Configure Merge Ruleset, Guided Setup Standard and Enterprise Edition
Follow these steps to create a new Merge Ruleset.:
- From the OneMerge Application Home Page, click Guided Setup in the footer.
- On the first screen, choose Setup Action Manage Merge Rulesets and then click the Next button (as shown below).
- On the next screen, choose Create New and click on the Next button.
- On the next screen, choose the Salesforce Object and click the Next button.
- Click the Next button on the next screen to confirm the Salesforce Object and the Duplicate Rule it applies to.
- On the next screen, enter the Merge Ruleset values that you will use to determine the Master Record, click the Next button.
- On the next screen, enter the Merge Ruleset Priority values that you will use to determine the Master Record during Merge, click the Next button.
- On the next screen, enter the Merge Ruleset Field Names that are displayed on the Master Record, click the Next button.
- On the next screen, select the Duplicate Rule(s) the Merge Ruleset should be associated with, and then click the Next button. Note:This step is optional.
- On the next screen, select the Matching Rule(s) the Merge Ruleset should be associated with, and then click the Next button. Note:This step is optional.
- Click the Finish button to display a success message on the next screen.
- Refresh the OneMerge Home Page and check the Merge Ruleset Status panel to see the newly created Merge Ruleset. This pane will display any issues.

Option 3 – Custom Metadata Types
Follow these steps to configure a Merge Ruleset:
- Open the Salesforce Setup menu.
- Select Custom Code>Custom Metadata Types.
- Click Manage Records Merge Ruleset.
- Click on the New button.
- Enter the details for the Merge Ruleset and click the Save button.

Option 4 – Merge Rule Setup Tab (Free, Standard and Enterprise Editions.
There is the ability to be able to configure and setup new Merge Rulesets within the Merge Rule Setup Tab. The following Training Articles provide further information and the following demo also shows how to do this in the Merge Rule Setup Tab.
Additional Information
A new configuration option has been added in version 1.74 (Winter 25 Release), Catch-all (Standard and Enterprise Editions).

When the “Is Catch-all?” option is ticked and Default Merge Rule Priority settings are defined, then all fields that are not added to a Merge Rule are updated on the Master Record from the record evaluated to have the highest priority value. Note, the running user for the merge operation must have update access to the fields. Also, in a cross-object merge context, records from a different Salesforce object to the Master Record are ignored.
If you require any assistance with OneMerge Free, Standard or Enterprise Edition, please do not hesitate to contact us at hello@onemerge.co.uk.
Article last reviewed: 2026-02-17