Image alt

Image alt writes SEO alt text for catalog photos. There are two paths.

Bulk image SEO (review first)

The top of the page counts product images that are missing alt text and shows the Generate credit cost (1 credit per image). Nothing is written to Shopify until you review and apply.

1. Click Generate suggestions. Invenio builds a batch of 5 suggestions at a time. Each suggestion includes alt text and a descriptive file name. This spends Generate credits.
2. Review the proposed alt and file name.
3. Apply selected writes the chosen drafts. Discard all suggestions drops them.

If more images remain, generate again. Apply is the only step that updates Shopify for this path.

Catalog images (write now)

The table lists products and collections with their current featured-image alt. Add image alt sends that photo to OpenAI vision with:

• Original title
• Product type
• Category
• Collection
• Store town

Then it writes alt text with Shopify fileUpdate (and product media update for products), reads it back, and shows Saved when the write verified. This path does not spend the Generate quota.

You can also generate alt text on a product or collection editor, or from the Add image alt button on those list pages.

If OPENAI_API_KEY is missing, Invenio writes stub alt text from the title so you can still see the flow.