Shopify Admin Customer Merge
Merges duplicate customer records: invokes Shopify's native customer merge API where supported, otherwise consolidates the loser record's tags and notes into the winner via customerUpdate.
Install
/plugin marketplace add 40RTY-ai/shopify-admin-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-customer-mergegit clone --depth 1 https://github.com/40RTY-ai/shopify-admin-skills.git /tmp/shopify-admin-skills
mkdir -p ~/.claude/skills
cp -r /tmp/shopify-admin-skills/skills/customer-support/shopify-admin-customer-merge ~/.claude/skills/shopify-admin-customer-mergePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
## Purpose Resolves duplicate customer records identified by `duplicate-customer-finder`. Where the Shopify Admin API exposes `customerMerge` (a native merge that moves orders, addresses, subscriptions, and metafields onto a winner record), this skill calls it directly. When `customerMerge` is unavailable or fails for the given account pair, the skill falls back to consolidating searchable metadata — tags, notes, marketing consent — onto the winner via `customerUpdate`, then writes a clear annotation to the loser record so staff can complete the merge manually in Shopify Admin. ## Prerequisites - Authenticated Shopify CLI session: `shopify store auth --store <domain> --scopes read_customers,write_customers` - API scopes: `read_customers`, `write_customers` ## Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | store | string | yes | — | Store domain (e.g., mystore.myshopify.com) | | format | string | no | human | Output format: `human` or `json` | | dry_run | bool | no | true | Preview merge plan without executing mutations | | customer_winner_id | string | yes | — | GID of the customer record to keep (e.g., `gid://shopify/Customer/12345`) | | customer_loser_id | string | yes | — | GID of the customer record to merge into the winner | | use_native_merge | bool | no | true | Try `customerMerge` first; if it fails or is unavailable, fall back to consolidation via `customerUpdate` |
Details
- Skill name
shopify-admin-customer-merge- Repository
- 40RTY-ai/shopify-admin-skills
- Path
skills/customer-support/shopify-admin-customer-merge/SKILL.md- License
- MIT
- Repo updated
- 26 October 2026
FAQ
What does the Shopify Admin Customer Merge skill do?
Merges duplicate customer records: invokes Shopify's native customer merge API where supported, otherwise consolidates the loser record's tags and notes into the winner via customerUpdate.
How do I install the Shopify Admin Customer Merge skill?
Claude Code plugin: /plugin marketplace add 40RTY-ai/shopify-admin-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Shopify Admin Customer Merge popular?
It lives in 40RTY-ai/shopify-admin-skills, which has 204 GitHub stars and 23 forks.
Related skills
Shopify Admin Abandoned Cart Recovery
20440RTY-ai/shopify-admin-skills
Query checkouts abandoned in the last N days, generate unique discount codes per customer, and tag them for re-engagement.
Shopify Admin Address Correction
20440RTY-ai/shopify-admin-skills
Update the shipping address on an unfulfilled order before it ships.
Shopify Admin Agentic Crawler Access
20440RTY-ai/shopify-admin-skills
Edit the theme's robots.txt.liquid to explicitly allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, Amazonbot) so AI assistants are permitted to read the catalog.
Shopify Admin Customer Note Bulk Annotator
20440RTY-ai/shopify-admin-skills
Adds internal notes to customer records in bulk — useful for post-campaign flags, import annotations, or support context.
Shopify Admin Customer Cohort Analysis
20440RTY-ai/shopify-admin-skills
Read-only: groups customers by first-purchase month and tracks repeat purchase rate and revenue per cohort.
Shopify Admin Customer Spend Tier Tagger
20440RTY-ai/shopify-admin-skills
Calculates lifetime spend per customer and applies tier tags (Bronze/Silver/Gold/Platinum) based on configurable thresholds.
Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.