Shopify alt text for a product image is the short description an upload team enters in the admin, either one image at a time or in bulk via CSV. Every image in a product's media gallery has its own field. When a merchant hands off a catalog without any format guidance, the team writes their own version or leaves the field blank. A brief that takes five minutes to write can prevent weeks of inconsistent data.
Key takeaways
- Alt text is set per product image in Shopify, not only on the featured image.
- Shopify's platform limit is 512 characters; 125 or fewer is the recommended length.
- Each image in a multi-image product listing should have different alt text that describes what that specific shot shows.
- Upload teams need a formula from the merchant before starting: repeating the product title for all images wastes image SEO value.
- Alt text serves two purposes: it tells Google what the image contains, and it appears on screen when an image fails to load.
How alt text works in Shopify
In the Shopify admin, alt text lives on each media item attached to a product. To add or edit it, go to Products, click a product name, click a media item to open the preview, and click Add alt text. Enter the text and click Save alt text (as of November 2026).
Every image in that product's media gallery has its own alt text field. A product with five images, showing front, back, side, and two detail shots, has five separate alt text fields to fill in.
Shopify's documentation sets the maximum at 512 characters, but recommends 125 or fewer. At 125 characters, you can fit roughly 20 to 25 words. That is enough for a specific, descriptive sentence.
Alt text also appears when an image fails to load, and is read by screen readers for visually impaired shoppers. That accessibility purpose and the SEO purpose point in the same direction: be specific about what the image shows.
What upload teams write in the Shopify alt text field
A useful alt text entry names the product, the key attribute visible in the image, and the shot type where that is relevant. For a white linen shirt photographed from the front, the alt text might read: "White linen relaxed-fit shirt, front view."
Upload teams doing a large catalog job need a consistent formula, not creative writing. Without a formula, individual team members make different choices. Some write the product title. Some describe the background. Some focus on the main feature. The result is inconsistent alt text across a catalog that looks sloppy to screen reader users and provides less useful signal to Google.
A practical formula has three parts:
| Part | What to include | Example |
|---|---|---|
| Product name | The product's actual name, not the category | "Relaxed Linen Shirt" |
| Key attribute | Color, size, material or the defining feature shown | "in white" |
| What the shot shows | The view, detail or angle | "front view" / "collar detail" |
Full example: "Relaxed Linen Shirt in white, front view." That is 39 characters, well inside the recommended 125.
Why every image in a listing needs different alt text
A product page with six images, all carrying the same alt text, sends Google a weaker signal than six images each describing a distinct view. Google uses alt text alongside computer vision to understand what an image contains. When six images share one description, Google has to work harder to understand what each one shows. It may also treat repeated text as lower-quality metadata, since the same string describing six images usually means the person adding it did not look at each one.
The practical problem for upload teams: without instructions, the path of least resistance is to paste the product title into all alt text fields. It satisfies the "not blank" requirement, but it gives every image the same description regardless of what each one actually shows.
One rule resolves this. Tell your team: if a product has more than one image, the alt text for each image must say something different. The featured image gets the main description. Supporting images describe their specific shot, detail, or angle.
What to include in your alt text brief
If you are handing a product catalog to an upload team for the first time, include a section on alt text in your brief. It does not need to be long. The team needs answers to four questions:
- What naming convention does the product use? The team needs to know whether to write "Navy Oxford Button-Down Shirt" or "Oxford Shirt in Navy" or something else.
- Do variants affect the alt text? If a product comes in six colors and each color has its own set of images, does the alt text name the color? Usually yes.
- How should detail shots be described? "Collar detail", "stitch detail", "interior lining view" are all legitimate approaches. Pick one format and note it.
- What is the language for shot types? "Front view / back view / side view" or "front / back / side" or something else. Consistency within the catalog matters more than the exact words.
If you have an existing style guide for product naming, the team can usually apply the same conventions to alt text. If not, three example entries for your most complex product type are enough to set the standard.
What happens when alt text is left blank
Shopify shows a blank alt text field as empty. The image still loads and displays normally. However, screen readers announce it as decorative or skip it, so visually impaired shoppers get no information about what the image shows.
From a search perspective, Google uses alt text alongside computer vision to understand what an image contains, as documented in Google's image SEO guidance. For product images in particular, alt text is one of the clearest signals for image search results and for understanding which images belong to which product variant.
For an upload team delivering a catalog of several hundred products, the volume of blank alt text fields can add up quickly. An upload job that includes alt text from day one is significantly easier to maintain than one where alt text is added as a cleanup task later.
You can also add alt text in bulk through a CSV file. The Shopify Help Center covers the alt text field and CSV approach as part of the product media documentation.
For more on the SEO context for product titles, which works alongside alt text to help Google understand product pages, see Shopify Product Title SEO for Upload Teams.
If you are briefing a team for the first time, What to Send Your Upload Team Before a Shopify Job has a broader checklist of the information teams need before they start.
The briefing article Briefing a Shopify Description Writer: What to Include applies the same approach for product descriptions, and the same principles carry over to alt text: specifics work better than generalities.
For image preparation as part of a larger upload job, our product image optimization service covers what the team handles beyond alt text, including file formats, consistent sizing, and descriptive file names.
Frequently asked questions
Does Shopify automatically add alt text to product images?
Shopify's media editor may suggest alt text for images that do not already have it. You can review and edit the suggestion, then click Accept to save it, or write your own. The suggestion does not save unless you accept it. Upload teams entering alt text manually through the admin or via CSV are not affected by this feature.
What is the character limit for Shopify product image alt text?
Shopify's platform limit is 512 characters. The recommended length is 125 characters or fewer. At 125 characters, you can write a specific, descriptive sentence for most product images without approaching the limit. Very long descriptions interrupt the screen reader experience for shoppers.
Should alt text include the product's keywords?
Include keywords where they fit naturally in a description of the image. For example, "White linen shirt, front view" naturally contains "linen shirt," which is relevant. What you should avoid is writing a string of keywords with no descriptive value, for example "shirt white linen cotton buy cheap." Google describes that as keyword stuffing and may treat it as spam. The test is whether the text describes what a sighted person would see in the image.
Can alt text be added to product images in a CSV upload?
Yes. Shopify allows alt text to be included when adding or updating product images through a CSV file. This is the most efficient approach for upload teams adding alt text to large catalogs. The Shopify Help Center documents the column format for alt text in the product CSV.
What should alt text say for a product with multiple color variants?
If each color variant has its own set of images, name the color in the alt text for those images. For example, "Relaxed Linen Shirt in sage, front view" and "Relaxed Linen Shirt in white, front view." If all colors share the same set of images, name the product and the shot type and note the color range in the product description instead. Include the color convention in your brief to the upload team before the job starts.
