Alt text on product and variant images ensures accessibility and improves the shopping experience for all users. It provides visually impaired individuals with essential information about a product’s appearance and features, supports users on slow internet connections, and contributes to search engine optimization. By using accurate and descriptive alt text, marketplaces can expand reach, provide equal access, and improve discoverability.
Marketplacer supports alt text on product and variant images through the following methods:
Operator and seller API (GraphQL)
- Query alt text on products and variants via the AdvertSearch or AllAdverts queries.
- Add, edit, or remove alt text via the AdvertUpsert and VariantUpdate mutations.
- If updating existing images, all image nodes must be provided in the request. Otherwise, images not included will be removed.
- See full details in the API documentation.
Seller API (REST)
- Query alt text using the advert and variant image endpoints (GET).
- Add, edit, or remove alt text using the advert and variant image endpoints (POST, PUT).
- See full details in the API documentation.
How to add alt text on product or advert images in the Seller portal
- Log in to seller portal and go to Products.
- Open the Media tab.
- Upload an image.
- Add alt text under the Alt text column.
How to add alt text on variant images in the Seller portal
- Log in to seller portal and go to Products.
- Open the Variants tab.
- Upload an image.
- Add alt text under the Alt text column.
Bulk product spreadsheet
- The bulk product spreadsheet supports adding, editing, and removing alt text for images.
- Alt text will be ignored if no image exists in the upload.
- 40 columns are available: 20 for product image alt text and 20 for variant image alt text.
- Column headers for product image alt text:
- Image Alt text 01 (Main) through Image Alt text 20 (between columns Image 20 and Variant Image 01 (Main)).
- Column headers for variant image alt text:
- Variant Image alt text 01 (Main) through Variant Image alt text 20 (between columns Variant Image 20 and Errors).
- Bulk product export configuration:
- Enable or disable the alt text columns using the checkboxes Image Alt Text and Variant Image Alt Text.
Related articles