Managing automated alt text

Release date: 9th April 2025

In this release, we've further enhanced our support for image alt text with the new Automatic alt text extension extension. This extension enables you to seamlessly retrieve and use automatically generated alt text for images in Content Hub, as part of your authoring workflow in Dynamic Content.

Used in combination with our Automatic Alt Text generation service this extension helps ensure that images in your content have the necessary alt text to make them accessible for users who rely on screen readers, without the need to manually enter alt text for every image and locale.

For developers, having localized image alt text descriptions stored with the content simplifies the API calls that need to be made to get the image alt text.

In addition to automatically including existing image alt text into your content, this extension lets you modify alt text to better match your content, saving the changes as part of the content. See Refreshing and modifying alt text.

Using the Automatic alt text extension

To use the Automatic alt text extension, simply associate it with an image field and a string field (that represents the alt text) in your content type schema. You can use this extension with both standard and localized text string fields.

The extension can be used with any native Amplience image field, including if that field is in an extension.

Setting up this extension

You can find complete configuration documentation for this extension on GitHub.

Alt text for standard text fields

When the Automatic alt text extension is used with a standard text field, the Dynamic Content authoring experience will show one alt text field and a number of locale options, like the example below:

The alt text that will be used with the image is displayed in the "Alt text" field. You can view or select other alt text from the available locale options displayed below the text field.

If you modify alt text values, the updates will be saved with the content, without updating the alt text in Content Hub. To reset changed alt text values back to those stored in Content Hub, select the required locale and click the globe icon.

Alt text for localized text fields

When the extension is used with a localized text field, the Dynamic Content authoring experience displays each alt text locale in a list that you can expand or collapse.

To reset the alt text values back to those stored in Content Hub you can:

• Reset all of the alt text values at once by clicking "Refresh alt texts"
• Reset individual alt text values by refreshing them individually

Clearing all alt text values

You can quickly clear all image alt text values for all localized fields by using "Clear all".

Refreshing and modifying alt text

To overwrite alt text shown in the authoring experience with image alt text stored in Content Hub, you use 'Refresh alt texts'.

Instances when you may want to refresh alt text values in your content are:

• To reset image alt text values you've modified while authoring content, back to what’s saved in Content Hub.
• If you retrieve image alt text after swapping an image for a different image.
• If the extension is configured not to automatically retrieve image alt text from Content Hub, you will need to use 'refresh' to initially load image alt text from Content Hub. When you save content that has alt text, the alt text will be loaded when you next open the content.

note

Any alt text updates that you make in the Dynamic Content authoring experience are made in your content only, and are not saved back to Content Hub.

Related pages

Using the Automatic alt text extension

Automatic alt text extension GitHub repository

Automatic alt text generation service

Working with image alt text