Help CenterContact support
All Custos: EU Compliance articles

How do I write alt text for product images?

Updated

On this page
  1. Steps
  2. Suggestions
  3. Writing good alt text
  4. Good to know

Alt text describes an image for visitors who cannot see it: screen readers read it aloud. The Accessibility module lists your product images so you can write the missing texts, and you review every text before it is saved.

Steps

  1. Open Accessibility > Alt text.
  2. Only images without alt text is ticked, so the images that need text come first. Untick it to review every image.
  3. For each image, type the text in the field.
  4. Click Save on that image. The app writes the alt text to the product image in Shopify.

Nothing is saved until you click Save. Every saved text is listed under Changes, where you can undo it: see undo a change.

Suggestions

When suggestions are available, the page also offers them:

  • Choose a Suggestion language and click Suggest. The app asks an AI model (Anthropic’s Claude, run by StoreFleet’s support service) to describe the image and puts the text in the field. A suggestion usually takes 10 to 40 seconds. Check it against the image and edit it.
  • To fill a whole page at once, click Suggest for N empty fields. The app asks for one suggestion after the other and puts each in its field; nothing is saved yet.
  • When you add a product, the app may prepare a suggestion for its images that have no alt text. It is already in the field, marked Suggested for this new product, the next time you open Alt text. Review it and click Save; until then nothing changes in Shopify.

When suggestions are off, the page says Suggestions are off; you can still write and save text yourself.

Writing good alt text

  • Describe what matters for a shopper: the product, its colour, material or how it is used. For example “Blue ceramic mug with a wooden handle”.
  • Keep it short, at most 512 characters. Do not start with “Image of”.
  • Do not repeat the product title word for word when the image adds nothing to it.
  • The W3C’s alt decision tree helps with harder cases.

Good to know

  • Suggestions can be wrong. You are responsible for the text you save.
  • To make a suggestion, the app sends the image’s address on Shopify’s CDN and the product title to StoreFleet’s support service, which downloads the image, asks Anthropic’s Claude to describe it and deletes its copy of the image afterwards. Nothing else about your store or customers is sent.
  • In Shopify admin, Sidekick can list the products whose images have no alt text yet and link you to this page.

Built and supported by StoreFleet, Shopify app developers since 2021.