Every BigCommerce GraphQL fix we catalog
SEOLZ catalogs 1 fixes for BigCommerce GraphQL across 1 areas — SEO, answer-engine readiness, accessibility, security and site-health. Each lists the exact steps for BigCommerce GraphQL, with a link to the official docs.
SEO · 1 fixes
Seo product image alt filenameModerate effort
Replace auto-generated filename-based alt text on product images with short, descriptive phrases that accurately describe what the image shows.
On BigCommerce GraphQL
- Use the BigCommerce Catalog API (PUT /v3/catalog/products/{id}/images/{image_id}) with the 'description' field to programmatically set alt text for all product images.
- Alternatively, use the BigCommerce admin UI as described for BigCommerce above.
<!-- BAD: filename-based alt text -->
<img src="/images/IMG_4823_blue_v2.webp" alt="IMG_4823_blue_v2.webp">
<!-- BAD: empty alt text -->
<img src="/images/blue-sweater.webp" alt="">
<!-- GOOD: descriptive alt text -->
<img src="/images/blue-sweater.webp" alt="Blue cotton crew-neck sweater, front view">The correct pattern for a product image alt attribute — descriptive, specific, keyword-natural.