Home / Online sellers / Write image descriptions (alt text) for your products

Write image descriptions (alt text) for your products

Who it is for
Shopify store owners whose images have no alt text.
What you give it
Your store address, or your product export file.
What you get back
Alt text written while looking at each photo, as a file you can import into Shopify.

Download free · View on GitHub

A skill you install once (works in Claude, ChatGPT and other assistants), a short guide, and a paste-in version if your plan has no skills.

Free. MIT licence: use it, change it, share it.

Before and after

PhotoBeforeAfter
Flip flop, back (a large DTC footwear brand)(empty)Back of the dusty pink women's flip flop with the brand logo embossed on the heel
Flip flop, sole (same store)(empty)Sole of the dusty pink women's flip flop, with a pattern of concentric oval grooves
Lip stain how-to (a cosmetics brand)(empty)Peel-off lip stain how-to on a model's lips: 1 line with the stain, 2 peel it off, 3 shine with gloss

We checked each "after" against the actual photo.

See it run

Animated demo of Write image descriptions (alt text) for your products on a real example: the input goes in and the finished result appears. The still shows the final result.

What it does

A free workflow that writes alt text for your Shopify product images. It looks at each photo and describes what's actually in it: the angle, the detail, the colour, the model. Then it gives you a CSV you can import into Shopify.

Give it a store URL, a product URL, or your product export CSV (Products > Export). That's all it needs.

The evidence

TESTED badge. Run on at least three real examples and scored against a written standard, with the record on file.6 real store cases, scored 9 to 10 out of 10.

Limits

  • It describes what it can see and what your product data says. It won't invent materials or features.
  • Importing alt text by CSV re-imports your images. Test on one product first. For products with variant images (the photo changes per colour), paste the alt text by hand. The workflow lists those products for you.

Questions

Refunds and contact

If it does not do the job, ask and we refund you within 30 days. Reply to your receipt, or use the contact page.

Contact page

Which assistants does it work with?

Works in ChatGPT, Claude, Gemini and most other AI assistants: paste in the text, or load the files if your assistant supports them. Setup steps are under For technical users. We run our release tests on Claude. Use your assistant's strongest model: in our tests, a small, fast model added facts that were not in the source data. The helper scripts need Python 3 (standard library only). Reading a live store needs web access; otherwise attach your product export CSV.

For technical users

Using it with an AI assistant

  1. Unzip the free download. It holds the free skill folders, including shopify-alt-text-writer, ready-made zips for claude.ai in a claude-ai folder, and a README. Or copy the folder from GitHub.
  2. Put the shopify-alt-text-writer folder where your assistant looks for skills. The generic path is .agents/skills/ (or npx skills add from a folder). Tool-specific paths:
    • Claude Code: ~/.claude/skills/ (or .claude/skills/ inside one project)
    • OpenAI Codex, Gemini CLI, Cursor and others: .agents/skills/ or the skills folder their docs name
    • claude.ai: Customize, Skills, then the plus button, Create skill, Upload a skill, and upload the zip from the claude-ai folder without unzipping it (code execution must be on in Settings, Capabilities)
    • ChatGPT or any chatbot: open the skill's prompt.md, paste it into the chat, then paste your own text or link
    • Steps for each tool, with links to its official docs: how to install skills
  3. Ask for the job in plain words. The skill loads by itself.
Copy the text for ChatGPT or any chatbot

Jobs that go with this