Shopify Admin Variant Option Normalizer

Detects inconsistent variant option naming (Sm vs Small vs S) and bulk-corrects to a standard set.

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-variant-option-normalizer
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/merchandising/shopify-admin-variant-option-normalizer ~/.claude/skills/shopify-admin-variant-option-normalizer

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
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

> ⚠️ `productVariantsBulkUpdate` modifies variant option values. Option value changes affect how the variant appears to customers in the storefront and may break existing cart links or saved wishlists. Run with `dry_run: true` to review all affected variants before committing.

## Workflow Steps

1. **OPERATION:** `products` — query
Read the full skill on GitHub

Details

Skill name
shopify-admin-variant-option-normalizer
Path
skills/merchandising/shopify-admin-variant-option-normalizer/SKILL.md
License
MIT
Repo updated
26 October 2026

FAQ

What does the Shopify Admin Variant Option Normalizer skill do?

Detects inconsistent variant option naming (Sm vs Small vs S) and bulk-corrects to a standard set.

How do I install the Shopify Admin Variant Option Normalizer 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 Variant Option Normalizer 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.