How to Add Alt Text on Etsy (Guideline, Steps & Examples)
Limits verified: 2026-10-30
Key Takeaways — Etsy alt text
Etsy alt text is a written description of a listing photo for buyers using screen readers. It explains the photo rather than repeating your listing title.
Etsy Help: listing image alternatives recommends up to 250 characters. Shopify allows 512; Handykit targets 80–125 for a shorter first draft.
Open a listing, choose a photo, and fill its Alt text section. Etsy’s documented Shop Manager bulk-edit fields do not include photos or alt text. Work through the photos individually.
Draft Etsy alt text with the free Handykit Alt Text Generator — no signup. Upload one PNG, JPG, WebP, or GIF up to 10MB, review the 80–125 character draft, and copy it into your image’s alt text field.
How to add Etsy alt text on desktop
- In Etsy.com, open Shop Manager, then Listings.
- Choose the listing and the photo you want to describe.
- Enter the description in Alt text.
- Choose Apply and review the saved description.
Etsy Help: listing image alternatives describes this feature for shops whose default language is English. Describe the specific photo: the front view, a texture detail, and a scale comparison convey different information.
How to add it in the Etsy Seller app
- Open Listings and select a listing.
- In the Listing tab, tap the pencil in Photo and video.
- Choose the Alt text icon and select an image.
- Write the description and choose Save.
Etsy's 250-character guideline and a useful shorter target
Etsy Help recommends up to 250 characters to describe the item and relevant visual details. You do not need to use every character. A sentence in Handykit’s 80–125 range often covers an object, its appearance, and the setting. Keep long customization instructions in the listing description.
For handmade items, describe observable features such as a scalloped rim or an embroidered leaf. Confirm material and dimensions from your product information; do not let an AI draft invent them. If scale matters, describe the visible comparison object without guessing an exact measurement.
Automatic descriptions and bulk editing
Etsy says it might add alt text to US sellers’ listing images when they lack it, and that sellers can edit those descriptions. Existing seller-written alt text is not replaced by that process. Review a generated description for details that matter to your buyer.
Etsy Help: bulk editing lists the fields supported by its bulk editor; photos and alt text are absent. Do not treat the bulk title or description editor as a photo-alt editor. Handykit supplies one image draft at a time and does not modify your Etsy listings.
Etsy listing photo examples
Illustrative examples follow; use them only when their details match your actual image. Counts include spaces and punctuation.
- Ceramics:
Speckled cream bowl with an uneven blue rim, photographed beside a wooden serving spoon.
(88 characters) - Embroidery:
Close-up of green fern embroidery stitched across the pocket of a cream apron.
(78 characters) - Scale:
Small amber glass vase beside a paperback book on a narrow wooden shelf.
(72 characters) - Jewelry:
Pair of silver crescent earrings with hammered surfaces, resting on dark linen.
(79 characters)
These sample descriptions distinguish the image’s subject from the background and include useful visual differences. Replace any material claim with a verified description of your own item. A beautiful photo still needs text that explains what a buyer would miss without seeing it.
Alt text limits compared
Field capacity and writing advice answer different questions. API limits apply to API fields; they do not establish an undocumented in-app maximum.
| Platform | Documented maximum | Writing guidance and source |
|---|---|---|
| 4,086 characters (API) | Under 120 recommended; LinkedIn Images API | |
| Shopify | 512 characters | 125 or fewer recommended; Shopify Help: adding alt text |
| Etsy | 250 (Etsy Help guidance; no published hard max) | Keep it concise; Etsy Help: listing image alternatives |
| 500 characters | Describe what is visible; Pinterest Help: alternative text | |
| 1,000 characters (API) | No in-app cap confirmed; Instagram Graph API: media |
See the full alt text character-limit guide. Handykit’s 80–125 character target is a drafting preference, not an accessibility standard.
Review the draft in context
Alt text conveys the information an image adds to the surrounding page. The W3C WAI Images Tutorial distinguishes informative, decorative, and complex images: a product photo needs a useful description, while a chart may also need a fuller explanation nearby.
Describe visible details in ordinary language. Google Search Central image guidance advises useful, contextual descriptions instead of keyword stuffing. That guidance concerns Google image search; it does not promise better reach inside a social platform.
Draft Etsy alt text free
Draft Etsy alt text with the free Handykit Alt Text Generator — no signup. Upload one PNG, JPG, WebP, or GIF up to 10MB, review the 80–125 character draft, and copy it into your image’s alt text field. Free daily use: 5 generations per person and 20 per IP. Handykit handles one image at a time.
FAQ
What is Etsy’s alt text guideline?
Etsy Help recommends up to 250 characters for concise listing photo descriptions.
Can I add alt text in the Seller app?
Yes. Open the listing’s Photo and video editor, select the Alt text icon, choose an image, and save its description.
Does Etsy bulk editing include alt text?
Etsy’s published Shop Manager bulk-edit field list does not include photos or alt text. Edit photo descriptions individually.
Does Etsy add automatic alt text?
Etsy may add alt text to US sellers’ images that lack it. You can edit it; Etsy says existing seller-written alt text is not altered.
Should I repeat my title in every photo?
Describe the view or detail each photo adds. Repeating one title misses differences between gallery images.
Can Handykit update my listing directly?
No. Handykit creates a single-image draft for you to review and paste into Etsy. It is free and requires no signup.
Sources
Official pages fetched October 30, 2026. Limits refer to the documented field or API scope described above.