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.

204 stars 23 forksMarketing, Sales & Business Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add 40RTY-ai/shopify-admin-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-customer-merge
Manual install
git 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-merge

Personal 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` |
Read the full skill on GitHub

Details

Skill name
shopify-admin-customer-merge
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

Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.