Automatic SEO Images Alt Tags: setup and help

Upload the ZIP in Modules > Module Manager > Upload a module. Install it and click Configure to open the dashboard. Open Improve > SEO Images Alt Tags > Configuration to edit settings.

Image alt text uses the product or category image data supplied by PrestaShop and displayed by your theme. The category template applies from PrestaShop 9.1.

Click Save. Long results are shortened at the character limit. The builder uses a nearby word boundary when a space falls within the final 30 percent of that limit.

Use these product tokens when the corresponding fields exist in the presented product:

{product_name}, {manufacturer}, {category}, {reference}, {ean13}, {isbn}, {upc}, {mpn}

Use {image_position} for numbered gallery images on the product detail page. Positions start at 1 in gallery iteration order. Cover, default image, and listing text do not receive that variable.

Category templates accept {category_name} and {category_description}. The description token strips HTML tags.

For example:

Product Page Template: {product_name} - {manufacturer} - Image {image_position}
Product Listing Template: {product_name} in {category}
Category Image Template: {category_name}

Because the first example also applies to the cover, its literal word Image can remain without a number there. Use {product_name} - {manufacturer} if you want the same complete phrase on all product image contexts.

You can also use catalog identifiers:

{product_name} - {reference}
{product_name} - {manufacturer} - {ean13}
{product_name} - {mpn}

Missing tokens become empty strings. The builder strips HTML from token values, decodes entities, collapses whitespace, and cleans repeated or edge - and | separators. For a product named Classic Linen Shirt, {product_name} - {manufacturer} produces Classic Linen Shirt - Northwear when the manufacturer is Northwear. It produces Classic Linen Shirt when the manufacturer is missing.

Choose a product with an empty saved image legend. Keep Override Existing Alt Tags set to No and save a template with a recognizable product field. Clear any page cache, then open the product and a listing containing it.

Inspect the rendered image's alt attribute. On product pages the module updates cover, default_image, and entries in images. On listings it updates those same structures when present. The theme must use their legend values in image markup.

To check preservation, open an image with an existing manual legend. It should retain that legend with replacement disabled. To test replacement, temporarily enable Override Existing Alt Tags, inspect the output again, then restore your intended mode.

Category alt texts are applied through the actionPresentCategory hook, which PrestaShop calls from version 9.1. On earlier versions the category template is saved, but category images keep their current alt text.

Generated legends are assigned during rendering. They are not written back to catalog image legend records. The module builds text from catalog data and does not inspect image content.

If your theme constructs its own image tags, use the presented image legend for alt. For example, inside markup for the relevant cover image:

alt="{$product.cover.legend|escape:'html':'UTF-8'}"

Use the matching gallery image's legend when rendering a gallery loop. Do not use the cover legend for every gallery entry if you need {image_position} values.

Confirm Enable Module is Yes. Check whether the image already has a legend and whether replacement is disabled. Confirm the page uses actionPresentProduct or actionPresentProductListing and the theme reads the changed legend.

If a token is empty, inspect the presented field. Manufacturer and category tokens read manufacturer_name and category_name; a custom presenter may omit them. Unsupported tokens are removed. If the generated result is empty, the hook leaves image data alone.

If output appears stale, clear the shop's page or template cache. Use the module's Integrity page to check configuration infrastructure and template values. It can repair missing required template values. Repair templates differ from installation templates: Product Page becomes {product_name} - {manufacturer} - {category}, Product Listing becomes {product_name} in {category}, and Category Image becomes {category_name} category image. Review them after repair.

Set Enable Module to No to stop generation while retaining your templates. You can also disable the module in Module Manager.

Uninstall through Module Manager when you no longer need it. Uninstall removes the module's menu, configuration, and admin preferences. Your original catalog image legends remain because generation did not overwrite them in storage.