shopify-admin-duplicate-customer-finder

Detect duplicate Shopify customer records via read-only GraphQL queries.

174|18|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-duplicate-customer-finder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-admin-duplicate-customer-finder
Source: https://github.com/40RTY-ai/shopify-admin-skills/tree/main/skills/customer-ops/shopify-admin-duplicate-customer-finder
Command: npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-duplicate-customer-finder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Duplicate customer records fragment order history, distort LTV and marketing segmentation, and create confusion when support teams look up customers.

Core Features & Use Cases

  • Read-only duplicate detection: Identifies likely duplicates by matching on email, phone, and/or name combinations without performing any mutations.
  • Order- and spend-aware grouping: Flags duplicate groups and surfaces customers with order count and total spent to prioritize the most impactful merges.
  • Actionable reporting output: Produces a CSV report of duplicate groups so you can merge them manually in Shopify Admin.

Quick Start

Run shopify-admin-duplicate-customer-finder for your store domain and use match_on=email to generate a duplicate_customer report you can review and merge in Shopify Admin.

Frequently Asked Questions about shopify-admin-duplicate-customer-finder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find duplicate customer records in Shopify?

You can find duplicate customer records in Shopify by executing a read-only GraphQL query that matches email, phone, and name combinations, generating a structured CSV report of grouped duplicates for manual review.

Why do I have fragmented order history and incorrect customer LTV in Shopify?

Fragmented order history and incorrect customer LTV in Shopify happen when duplicate customer records are created via data imports or guest-to-account transitions, splitting a single buyer's purchases across multiple profiles and distorting analytics.

Can I automatically merge duplicate Shopify customers using a script?

You cannot automatically merge duplicate Shopify customers using this tool, as it enforces read-only safety guarantees by only querying data and outputting CSV reports for you to merge manually in Shopify Admin.

How do I prioritize which duplicate Shopify customers to merge first?

To prioritize which duplicate Shopify customers to merge first, review the generated report which flags duplicate groups alongside their order count and total spent, allowing you to target the most impactful profiles for LTV correction.

Does this duplicate customer finder work for large Shopify stores with paginated results?

Yes, this duplicate customer finder works for large Shopify stores by executing GraphQL queries across paginated results, safely processing extensive customer lists to identify duplicates without hitting standard page size limits.