After import, all photos have alt text (a text description of the image), but many descriptions are the same: “Buy the product cheaply” or just the SKU. The completion report shows an improvement, but someone who cannot see the image still does not understand what it shows. Check whether the descriptions describe the photos themselves, not just whether the fields are filled in.
Alt text is needed in the context of a specific image and its role on the page. The right approach will differ for a main photo, a connection diagram, and a decorative border. For example, suppose you imported supplier data into a lighting catalog. Start with several different products to check whether the import replaced meaningful descriptions with generic text.
Choose different photos and a manual description
Add a product page with several colors and an older entry that someone edited before the import. The first reveals whether alt text is linked to the variant; the second reveals the risk of overwriting a good description. Confirm which fields the import always updates and which it only fills when they have no value.
Do not treat the media library field as conclusive evidence. One file can be used in different places, and the theme may take the alt text from the product name while ignoring the image information that was saved. Check the published HTML in each selected context, not just the file’s editing window in the CMS.
Identify the image’s role
For decorative images, an empty alt="" may be appropriate. This is not the same as omitting the attribute: assistive technologies may handle these cases differently. Do not fill a decorative element with a list of keywords just to improve the report. The selection approach is covered in the W3C alt decision tree.
Check the surrounding text and the purpose of the link. If the image and product name are in the same link, the text alternative should take the already available name into account rather than create a meaningless repetition. For a button made up only of an image, the action description is especially important: the user should understand what will happen when it is activated.
Compare the alt text with the image
Note differences that affect meaning. An incorrect color can make it harder to choose a variant; a claim about a feature that is not visible in the photo introduces an unsupported assertion; repeating the site name in every alt does not describe the product. Do not try to put every catalog attribute into one field: the text should convey the information needed about the image.
For a size diagram, brief alt text can state its purpose, while detailed measurements are better provided as accessible text on the page. If important dimensions are only shown inside the image, a general description such as “Product diagram” is not enough. The solution concerns the product page’s content too, not just a single attribute.
Where the import gets the description
These photos could use the following descriptions:
| Image | What came from the supplier | What to display on the page |
|---|---|---|
| Main photo of the black model | Name and variant color | alt="Чёрный светильник L-24, вид спереди" |
| Connector photo | Caption “power connector” | alt="Разъём питания светильника L-24" |
| Size diagram | Filename only | alt="Размеры светильника L-24", with the measurements as nearby text |
| Decorative background | Brand name | alt="", if the background is only decorative |
Write down the rule for missing data and manual descriptions. In the import settings, exclude manual alt text from being overwritten if the supplier should not update it. Otherwise, the first check will pass, but the next overnight sync will restore the same automatically generated descriptions throughout the catalog.
Switch the product variant
Look at the gallery thumbnails. They may repeat the main image, be standalone links, or be variant-switching buttons. For a control, the accessible name should describe its action; the alt text of an image inside it should not be assumed to be the only way to provide one. In DevTools, open Accessibility and check the button’s accessible name: it should explain which view it opens.
When using responsive formats, make sure the selected source shows the same object. If the mobile file is cropped to a detail, a description of the full view may be inaccurate. Do not confuse technical compression with a meaningful image replacement: they have different checking criteria.
In the browser console, display the descriptions of the photos on the open product page:
[...document.images].map(img => ({ файл: img.currentSrc, alt: img.getAttribute("alt") }));For the black L-24, a description of the black light is expected. After selecting the white variant, both the file and the corresponding alt text should change. null means the attribute is absent; "" means it is intentionally empty, which may be correct for a decorative image.
Assess the meaning of the descriptions
Google considers alt text along with other page information when interpreting an image; guidance is available in the official image guidelines. This is not a reason to fill the attribute with repeated search queries, nor a promise of higher rankings after import.
In the report, distinguish completeness, whether the description matches the image, and whether important information is accessible. For example, note which photos you reviewed: the main image, connector, diagram, and decorative background. List any remaining issues next to them—incorrect color, an overwritten manual description, or measurements available only inside the image.
You can supplement your file-processing setup with the image optimization guide. If the import also changed photo size and quality, use the compression guide separately. Reducing the file size does not confirm that its description is correct.
Run the next import on test products
The manual description was preserved, the new photo received suitable alt text, and the decorative background remained with an empty attribute. The diagram’s measurements are available as nearby text. Checking for non-empty fields alone does not show whether these descriptions are good.
Read also: Image optimization, Image compression, Technical page audit.