Why Shopify Won't Merge Some Customers: Every Merge Blocker Explained

When Shopify can't merge two customers, it's because one of the profiles holds data Shopify refuses to combine, or because something else is already happening to it. Shopify's help documentation lists nine blocking conditions (subscriptions, B2B links, saved cards, store credit, Multipass, deleted or redacted profiles, and merges or data requests in progress) plus two size limits on tags and notes. Some of these you can clear in a few minutes. Others are permanent, and the right move is to stop trying and link the profiles another way.

This guide lists every blocker, shows how to tell which one you've hit, and sorts them into the ones you can fix and the ones you can't.

Why can't Shopify merge these customers?

Shopify refuses a merge if either profile meets any condition below. It only takes one profile in the pair to block the whole merge. The conditions come from Shopify's help page on merging customer profiles, and the third column is how Shopify's API names each one in a merge preview.

One more blocker shows up only in the API. Shopify's CustomerMergeErrorCode enum includes CUSTOMER_HAS_GIFT_CARDS, described as "The customer cannot be merged because it has associated gift cards," and the error field list includes GIFT_CARDS. The help page, confusingly, lists gift cards among the data that gets merged. In practice, expect some profiles with gift cards to be refused.

How do you tell which blocker you hit?

Open both profiles and look for the blocker, because the admin doesn't always say. Shopify's help page lists the conditions but doesn't document the error messages, and merchants on the Shopify Community have reported a bare "Customers can't be merged. Customer merge failed." with no reason given.

A quick visual check of each profile catches most cases:

1. Subscriptions. Look for a subscription or payment methods section on the profile, or ask whether a subscription app ever billed this customer. Past subscriptions count.
2. Store credit. Check the profile for a store credit balance.
3. Saved card. Check the Payment methods section for a stored card.
4. Company. Check whether the profile shows a company or B2B orders.
5. Erasure. Look for an Erasure request submitted section.
6. Tags and notes. Count tags on both profiles and estimate the note lengths together.

Developers get a precise answer. Shopify's customerMergePreview query, which needs the read_customer_merge access scope, returns customerMergeErrors (each with the error fields from the table above) and blockingFields (the tag and note values that would break the limits), without merging anything. The customerMerge mutation itself runs as an asynchronous job, and the resulting merge request can end with a status of FAILED, so a script should always preview first and check the final status after.

Which merge blockers can you fix?

About half of them. Temporary blockers clear on their own or with a small edit. Permanent ones are tied to history Shopify keeps on purpose, and no amount of editing removes them.

About saved cards. In the admin, Shopify's help documentation describes Replace card and Send link to update card for a saved card, not removal. Shopify's API has a customerPaymentMethodRevoke mutation that revokes a vaulted payment method, but it fails if the method backs an active subscription contract, and Shopify doesn't document whether a revoked card still counts as a merge blocker. Treat it as an experiment on one pair, not a fix for a whole list.

About erasure requests. Shopify's customer data request documentation says you have 10 days to cancel an erasure request, using Cancel request in the Erasure request submitted section of the profile. Only cancel one that was submitted by mistake. If the customer asked to be erased, honor it and leave the profile alone.

How to fix the tag and note limits

Trim before you merge, and do the arithmetic first, because the limits apply to the combined totals. These are the most common blockers in stores that tag heavily through apps or automation, and they're entirely in your hands.

Here's a worked example. Profile A has 180 tags and Profile B has 95. That's 275 combined, 25 over the limit. Many of those tags will be duplicates or app leftovers (old campaign tags, import batch tags, "abandoned-cart-2024"), so removing 25 obsolete tags from either profile is usually easy. Shopify's help page doesn't say whether a tag that appears on both profiles counts once or twice, so aim for a simple sum of 250 or under to be safe.

Notes work the same way. A 3,200-character note plus a 2,100-character note is 5,300, which is over 5,000 including spaces. Copy the older note into a document or a timeline comment, cut it down to the essentials, and retry.

The trap is merging three or more profiles into one. Shopify's native merge combines two at a time, so the totals grow with each round. If a customer has four profiles, check the tag and note totals across all four before you start, not just for the first pair, or the last merge fails after the first two succeeded. For the step-by-step merge itself, see how to merge duplicate customers in Shopify.

Why is the Merge customer option missing?

If you can't find the option at all, it's usually a permission. Shopify's API lists MERGE_CUSTOMERS ("The staff member can merge customers") as its own staff permission, separate from viewing, creating and editing, and deleting customers. A staff member who can edit customers may still be unable to merge them.

Check these in order:

1. You're looking in the right place: Customers > [customer] > More actions > Merge customer, or select customers in the list and choose Merge customers from the menu next to Edit customers.
2. In the mobile app, the action is called Merge entries.
3. Ask the store owner to check your role's customer permissions for merge access.

What should you do with customers you can't merge?

Keep both profiles and make them point at each other. Deleting one to "clean up" loses that profile's order history, and the order can't be moved to the other profile, because Shopify keeps orders permanently attached to the profile that placed them.

A simple routine for permanently blocked pairs:

• Add a note on each profile naming the other one, for example "Same person as jane.doe@example.com (subscription history, can't merge)."
• Add a shared tag such as merge-blocked to both, so you can filter them and so nobody tries again next quarter.
• Pick the active profile with the customer. Tell them which email to use for sign-in and checkout so new orders land in one place.
• Don't swap emails between the profiles. Shopify treats each email and phone as unique, so you can't give the second profile the first one's address, and changing an email never merges profiles.
• Log it. Keep a short list of blocked pairs and the reason, especially before a migration or a reporting project.

Remember that reports will count these as two customers. If you track repeat purchase rate closely, the blocked pairs are a known, small source of error. Before you get here, it's worth confirming the pair really is one person; how to find duplicate customers in Shopify covers how to rank matches by confidence, and merging customer accounts in Shopify explains what changes for the pairs that do merge.

How Twinfold helps

Twinfold is a Shopify app by NewClick (independent, not made by Shopify) that finds duplicate customers and merges them in bulk through Shopify's own customer merge, so every blocker in this guide still applies. What changes is that you see the reason instead of a generic failure.

Every merge is previewed with Shopify first. When Shopify refuses a group, Twinfold shows the reason (for example a B2B company contact, saved payment methods, gift cards, store credit, subscription history, Multipass sign-in, a pending customer data request, a merge already in progress, a deleted or redacted profile, combined notes over 5,000 characters, or combined tags over 250) and leaves those profiles unchanged. After a run you get a result per group, and Merge history with Download CSV gives you the log for your blocked-pairs list. Scanning is free on every plan, so you can see how many of your duplicates are blocked before you merge anything.

Most merge failures aren't bugs. They're Shopify protecting a subscription, a balance or a business relationship. Fix the tags and notes, wait out the temporary ones, and document the rest.