Skip to main content

Viewing and editing image alt text

If you have enabled Automatic alt text generation then text descriptions will be automatically added to images uploaded to Content Hub. You can view and edit the alt text in Content Hub and Dynamic Content.

For more details about setting up automatic alt text generation and retrieving the alt text in Content Hub and Dynamic Content, see the Working with image alt text developer guide.

Viewing generated image alt text
Link copied!

You can view generated image alt text using the Content Hub properties pane. The text for the default locale is shown in its own field and also in the list of any additional locales that have been set up for generation.

Image alt text properties on the properties pane

To view generated alt text from Dynamic Content, click "ALT" on the media card. Note, you can only view automatically generated alt text using the Next Generation Authoring experience. See Applying image alt text in the authoring experience.

Accessing image alt text from a media card

If alt text has been generated for more than one locale, you can select which localized version of alt text you want to use in your content item.

Displaying image alt text from a media card

Updating generated image alt text
Link copied!

You can update generated alt text using different methods.

Updating from Content Hub
Link copied!

From Content Hub, you update generated alt text using the Properties pane. The alt text shown in the Properties pane is part of the image metadata, and is the definitive source for image alt text. This AI-generated alt text is intended to describe what is represented in the image, but you may want to adapt this description, based on the context in which the image is used.

Editing default image alt text

Note, updating the "Alt Text (default)" locale doesn't automatically update the variant from which it was derived. In the example above, the default locale text has been updated to be different from the en-GB variant text from which it was derived.

Updating from Dynamic Content
Link copied!

When you're creating content with Dynamic Content, you may want to adjust image alt text to fit the context of the content for your audience. For instance, you may want to modify the generated alt text slightly to indicate why an image is relevant, by highlighting a particular product shown in the image that is also referenced in the surrounding page text.

Image alt text applied using Dynamic Content is specific to the content, does not override the metadata saved in Content Hub.

Here's an example, where the generated alt text is generic, and not highlighting the product featured in our example content:

Generic image alt text

Using Dynamic Content, we can quickly update the image alt text to be more specific about the product.

Image alt text updated with product specific text

Searching for images without alt text
Link copied!

Even with automatic alt text generation turned on for a hub, there might still be some images where alt text descriptions are missing.

To find images that have missing alt text, you can use Content Hub queries to search for:

  • Images that have not been processed by the automatic alt text service. This includes images that were uploaded to Content Hub before automatic alt text was enabled on the hub.

    Use the query: type:image AND -altText.defaultDescription:*

  • Images that have an empty default alt text description. This is when the alt text schema exists against an asset, but the default value is empty. This can happen if the auto alt text service runs out of credits and is unable to complete generating alt text during an upload.

    Use the query: type:image AND altText.defaultDescription:""

note

Currently, it's not possible to search for images with empty alt text locale variants.

Version history and image alt text
Link copied!

Changes made to image alt text are not recorded in the image version history. Although image alt text is displayed in the Properties pane in Content Hub, it is added to image metadata and as a result cannot be restored from a previous version. More about restoring previous versions of assets.

Using Amplience credits
Link copied!

When you manually upload images to Amplience, we first check your Amplience credit balance to ensure you have enough credits before generating alt text.

If you run out of credits while generating alt text during a bulk upload, alt text will continue to be created until all credits are used up.

Your organization administrator can check your credits balance and usage from the Account Management- Usage tab.

Credit usage and pricing may vary according to the plan agreed when the service is provisioned.

Content Studio Alt text template

Amplience credits

Working with image alt text, developer guide