Labelling AI images in WordPress

Add the script tag

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

The script tag belongs once in the head of every page, not in single posts. The simplest way is the WPCode plugin: “Code Snippets” menu, header field (“Scripts in Header”), save. With your own theme, load the script in a child theme with the defer strategy:

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script( 'ai-label', 'https://www.ai-label.app/widget.js', array(), null, array( 'strategy' => 'defer' ) );
} );

A script tag in a Custom HTML block only works on that one page. Only roles with the unfiltered_html capability may save it, which means administrators and editors on a single site and only super admins on a network.

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 WordPress, mark images through the alt text. You find it in an image's details in the media library and in the image block settings in the block editor. Featured images take their alt text from the media library.

The file name does not work. On upload, sanitize_file_name() collapses several hyphens into one. vase--ai.jpg becomes vase-ai.jpg, and the marker is gone. The data-ai-label attribute is only worth it in theme templates.

WordPress/ Media library / Attachment details

AI

kerze.jpg

Alt text

Scented candle in a jar (AI-generated)

AI-generated

Scented candle in a jar€24.90

Stoneware vase€32.00

AI-generated

Mushroom lamp€59.00

Pitfalls

• Alt text in older posts: the image block stores the alt text in the post when you insert it. A later change in the media library does not reach existing image blocks. Add the suffix there one by one.
• Delayed JavaScript: optimisation plugins sometimes hold scripts back until the visitor scrolls or taps, for example “Delay JavaScript execution” in WP Rocket. Then the label is missing at first view. Add widget.js to the exclusion list (“Excluded JavaScript Files”).
• Page cache: after adding the script, clear the cache of your caching plugin and, if you use one, your CDN.
• Theme update: changes made directly in the parent theme are lost with the next update; in a child theme they stay.

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.
• Newsletters and RSS feeds show your images without the script, so without the label.
• 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 WordPress app is planned. There is no date yet.