shopify-admin-variant-option-normalizer

What problem does it solve?

This Skill solves the problem of inconsistent Shopify variant option naming that breaks size/color filters, causes customer confusion, and prevents storefront grouping and search apps from matching variants reliably.

Core Features & Use Cases

• Detects inconsistent option values: Scans product variants for non-canonical option values such as Small vs S vs small for a given option name.
• Bulk-corrects to a canonical mapping: Updates affected variants using a bulk mutation so normalized values become consistent across your catalog.
• Preview-first safety: Supports dry-run behavior (with dry_run defaulting to true) so you can review changes before applying mutations.

Use case example: Normalize all “Size” values where you currently have “Sm”, “small”, and “Sml” so every variant uses a single canonical value like “S” across the entire catalog (optionally limited by a filter such as tag).

Quick Start

Run the Skill with your store domain, set option_name to the option you want to normalize (for example, Size), and provide a mapping from each non-standard value to the canonical value you want to keep.