The Shopify CSV gap: why native export skips alt text
Shopify lets you export your product catalog as a CSV file. The export includes product titles, descriptions, prices, SKUs, and image URLs — but here's what it doesn't include: the Image Alt Text field.
If you export your products right now and open the CSV, you'll see columns like:
| Column | Included in Shopify CSV? |
|---|---|
| Handle | ✓ Yes |
| Title | ✓ Yes |
| Body (HTML) | ✓ Yes |
| Variant Price | ✓ Yes |
| Image Src | ✓ Yes — but only the URL |
| Image Alt Text | ✗ No |
This means if you want to audit or fix alt text across your store, Shopify gives you no CSV-based way to do it. You're left with three options, each with trade-offs.
Four ways to bulk-edit Shopify alt text — compared
| Method | Cost | Scales to 500+ images? | Dev skill needed? | Quality depends on |
|---|---|---|---|---|
| 1. Manual admin | Free | ✗ No | None | You typing each one |
| 2. GraphQL API | Dev time | ✓ Yes | Yes — need a developer | Custom script quality |
| 3. Third-party app | $20–$200/mo | ✓ Yes | Low | App quality + you writing alt text |
| 4. No-app CSV workflow | Free scan / $9/mo Pro | ✓ Yes | None | AI suggestions + human review |
Option 1 doesn't scale. Option 2 needs a developer. Option 3 locks you into a monthly subscription and app permissions. Option 4 — the CSV-first approach — is what we'll walk through below.
Every Shopify app you install gets access to parts of your store data. For a one-time alt text cleanup, installing a $50/mo app with product-read permissions is overkill. A CSV workflow lets you test and validate before committing to anything.
The no-app CSV workflow: 3 steps
Here's how to bulk-generate alt text for your Shopify store without installing anything:
Step 1: Scan your storefront
Use a website alt text checker that works on public URLs. Point it at any product page, collection page, or homepage on your Shopify store. The scanner reads the rendered HTML and extracts every <img> tag, along with its current alt attribute.
You'll get a table showing:
- Image URL — the full CDN path on Shopify
- Current alt text — what's there now (or "(empty)")
- Issue flag — Missing / Empty / Too vague / Too long / Looks okay
- Suggested alt text — generated from the image filename and page context
Step 2: Review and edit suggestions
AI-generated alt text is a starting point, not a final answer. You should review each suggestion and adjust it for your brand voice and product details. A good Shopify product alt text formula:
[Product name], [key visual detail], [context or use]
Example: "Organic cotton tote bag, natural beige with green leaf print, carried by model in lifestyle flatlay"
Keep alt text between 60 and 125 characters. Screen readers truncate at around 125 characters, and search engines weight the first 16 words most heavily.
Step 3: Export as CSV
Once you've reviewed the suggestions, export the full table as a CSV file. Each row contains:
- Image URL
- Current alt text
- Issue type
- Reviewed alt text (your final version)
This CSV becomes your alt text checklist. Share it with your content team, developer, or VA for implementation — no app permissions, no store access needed.
Free scans show a preview table. When the cleanup becomes repeat work, upgrade to Pro ($9/mo) for full CSV export, scan history, and monthly quota.
What to do with your CSV export
You have a CSV with every image and its reviewed alt text. Now what? Three common paths:
| Path | Best for | How |
|---|---|---|
| Manual update in admin | Under 30 images | Open Shopify Admin → Products → click each image → paste alt text from CSV |
| Give CSV to developer | Any size store | Developer writes a GraphQL mutation script that reads the CSV and updates each image's alt text via API |
| Upload via bulk editor app | Large catalogs | Use a tool like Matrixify to import the cleaned alt text rows back into Shopify in one batch |
The CSV-first approach works because it decouples generating alt text from uploading alt text. You do the hard part (writing good descriptions) in a spreadsheet, then hand off the implementation however fits your team.
Should you use AI for Shopify alt text?
Vision AI models (like the one our generator uses) can describe product images with surprising accuracy — "Navy blue linen dress with wide sleeves on female model" — and they're getting better every quarter. But AI has blind spots:
- It doesn't know your brand voice. AI might call something "red sneakers" when your catalog calls it "Cherry Blossom runners."
- It can't see what's implied. A "certified organic" label on packaging matters for SEO but AI won't flag it unless it's clearly visible text.
- It can't read your product page copy. Your title and description contain keywords AI-generated alt text should reinforce.
Our recommended approach: let AI generate the first draft, then a human reviews and adds brand-specific details. This cuts writing time by 70–80% while keeping quality high.
FAQ
Does Shopify export alt text in the product CSV?
No. Shopify's standard product CSV export includes Image Src (the URL) but does not include the Image Alt Text field. This has been a known limitation for years. You need either the GraphQL Admin API, a third-party app, or an external tool to work with alt text in bulk.
Can I import alt text back into Shopify via CSV?
Not through the standard product CSV import — Shopify's importer doesn't recognize an alt text column for images. The workaround is to use the Shopify Admin GraphQL API (developer needed) or a bulk editor app that supports alt text as a column in its own import format.
How many characters should Shopify alt text be?
Keep it between 60 and 125 characters. Below 60 characters is usually too vague; above 125 gets truncated by most screen readers. Google Images doesn't enforce a hard limit, but the first 16 words carry the most SEO weight.
Does alt text affect Shopify SEO?
Yes, in two ways. First, Google Images is a significant traffic source for ecommerce — well-written alt text helps your product photos rank. Second, alt text contributes to the overall topical relevance of your product page, reinforcing the keywords in your title, description, and headings.
Do I need alt text for decorative images on Shopify?
No. Decorative images (background patterns, divider lines, purely visual flourishes) should use an empty alt attribute (alt=""). This tells screen readers to skip them. But product photos, lifestyle shots, and infographics all need descriptive alt text.
What about the EU Accessibility Act (EAA)?
The European Accessibility Act requires ecommerce sites serving EU customers to meet WCAG 2.1 AA standards — which include alt text for all non-decorative images. Enforcement began June 2025. If you sell to EU customers, missing alt text is now a compliance risk, not just an SEO issue.