shopify-admin-variant-option-normalizer

Installation
SKILL.md

Purpose

Scans product variants for inconsistent option values (e.g., "Sm", "Small", "small", "S" all meaning the same size) and bulk-updates them to a canonical set you define. Inconsistent option naming breaks size filters, causes customer confusion, and prevents search apps from grouping variants correctly.

Prerequisites

  • Authenticated Shopify CLI session: shopify store auth --store <domain> --scopes read_products,write_products
  • API scopes: read_products, write_products

Parameters

Parameter Type Required Default Description
store string yes Store domain (e.g., mystore.myshopify.com)
option_name string yes Option to normalize (e.g., Size, Color)
mapping object yes Map of non-standard → canonical values (e.g., {"Sm": "S", "small": "S", "Sml": "S"})
filter string no Optional product filter (e.g., tag:apparel)
dry_run bool no true Preview changes without executing mutations
format string no human Output format: human or json

Safety

Related skills
Installs
5
GitHub Stars
139
First Seen
Apr 12, 2026