shopify-alt-text

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