Labelling AI images in OXID eShop

Add the script tag

<script src="https://www.ai-label.app/widget.js" defer></script>

The OXID developer documentation shows how a module extends a block of the active theme. For the APEX theme, the extension lives in the module under views/twig/extensions/themes/apex/, in the same path as the original template. It inherits from the template with {% extends %} and overrides a block of the same name:

{% extends 'layout/base.html.twig' %}
{% block BLOCKNAME %}
    {{ parent() }}
    <script src="https://www.ai-label.app/widget.js" defer></script>
{% endblock %}

Template and block name are placeholders. Choose a block that is output in the head or footer of every page; the names are in the APEX theme templates on GitHub. {{ parent() }} keeps the original content. Then reactivate the module.

Mark images

Which images need a label is your decision, for example with the labelling check. The widget only labels marked images, in three ways that can be combined:

• Attribute on the image: data-ai-label="generated" for images created entirely with AI, data-ai-label="modified" for photos edited with AI.
• File name with a marker before the extension: vase--ai.jpg or vase--ai-mod.jpg.
• Alt text ending in “(AI-generated)” or “(AI-modified)”.

In OXID, the file name is the easiest way. In the admin area, open the product details on the Pictures tab and rename the file before uploading, for example to vase--ai.jpg. The system creates a thumbnail and an icon from it. Check in the page source that --ai appears in the delivered image address.

Custom alt text for product images depends on theme and version. Where it is available, the suffix at the end also works. In your own templates, set the data-ai-label attribute directly.

OOXID Admin/ Product / Pictures

AI

kerze--ai.jpg

Upload image

kerze--ai.jpgBrowse

AI-generated

Scented candle in a jar€24.90

Stoneware vase€32.00

AI-generated

Mushroom lamp€59.00

Pitfalls

• HTML sanitizer: OXID 7.5 offers an HTML sanitizer, disabled by default. When enabled, it removes <script> and event handlers, among others, so a script tag in CMS content is not reliable.
• Theme update: changes made directly in the APEX theme files are lost with an update; the module stays.
• Enlarged view: check that the label appears in the zoom view.

Limits of the widget

• The widget only reaches <img> elements on pages with the script. Background images from the stylesheet and images under 48 pixels (adjustable with data-min) stay unlabelled.
• Check whether the block you chose is output in cart and checkout.
• It cannot reach emails such as order confirmations. For images outside your website, create a copy with the label burned in using Label an AI image.
• Privacy: when the script loads from ai-label.app, our host sees the IP address, as with any request. The script sets no cookies. Mention it in your privacy policy.

Native app

A dedicated OXID eShop app is planned. There is no date yet.