Use this article to understand how Insycle's Merge Duplicates module consolidates duplicate contacts, companies, accounts, deals, and other object types, including how field values, associated items, activities, and attachments are retained during a merge. It also walks through the four-step merge process (Find Duplicates, Review Duplicates, Merge Logic, Review) and points to troubleshooting resources for common merge issues.
How to Merge Duplicate Contacts, Companies, and Other Object Types
The Merge Duplicates module identifies and combines redundant contacts, companies, deals, custom objects, and other object types. This article explains Insycle's merge logic and provides an overview of the four-step merge process. For a complete configuration reference, see the Detailed How-To articles. For guidance on managing different scenarios, refer to the Common Scenarios.
Understanding Insycle's Merge Logic
Data Merge Behavior
When records are merged using Insycle, the properties are consolidated and follow similar logic across all record types on all CRMs:
-
Fields/Property values:
- By default, the value is retained from the master. When a value is empty in the master, it picks a non-empty value from the most recently updated duplicate. All other values are available in the history.
- Multi-select picklist fields: All selected values from duplicate records and the master are automatically consolidated into the master record. For example, if the master record has the value "Newsletter" and a duplicate has the value "Product Updates," the merged record will contain both "Newsletter" and "Product Updates."
- To customize how field data is retained in the master record on a field-by-field basis, use the Field tab under Step 3.
- Associated items: Reassigned from the duplicates to the master.
- Activities (notes, emails, tasks, etc.): Reassigned from the duplicates to the master.
- Attachments: Reassigned from the duplicates to the master. (Note that there may be a short delay before the attachment appears in the merged record.)
See the CRM-specific articles for any further details:
Insycle Merge Process
When merging duplicates, Insycle goes through the following steps for all record types and database types:
- Select the master record according to the rules set in Step 3 on the Master tab.
- Determine field values to retain in the master record based on rules configured in Step 3: Merge Logic, Fields tab.
- For fields without specific rules, identify non-empty values using a "fill in the blanks" method:
- Check whether the master record has any empty fields.
- If empty, copy values from the most recently updated record in the duplicate group.
- Update the master record by:
- Applying the field values chosen in #2 (from Field rules).
- Adding the non-empty values identified in #3 (using "fill in the blanks").
- Preserving all other existing values in the master record.
- Merge the duplicate records and reassign all related objects to the master record.
- Store an audit trail report accessible from the Activity Tracker and send an email notification to the designated recipients.
Fill-in-the-Blanks Data Retention
Though you can create custom data retention rules for any record fields using the Fields tab under Step 3, it is not required. There is no need to create rules for every field in your CRM - Insycle automatically handles fields without specific rules with a "fill in the blanks" approach.
When the master record has empty fields, Insycle copies values from the most recently updated record in the duplicate group where that data exists. For example, if the master record's Industry field is empty but another record in the duplicate group has an Industry value, that value will automatically be copied to the master record.
This means you only need to create custom retention rules for the fields that require special handling, rather than setting up rules for all your fields.
Step-by-Step Process Overview
The Merge Duplicates module follows a four-step process:
Step 1: Find Duplicates
Step 1 is where you define which fields Insycle should examine to find duplicate records, and set the rules for how those fields are compared. Each field you add is cumulative — records must match all of the criteria you specify to be flagged as potential duplicates. For example, matching on First Name AND Last Name AND Phone Number returns only results where all three values are the same.
Step 1 operates through three tabs:
- The Simple tab is where you add matching fields and configure comparison rules, ignored elements, match parts, and conditions.
- The Advanced tab is where you configure Related Fields for any field already added on the Simple tab.
- The Conditions tab is where you set conditions for any field already added on the Simple tab.
A field must be added on the Simple tab before it can be configured on the Advanced or Conditions tabs.
See Setting the Criteria for Finding Duplicate Matches for a complete breakdown of all options.
Additionally, Step 1 includes a CSV tab that lets you upload a file of known duplicate record ID pairs directly — bypassing field-based matching entirely. See Merging Duplicates from a List You Already Have for details.
Step 2: Review Duplicates
Step 2 displays all duplicate groups identified in Step 1, allowing you to review and verify the matches before proceeding. Records that match your Step 1 criteria are automatically clustered into duplicate groups — each group represents a single entity and shows how many duplicate records it contains. For example, four records for the same person would appear as a single duplicate group containing four records.
Click the chevron at the right end of a duplicate group row to expand it and examine the individual records within that group. You can also add more fields as columns to give yourself further context when evaluating the matches.
To exclude a duplicate group from all future deduplication analysis, click the X on the group row. Excluded groups will not appear as duplicates or be included in merges, even when using different duplicate detection templates. To review and manage excluded groups, click the Exclusions button in the Step 2 header.
Step 3: Merge Logic
Step 3 is where you configure how duplicate groups are consolidated—from choosing your operation mode to defining master selection rules and field retention logic. This step combines operation selection with the merge logic configuration through multiple tabs.
Bulk or Manual Mode
At the top of Step 3, choose between Bulk and Manual modes in the header:
- Bulk mode (recommended) automatically merges all duplicate groups according to the master record selection rules you define in the Master tab. This is the right choice for most deduplication processes, and the only mode that supports templates, Recipes, and automation.
- Manual mode lets you review and select specific records to merge individually from the Record Viewer. Reserve this for high-value records or complex scenarios where you want hands-on control over each merge. Learn more about merging using Manual mode.
Most users should select Bulk mode and proceed.
Step 3 operates through three tabs that work together:
1) Master tab
On the Master tab, you set the rules that determine which record in each duplicate group becomes the master. Insycle evaluates your rules in order from top to bottom, and the first record that uniquely matches a rule becomes the master. If no record matches any rule, master selection fails for that group. See Choosing Which Record Remains After a Merge for a full breakdown of all rules and options.
At the bottom of the Master tab, you'll also configure:
- Processing method — Choose between By Priority (evaluates rules in sequence, stops at first unique match) or Absolute (master must match all rules). Most operations should use By Priority.
- Exclusions — By default, Insycle skips any duplicate group containing more than 5 records—this prevents overly broad matching criteria from accidentally merging unrelated records. You can adjust this threshold up to 100 records per group.
2) Fields tab
The Fields tab lets you control which field values end up in the master record after the merge. By default, Insycle keeps the master record's values and fills any empty fields with the most recently updated duplicate's values. You can override this on a field-by-field basis for any fields that need special handling. See Keeping the Right Data When Records Merge for all available criteria and conditions.
3) Method tab (HubSpot & Salesforce only)
The Method tab lets you choose between Native and Synthetic merge logic, and control whether empty master fields are automatically filled. See Native vs. Custom Merge: Two Ways to Combine Records in HubSpot and Salesforce for details.
Step 4: Review
Step 4 is where you preview and apply your merge changes. It operates in two modes.
Preview Mode generates a CSV report that shows exactly how your records would be merged based on your current configuration — which records become masters, which field values end up where, and whether any errors occur. No changes are made to your CRM. Always run Preview Mode before Update Mode to verify everything is working as expected.
Update Mode applies the merge to your live CRM. Once you've confirmed your Preview results look correct, Update Mode executes the actual merge operations.
When the Merge API is set to Synthetic on the Module tab in Step 3, running in Update Mode displays a Please confirm dialog before the operation begins. This dialog shows an estimated time for the merge based on the number of associations and engagements that need to be reassigned.
Click Yes to proceed.
Processing time for Synthetic merges depends on the volume of associated records and will be longer than Native merges — avoid running multiple operations in parallel on the same database. You can monitor progress in the Activity Tracker.
Advanced Techniques
Select the master record based on email
In HubSpot, the master record always determines which primary email is kept after a merge. If you want to control which primary email address is kept, set up a rule to select the appropriate master record.
Review the email values in Step 2 to identify the criteria, then set up a Master rule in Step 3 to choose the record for each duplicate group based on that criteria.
For example, to select the master based on corporate email addresses over personal ones (like choose the record with john.smith@acmecorp.com over john.smith@gmail.com), configure a master rule:
- Field Name: Email
- Condition: Work domain (non-Gmail, etc.)
Other Example Master Rule Configurations:
- Field Name: Email
-
Condition: Select from the following options based on your business rules:
- Personal domain (Gmail, etc.) — Prioritize personal email addresses; useful when merging consumer contacts or individual leads.
- Not role-based (info@, etc.) — Exclude generic email addresses like info@company.com or sales@company.com to keep only personal contact emails.
- Is / Is not — Match or exclude an exact value. For example, use "Is not" with "noreply@company.com" to avoid selecting automated email addresses as master records.
- Contains / Does not contain — Match or exclude based on partial text. For example, use "Contains" with "@acmecorp.com" to prioritize all company domain emails, or "Does not contain" with "+test" to exclude test email addresses.
- Regex — Use a regular expression pattern for complex matching. For example, use a regular expression (regex) pattern to match emails from multiple specific domains or to identify specific naming patterns.
- Exists / Doesn't exist — Filter based on whether the field has any value. For example, use "Exists" to prioritize records with an email address over those without one.
Retaining Other Email Data
Though you cannot use the Fields rules to control what HubSpot primary email field data is retained, you can set retention rules to copy non-master email values to a different field, such as Additional Email or a custom field.
For example, to preserve non-master email values as backup contact information, configure a field rule:
- Field Name: Additional email addresses
- Criteria: Collect non-master values from
- Other Field: Email
Understanding how master selection works
Insycle evaluates your Master tab rules from Step 3 in order, eliminating records that don't match each rule until only one remains. If multiple records still match after all rules are evaluated, no master can be determined, and the group will show an error in the CSV.
For example, imagine having four duplicate records for the same contact. (In this image, we are examining the records in the Grid Edit module.)
In the Merge Duplicates module, you have configured the first three Master rules based on email engagement metrics, but all four records have identical values of zero, so no records are eliminated. Your fourth rule checks for an active Contact Owner — three records have no owner, so they're eliminated. The one remaining record becomes the master.
This is why rule order matters. Place your most reliably differentiating rules — like record owner, lifecycle stage, or engagement activity — where they're most likely to yield a clear winner. If you're frequently seeing errors in your CSV, revisit your rule order and consider adding a tiebreaker rule, such as earliest Create Date or latest Last Modified Date, as a final fallback.
In this CSV report example, you can see that the one record with an active owner was chosen as the master.
Even though this was the fifth rule, it is the first one that matched only one record:
When Insycle processed the first three rules—Marketing emails clicked, emails bounced, and emails opened—Insycle couldn't eliminate any records because they all had a value of 0.
None of the record email addresses are "role-based," so there isn't a single choice for the master using the Email rule either.
In the next rule about contact owner, there is one record with an active contact owner; therefore, that is the master record.
Additional Resources
Troubleshooting
Review the Merge Duplicates Troubleshooting article if you're not seeing the results you expect when merging duplicates.
Frequently Asked Questions
Check out the Merging Duplicates FAQ for a complete list of questions about merging duplicates.
Related Help Articles
- Bulk Merge Duplicate People, Companies
- Common Merging Scenarios
- Detailed Instructions for Configuring Each Part of the Merge Module
- Deduplication Best Practices
Related Blog Posts
- HubSpot Deduplication: Merging HubSpot Records
- Salesforce Lead-Contact Cross-Object Deduplication with Insycle
- 9 Ways Duplicate Customer Data Is Impacting Your Bottom Line
- Taming the Two-Way Sync: Preventing Duplicates in HubSpot Before They Sync Into Salesforce
- How to Merge Duplicates in HubSpot and Salesforce and Keep Them Syncing