Duplicate records in SuiteCRM often appear through everyday work: a user creates an account that already exists, an import brings in overlapping contacts, or two teams save the same customer in different records. Teams then work from different versions of the same information.
SuiteCRM duplicate management is easier as a lifecycle: prevent duplicate records in SuiteCRM before they are saved, then find, review, and merge records that already exist. Duplicate Detector supports checks during record creation. Duplicate Cleaner finds and merges records already in the CRM.
Why Duplicate Records Are a Problem in SuiteCRM
Duplicate customer records make it harder to see a complete picture of an account or contact. Notes, activities, and follow-up can sit on one record while another user works from a second copy of the same person or company.
Typical situations include:
- Duplicate accounts created by different users
- Duplicate contacts with overlapping details
- Inconsistent CRM information across two records for the same entity
- Users working with multiple records that represent the same customer
If two records exist for the same company, related work can be split, and teams may not know which record to use. Preventing new duplicates and cleaning up existing ones are both part of SuiteCRM duplicate detection, but they are not the same task.
Duplicate Management Has Two Stages
A useful way to think about SuiteCRM duplicate records is to split the work into before and after a duplicate exists.
Before the duplicate exists
Use a check while the user is still entering a new record. Duplicate Detector for SuiteCRM is a preventive solution: it helps identify a possible duplicate during record creation.
After the duplicate already exists
Prevention does not remove records that are already in the database. For that stage, Duplicate Cleaner for SuiteCRM is designed to find existing duplicates and merge them using the rules you configure.
In short: Duplicate Detector helps identify possible duplicates during record creation, while Duplicate Cleaner is designed to find and merge duplicate records that already exist.
The current product pages for both add-ons state support for SuiteCRM 8.8 or greater. Confirm compatibility against those pages for your own environment before installing.
How to Prevent Duplicate Records in SuiteCRM
How to prevent duplicate records in SuiteCRM starts at the moment a user clicks save on a new record. If the CRM only shows a clash after the record is already stored, the duplicate is already in the system and must be cleaned up later.
Duplicate Detector is built for that earlier step. The product page describes it as a SuiteCRM duplicate check plugin that indicates duplicate values while creating a new record, instead of waiting until after the record has been entered.
That is the prevention layer: SuiteCRM duplicate detection during create, not a merge of records that already exist.
How Duplicate Detector Identifies Possible Duplicates
Duplicate Detector does not claim AI matching, fuzzy matching, or machine learning. The documented behaviour is field-based checking while a new record is being created.
According to the current product page, the plugin works on any existing or custom field of these types:
- varchar fields
- name fields
- phone fields
It also works on the existing Email field.
The page also notes that you can know after the first field if you are working on a duplicate, rather than completing the whole form first. Treat that as the documented user experience: a check against configured fields while the record is still being entered.
Administrators should configure which of those supported field types are used for the check. The product page does not document other matching methods, so none are assumed here.
What Happens When a Possible Duplicate Is Found?
Duplicate Detector can be configured in two documented ways:
- Show a popup notification that prompts the user about duplication
- Prevent the record from being saved
Which behaviour you use depends on how strict your process needs to be. A notification lets the user review the possible match and decide what to do. Preventing save is the stronger option when you do not want a second copy stored at all.
Duplicate Detector does not merge records. Documented outcomes are a notification and, where configured, blocking the save. Existing duplicates still need a separate find-and-merge process.
What If Duplicate Records Already Exist?
Stopping new duplicates does not fix history. Imports, older manual entry, and records created before prevention was in place can still leave matching accounts or contacts in SuiteCRM.
The Duplicate Detector product page itself points to this second problem: it is a preventive solution, and existing duplicates need a remover or cleaner add-on.
That is where Duplicate Cleaner becomes relevant. It finds duplicate records using configurable rules and lets you or the system merge them. It does not replace the create-time check; it addresses records that are already there.
How to Find Existing Duplicate Records in SuiteCRM
Duplicate Cleaner finds existing duplicates based on duplicate detection rules you configure in administration, not on a single fixed matching condition.
The documented setup is:
- Select the SuiteCRM module and fields to check.
- Configure duplicate detection rules from the add-on configuration.
- Identify matching records based on those rules.
Administrators can configure multiple rules. Duplicate search rules can be set for core modules and custom modules, and custom fields are supported.
For text fields, the product page lists these conditions (depending on field type), plus other options already available in the add-on configuration:
- Equals
- Does Not Equal
- Contains
- Does Not Contain
- Starts With
- Ends With
- Exact Match
- Is Empty
- Is Not Empty
A broader rule can return more records for review. A narrower rule can reduce the set. Choose conditions that match how your data is actually stored.
How to Review Duplicate Records
Finding matches is not the same as merging them. Duplicate Cleaner includes a Duplicates module for manual processing.
In manual merge, the add-on searches for duplicates based on your rules and lists them in the Duplicates module. Users can then use the merge controls on each record.
This is the review step: look at the identified records, confirm they should be treated as duplicates, and only then complete the merge. It is the safer path when records need a human check first.
How to Merge Duplicate Records in SuiteCRM
Duplicate Cleaner documents two merge approaches.
Manual merge
- Searches using your duplicate rules
- Lists matching records in the Duplicates module
- Lets users merge records individually with the merge icons
Automatic merge
- Searches using the same style of duplicate rules
- Merges according to the auto-merge settings
- Uses the primary record field you selected to determine the primary record
The product page does not document that every field on both records is automatically combined, or that conflicts are scored or resolved by AI. What is documented is merge according to auto-merge settings and the selected primary record field, plus the option to merge related information to that primary record.
Use manual merge when you need to inspect records first. Use automatic merge when the rules and primary-record setting already match how your team wants duplicates handled.
What Happens to Related Records?
Merging is not only about the fields on the duplicate itself. A SuiteCRM record may have related activities and cases attached to it.
Duplicate Cleaner supports merging related records as part of the merge. Relationships belonging to the duplicate can be associated with the resulting primary record. The product page specifically mentions:
- Calls
- Meetings
- Tasks
- Cases
- other related records
That matters because deleting or ignoring a duplicate without moving relationships can leave Calls, Meetings, Tasks, or Cases on the record that is no longer used. Duplicate Detector does not perform this merge; related-record handling belongs to Duplicate Cleaner.
Duplicate Detection for Custom SuiteCRM Modules
Many SuiteCRM implementations include custom modules and custom fields. Duplicate handling should follow the data you actually store, not only a default Accounts or Contacts layout.
Duplicate Cleaner: duplicate search rules can be set for core modules and custom modules. Custom fields are also supported.
Duplicate Detector: the product page documents support for existing or custom fields of varchar, name, and phone types, plus the existing Email field. It does not explicitly document custom-module coverage on the current page, so that should not be assumed from this article.
Keep the two products separate: create-time field checks on one side, configurable search and merge of existing records (including custom modules) on the other.
Duplicate Detector vs Duplicate Cleaner
The table below is limited to what the current product pages document. Where a capability is not stated, the cell is marked as not documented rather than assumed.
| Requirement | Duplicate Detector | Duplicate Cleaner |
|---|---|---|
| Detect possible duplicates during record creation | Yes | No |
| Prevent duplicate record creation | Yes, where configured | No |
| Find existing duplicate records | N/A | Yes |
| Manual merge | N/A | Yes |
| Automatic merge | N/A | Yes |
| Custom modules | N/A | Yes |
| Custom fields | Yes, for varchar, name, and phone types; also the existing Email field | Yes |
| Related-record merging | N/A | Yes |
A Practical SuiteCRM Duplicate Management Workflow
A factual end-to-end process, using each add-on only for what it documents, looks like this:
- Configure duplicate detection for new records. Set Duplicate Detector to check supported field types (varchar, name, phone, and existing Email) while a record is created.
- Detect possible duplicates during record creation. Users see a notification, or the save is blocked, depending on configuration.
- Review existing CRM data for duplicates. Prevention does not remove records already stored.
- Configure duplicate rules for existing records. In Duplicate Cleaner, choose the module, fields, and matching conditions.
- Review identified duplicates. For manual work, use the Duplicates module.
- Merge records where appropriate. Use manual merge or automatic merge with the selected primary record field.
- Handle related records during the merge. Duplicate Cleaner can move related Calls, Meetings, Tasks, Cases, and other related records to the primary record.
Skipping prevention means more cleanup later. Skipping cleanup leaves historical duplicates in place even if new ones are blocked.
Common SuiteCRM Duplicate Record Scenarios
These are ordinary CRM situations. They are not extra product features.
Two records for the same customer
A sales user creates a contact that another user already saved. Duplicate Detector can flag this at create time if the configured fields match. If both records already exist, Duplicate Cleaner can find them with your rules and merge them.
Duplicate contact information
Phone or email values often overlap. Detector can check phone-type fields and the existing Email field during create. Cleaner can use field conditions such as Equals, Contains, or Exact Match on the fields you select for existing records.
Duplicate accounts created by different users
Two people may each add the same company. A create-time check reduces new copies. Existing pairs still need a search-and-merge step.
Duplicates after importing CRM data
Imports can add records that already exist. Duplicate Detector does not undo an import. Duplicate Cleaner is the documented tool for identifying and merging those existing matches.
Frequently Asked Questions
How can I prevent duplicate records in SuiteCRM?
You can check for possible duplicates while a new record is being created. Duplicate Detector for SuiteCRM can indicate duplicate values during record creation and can be configured to show a notification or prevent the record from being saved.
How can I find duplicate records in SuiteCRM?
Duplicate Cleaner for SuiteCRM finds existing duplicate records using configurable duplicate detection rules. Administrators can set up multiple rules for core modules, custom modules, and custom fields.
Can SuiteCRM detect duplicates while creating a record?
Yes. Duplicate Detector is designed to identify a possible duplicate while a user is entering a new record, rather than waiting until after the record has already been saved.
Can I merge duplicate records in SuiteCRM?
Yes. Duplicate Cleaner provides both manual merge and automatic merge. Automatic merge uses the auto-merge settings and the primary record field you selected. Manual merge lists matching records in the Duplicates module.
What is the difference between Duplicate Detector and Duplicate Cleaner?
Duplicate Detector helps identify possible duplicates during record creation and can notify the user or prevent a duplicate from being saved where configured. Duplicate Cleaner finds duplicate records that already exist and supports manual or automatic merging, including related records.
Can duplicate management work with custom SuiteCRM fields?
Duplicate Detector works on existing or custom fields of varchar, name, and phone types, and on the existing Email field. Duplicate Cleaner supports custom fields as well as core and custom modules.
Can related records be handled when duplicates are merged?
Yes, with Duplicate Cleaner. Relationships belonging to a duplicate record can be associated with the resulting primary record, including related Calls, Meetings, Tasks, Cases, and other related records.
Conclusion
SuiteCRM duplicate management works best as a two-stage process: Prevent → Detect → Review → Merge.
Duplicate Detector is for identifying and, where configured, preventing possible duplicates during record creation. Duplicate Cleaner is for finding existing duplicates, reviewing them, and merging them manually or automatically, including related Calls, Meetings, Tasks, Cases, and other related records.
If you need SuiteCRM duplicate detection at the point a user creates a record, see Duplicate Detector for SuiteCRM. If you need SuiteCRM duplicate merging for records that are already in the CRM, see Duplicate Cleaner for SuiteCRM.