How to Add Alt Text on Shopify (512 Limit, Steps & Examples)
Limits verified: 2026-10-30
Key Takeaways — Shopify alt text in one screen
Shopify alt text describes product media for assistive technology and can appear when an image fails to load. It is separate from your product title and description.
Shopify allows 512 characters and recommends 125 or fewer, according to Shopify Help: adding alt text. Etsy Help recommends up to 250 characters; neither figure is a writing target.
In admin, open a product, select its media, choose Add alt text, and Save alt text. Handykit drafts one image at a time, targeting 80–125 characters. For catalog-wide changes, use Shopify’s CSV workflow.
Draft Shopify 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.
What Shopify product alt text is (and who uses it)
Product alt text describes the particular photo a customer encounters in a gallery. A product title names the item; the image description explains this view of it. A front view, stitching detail, and in-use photograph need different descriptions even when they belong to the same listing.
Start with the product type and add one or two visible attributes. A customer listening to a detail photo may need to know that the clasp is open or that the fabric has a ribbed texture. Avoid copying the entire product description into every image field. Keep dimensions, care instructions, and other long specifications in accessible product text.
Shopify alt text character limit: 512 max, 125 or fewer recommended
Hard max vs recommended length
The maximum is the amount the field accepts; the recommendation is a useful length for most descriptions. Shopify’s documented 512-character capacity is not a reason to fill the space. A clear sentence can identify the item and the feature shown without repeating everything on the page.
Why Handykit targets 80–125 characters
Handykit’s target fits Shopify’s recommendation. Review the result rather than padding a shorter accurate sentence to reach 80 characters. For a technical diagram, explain the main point in alt text and provide detailed specifications nearby. Check that the sentence describes the actual image, including the correct color and angle.
How to add alt text on Shopify admin
- Open Products and select the product.
- Click a media item to open its preview.
- Choose Add alt text and enter your description.
- Click Save alt text, then close the preview.
The workflow comes from Shopify Help: adding alt text. Repeat it for each relevant photo. After changing a variant image, check the description again: a saved sentence about the original color or angle can become misleading.
How to add alt text in the Shopify mobile app
- Open Products in the Shopify app and select a product.
- Tap the media item to open its preview.
- Tap Information and enter the alt text.
- Tap Save or the check mark, then Save.
Review small details on the original image before saving. If the draft mentions a label you cannot read confidently, verify it against the product information rather than accepting an AI guess.
Does Shopify suggest alt text for you?
The Shopify media editor can suggest wording for an image with an empty alt field. You can accept the suggestion or edit the text. Treat it as a draft: a model may recognize a bag but miss which pocket is open or confuse a textured surface with a printed pattern.
Compare the suggestion with the photo and the product context before saving. Keep an existing accurate description when it already does the job. Generating new wording is useful for missing or misleading descriptions, not a requirement each time you open the editor.
Bulk and CSV alt text: a practical workflow
Shopify supports alt text through product CSV files. Its Shopify product CSV reference documents the Image alt text column; older templates may use Image Alt Text. Export a backup, preserve the product and image associations, and test a small import before changing a whole catalog. Import options and dependent columns can change existing data.
Do not assume every re-import only touches alt text. Review Shopify’s current import instructions and inspect the resulting image associations. Use a catalog workflow for hundreds of items; a few missing descriptions can be corrected directly in the media editor. Handykit drafts one image at a time; it is not a bulk CSV writer, catalog API, or Shopify app.
Shopify product alt text examples
Illustrative examples follow; use them only when their details match your actual image. Counts include spaces and punctuation.
- Hero photo:
Matte blue ceramic mug with a wide handle, shown from the front on a white background.
(86 characters) - Material detail:
Close-up of the tan canvas tote showing reinforced stitching around its brown handles.
(86 characters) - Lifestyle:
Green watering can pouring water into a basil plant on a sunlit kitchen windowsill.
(83 characters) - Variant angle:
Rear view of the charcoal backpack showing padded straps and a zippered side pocket.
(84 characters)
Each example adds something the product title alone would not tell a customer. The hero describes shape, the detail points to construction, the lifestyle photo shows use, and the rear view explains a different angle. Do not copy “ceramic,” “canvas,” or another material unless your product information confirms it. An image alone may not establish composition.
Choose the detail that helps a customer
For a gallery with several nearly identical photos, ask what changes between them. A side view may reveal the thickness of a sole; an open view may show compartments. Describe that difference instead of repeating the same item name. Keep the description independent of visual directions such as “the one above,” which may not make sense in a screen reader’s reading order.
For a measurement graphic, include the essential measurement in accessible product text and check its unit. A sentence describing the diagram should not replace a complete size guide. For a photo with a text label, preserve the meaningful wording when it helps explain the image; leave decorative slogans out if they add no useful information.
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.
Generate Shopify-ready alt text free
Draft Shopify 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.
Copy the reviewed sentence into Add alt text and save it on the matching media item. For several variants, work through one photo at a time so descriptions do not become attached to the wrong image.
FAQ
What is Shopify alt text?
Shopify alt text describes a media item for assistive technology and can appear when the image cannot load. It is separate from the product title.
What is Shopify’s character limit?
Shopify documents a maximum of 512 characters and recommends 125 or fewer.
How do I add alt text in admin?
Open Products, select a product and media item, choose Add alt text, then Save alt text.
Where is alt text in the mobile app?
Open a product’s media preview and tap Information. Enter the description, save or use the check mark, and save the product.
Can Shopify suggest a description?
The media editor may suggest alt text for an empty field. Review and edit the suggestion before accepting it.
Can I update alt text through CSV?
Yes. Shopify documents an Image alt text CSV column. Preserve image associations and test a small import before making catalog-wide changes.
Is Handykit a Shopify bulk tool?
No. Handykit is a free, no-signup tool for single-image drafts. It does not import a catalog or write a Shopify CSV.
Should every variant use the same alt text?
Use wording that matches each photo. Include the visible color, angle, or feature that makes that variant image informative.
Sources
Official pages fetched October 30, 2026. Limits refer to the documented field or API scope described above.