shopify-admin-customer-merge

You can merge duplicate customers by running this Skill with a winner customer ID and a loser ID. It uses Shopify's native customerMerge mutation to consolidate identities, tags, and notes while preserving data integrity.

If the native customerMerge mutation fails, the Skill falls back to customerUpdate to union tags and notes onto the winner record and annotates the loser customer profile for manual follow-up.

Yes, merging customer records requires authenticated Shopify Admin API access with read_customers and write_customers scopes to execute the deduplication operations successfully.

Yes, you can preview a Shopify customer merge by enabling the dry_run option. This suppresses actual mutations and generates a step-by-step operation summary and completion report showing the planned path and outcomes.

Yes, the Shopify customer merge process supports async merge jobs and emits structured outcome reporting. It provides a completion report detailing the path used and the final results of the deduplication workflow.

The best way to consolidate Shopify customer tags and notes during deduplication is to use automated customerMerge or customerUpdate fallback methods, which union metadata fields onto the winner record while preventing data loss.