shopify-alt-textlisted
Install: claude install-skill kgelster/awesome-ecom-skills
# Shopify Alt Text
Backfill missing image alt text across a Shopify store. Alt text is an
accessibility requirement first (screen readers announce it) and an image-SEO
signal second. This skill fills the gap for images that have none; it does not
rewrite alt text that already exists.
The sister backfill for SEO titles and descriptions is **shopify-seo-metadata**:
same safe-mode doctrine, different fields. The FIND stage (measuring how many
images lack alt across the catalog before you commit to a sweep) belongs to
**shopify-catalog-audit**.
## One mutation, two find paths
Images live in two places on a Shopify store, but both write through the **same
mutation**. A product image and a Files-library image are both `MediaImage`
nodes, which are `File` subtypes, so a single `fileUpdate` sets `alt` on either.
There is no separate product-media alt mutation to learn.
- **`fileUpdate` is the one write.** It takes the image's `MediaImage` GID and
the new `alt`. This is the write path both source tools converge on. (Shopify's
old `productUpdateMedia` is **deprecated on shopify.dev; do not use it** for
alt text.)
- **Two ways to FIND the images, one way to fix them:**
- *Product media:* page products, read each `MediaImage` under `product.media`.
Needs `read_products`.
- *Files library:* page the `files` connection (Content → Files: theme
sections, metaobjects, rich-text, collection banners). Needs `read_files`.
- Both hand you `MediaImage` GIDs; feed those str