Etsy Alt Text: Rules, Examples and an AI Workflow (2026)

Open almost any Etsy listing editor and look at the alt text field under each photo. In a lot of shops it's empty, or it holds the same three words copied onto every image. It's the most ignored field in the listing, mostly because nobody is sure what to put there or whether it does anything.

Etsy alt text does a few useful things. It describes your photos to shoppers who use screen readers, it fills in when an image doesn't load, and, according to Etsy, it lets search engines outside Etsy read your images. It also has firm limits, and stuffing it with keywords doesn't help.

This guide covers what Etsy actually says about alt text, a simple formula for writing it, good-versus-bad examples for eight product types, and an AI workflow that drafts alt text for every photo, shows you the cost first and saves nothing until you've reviewed it.

Etsy keeps its alt text guidance short. Here's what Etsy's Help Center article on adding a text alternative to listing images covers, paraphrased:

Etsy's Help Center guide to SEO for shop and listing pages adds the Google angle: alt text helps describe images for people with visual impairments, and accurate alt text helps Google understand what's in a photo, which may help your page appear in image-based searches. Its advice is to clearly and accurately describe what's in the photo, including details like color, texture and material.

Be precise here, because a lot of advice online isn't. Etsy's search guidance says query matching reads your title, tags, attributes, categories, description, first photo, reviews and more. Alt text isn't named in that guidance. Etsy's own alt text article frames the SEO benefit as search engines *outside* Etsy reading your images, and says the effect "might" be positive.

So treat alt text as accessibility first, Google Images second, and never as a hidden tag field. That framing also keeps you away from keyword stuffing.

None of these readers needs your shop name, your price, "free shipping" or a list of 13 tags.

Most good alt text follows the same shape. Not every piece fits every photo, but this order works for nearly everything sold on Etsy:

[What it is] + [key visual details: color, material, texture] + [scale or context] + [what this particular photo shows]

For example, a ceramic shop might write:

Speckled white stoneware mug with a glossy blue glaze ring at the base, held in one hand to show it fits a palm, photographed from the side

That's 139 characters: specific, honest and readable aloud.

Every photo in your gallery has a job, and its alt text should describe that job. Repeating the same sentence on all 20 photos tells a screen reader user nothing new.

Etsy's limit is 250 characters, but you don't need to fill it. As a working habit, aim for roughly 80–200 characters: long enough to cover color, material, scale and what the photo shows, short enough to listen to comfortably. Put the most important words first in case anything is cut off.

To check length quickly:

These examples are illustrative. They show the pattern, not real listings, so adjust every detail to match what's actually in your photo.

Writing alt text for 20 photos across 100 listings by hand is why most shops skip it. AI helps, as long as a person checks every line against the photo: vision models misjudge colors, mistake materials and guess at sizes, and wrong alt text is worse than none.

Here's the workflow with the MakeBox connector inside Claude or Codex. If you haven't connected it yet, the Etsy MCP hub explains how the connection works and links the setup guides.

Before you start:

Start with one listing, ideally a best seller with a full gallery. Ask your assistant to pull it with get_listing and show you each photo and any alt text it already has.

Use MakeBox to get listing 1234567890. List every photo in order with
its current alt text, if any. Don't change anything.

If Etsy has already added AI alt text to some images (it may do this for US sellers when none is provided), you'll want to review those lines too. They're editable, and they're no more guaranteed to be accurate than any other AI draft.

The generate_alt_text tool drafts alt text for each photo of a listing with AI. It uses your plan's allowance, so ask for the cost before it runs.

Before running anything, tell me what generate_alt_text would cost for
listing 1234567890. Then wait for my go-ahead.

Once you approve:

Run generate_alt_text for listing 1234567890. For each photo show:
photo number, draft alt text, character count. Rules: describe only
what is visible, include color, material, texture and a scale cue
where the photo shows one, no shop name, no tags, no price or
shipping, max 250 characters. Don't save anything yet.

This is the step that makes the whole thing worth doing. Open the listing photos next to the drafts and check each line:

Fix lines directly in chat:

Photo 3 is brass, not gold, and photo 5 shows the back with the
maker's stamp. Rewrite those two lines, keep the others, and show
the full final list with character counts.

When the list is right, save each line with set_photo_alt_text, which writes one photo's alt text. The assistant should show you the photo and the exact text before it writes.

Save the approved alt text to each photo of listing 1234567890 with
set_photo_alt_text, one photo at a time. Before each save, show the
photo number and the final text, and wait for my confirmation.

There's a technical detail worth understanding. Through Etsy's API, alt text can only be set when a photo is uploaded. So to update it, MakeBox detaches the photo and re-attaches it by its Etsy image ID with the new alt text. The image file itself isn't re-uploaded.

Open the listing in your Etsy listing editor afterwards. Confirm each photo shows the approved alt text and the gallery looks as expected, including photo order. A tool confirms a request succeeded; your own look is the final check.

You don't need any tool to write good alt text. Open each listing in Shop Manager, click into each photo's alt text field and write it using the formula above. If you'd like AI help without the connector, paste a photo into Claude or ChatGPT and use a prompt like this:

Write alt text for this Etsy product photo. Describe only what is
visible: what the item is, color, material, texture, and any scale
cue in the photo. Plain language, no keywords list, no shop name,
no price or shipping, under 200 characters. Then tell me anything
you're unsure about, such as the exact material or color.

The last line matters. Asking the AI to flag uncertainty gives you a short list of things to verify instead of a confident guess. For more ready-to-use prompts, see our collection of AI prompts for Etsy sellers.

If you build listings or photos in the MakeBox app rather than in chat, alt text is part of those workflows too:

One clarification: the MakeBox Etsy MCP connector in Claude or Codex doesn't generate images or video. It drafts and saves alt text for photos you already have. Image generation lives in the app.

Etsy tightened its photo rules in October 2026, and they shape how you should describe your images. The key points from Etsy's Seller Handbook update on AI use and its listing image requirements:

What this means for alt text:

For practical ways to get that unedited photo right at home, see our guide to Etsy product photos without a studio.

If you sell to shoppers in other languages too, our guide on how to translate Etsy listings with AI uses the same draft, review and approve approach.