Loading

Customize Matching Rule Limits

Publish Date: Apr 22, 2026
Description

When customizing Matching Rules, Salesforce enforces thresholds on certain values for performance reasons. These thresholds help ensure duplicate detection remains fast and reliable across your organization's data.

Available Editions:

Professional, Enterprise, Unlimited, and Developer

Hardcoded Limits:

  • Up to five matching rules can be activated or deactivated at a time.

  • Up to five active matching rules are allowed per object.

  • Up to 25 total active matching rules are allowed.

  • Up to 100 total matching rules are allowed (both active and inactive).

  • Only one lookup relationship field is allowed per matching rule.

How to Increase:

These limits are hardcoded and cannot be increased by Salesforce Support.

Prerequisites:

Review Salesforce documentation on working with Matching Rules and Duplicate Management before reaching out to Support.

Resolution

These limits are hardcoded to maintain system performance when comparing records for duplicates. Matching rules perform complex comparisons across potentially millions of records, so limits help ensure duplicate detection remains fast and reliable.

If you reach these limits, consider consolidating similar rules or using more specific criteria to reduce the number of active rules needed.

Requesting a Limit Increase:

These values are hardcoded and cannot be increased by Salesforce Support. If you would like to see these limits increased in future releases, create an Idea on our Idea Exchange.

Additional Resources
Knowledge Article Number

000392912

 
Loading
Salesforce Help | Article