How do I configure automatic ALT text for images in Site Studio after I use Entity Browser or Media library?

After a site configuration uses Entity Browser or Media library for image selection, the Image and Picture elements in the components do not automatically populate the alternative (ALT) text from the media entity. To ensure accessibility, you must map the ALT text by means of a specific Drupal token in Site Studio 8.2.6 or later.

Configuring automatic ALT text

To fetch the media entity ALT text, complete the following steps:

1. Navigate to the particular component in Site Studio.

2. Edit the component that contains the Image or Picture element.

3. Locate the Alt tag field in the element settings.

4. Enter the token: [media-entity-reference:media-alt].

5. Save the component settings.

After you insert this token, Site Studio fetches and displays the ALT text associated with the referenced media entity when this component renders.

Configuring Acquia DAM for ALT text

To ensure that the Acquia DAM configuration is correct for ALT text, complete the following verification steps:

1. Review the ALT text settings at /admin/config/acquia-dam/metadata to ensure that you select the desired metadata fields for mapping.

2. Ensure that the ALT text field maps correctly in the Drupal media type settings at admin/structure/media/manage/acquia_dam_image_asset under the Map Fields section.