← ClaudeAtlas

shopify-alt-textlisted

Use when backfilling missing image alt text on a Shopify store: images with no alt attribute, accessibility alt text for product images, alt text for Files library images, image SEO, or a WCAG/accessibility pass that flags images missing text alternatives. Triggers: "backfill alt text", "fill in missing alt text", "images have no alt", "add alt attributes for accessibility", "image SEO sweep". One mutation, fileUpdate, covers both product media and the Files library. Not for meta titles/descriptions (use shopify-seo-metadata).
kgelster/awesome-ecom-skills · ★ 47 · Data & Documents · score 81
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