The Acquia DAM module synchronizes DAM with the Media Library of Drupal. Drupal site creators with a DAM account can search, browse, and select assets in DAM without leaving the Drupal interface.
Use this configuration when you want editors to add Acquia DAM assets to structured content such as articles, pages, or custom content types using dedicated media fields.
This page explains how to:
Add a media reference field to a content type.
Restrict that field to Acquia DAM media types.
Ensure that the field uses the Drupal Media Library for asset selection.
Related documentation
For details to configure Acquia DAM metadata and map it to media fields, refer to Metadata configuration.
To make Acquia DAM assets available in the fields of a content type:
In the administrative menu, go to Structure > Content types.
Select Manage fields for the content type you want to modify, such as Article or Page.
Select + Create a new field.
Select the reference field type
On the Add field dialog box:
For Choose a type of field, select Media as the field type.
In the Label field, enter a clear name such as Hero image, Gallery media, or Product media.
Select Continue.
Set up field configuration
On the next page, configure basic field settings such as the allowed number of values.
Under Media type, select the checkboxes for each Acquia DAM media type that you want to allow for this field. For example:
Acquia DAM: Image
Acquia DAM: Video
Acquia DAM: Audio
Configure any additional field settings as needed.
Select Save.
The content type now has a media reference field that allows editors to attach Acquia DAM assets.
Form display using the Media Library
When you configure a field to reference Media and enable Acquia DAM media types for that field:
The form display for that field uses the Media Library widget by default or can be switched to it.
Editors access the standard Media Library UI when they edit content and select Add media for that field.
Because the Acquia DAM module integrates with Drupal’s Media Library, users with the appropriate permissions and DAM authentication can:
Browse and search Acquia DAM assets.
Select assets to attach to the field.
Reuse existing DAM‑backed media entities stored in Drupal.
Note
No additional module‑specific configuration is necessary for the form display setup with the Media Library. Once the field is a Media reference and Acquia DAM media types are active, the Media Library UI is available.
Fine-tune form display
Go to Structure > Content types.
For the content type, select Manage form display.
Find your media field and ensure:
The Widget is set to the Media library.
The field is placed in the desired location on the form.
Select Save.
Display DAM media in content
To control how Acquia DAM media appears when the content is viewed:
Go to Structure > Content types.
For the relevant content type, select Manage display.
Find your media reference field.
In the Label column, select a label display option. Options include Above, Inline, or Hidden.
In the Format column, choose an appropriate formatter, such as:
Rendered entity: Also select a Media view mode such as Thumbnail, Teaser, or Hero.
Another media‑aware formatter used by your site.
Select Save.
Ensure that the chosen Media view mode is configured on the media type to use the desired image styles and metadata display.
How do I configure the Acquia DAM module with Media Library support?
The Acquia DAM module synchronizes DAM with the Media Library of Drupal. Drupal site creators with a DAM account can search, browse, and select assets in DAM without leaving the Drupal interface.
Use this configuration when you want editors to add Acquia DAM assets to structured content such as articles, pages, or custom content types using dedicated media fields.
This page explains how to:
Add a media reference field to a content type.
Restrict that field to Acquia DAM media types.
Ensure that the field uses the Drupal Media Library for asset selection.
Related documentation
For details to configure Acquia DAM metadata and map it to media fields, refer to Metadata configuration.
To make Acquia DAM assets available in the fields of a content type:
In the administrative menu, go to Structure > Content types.
Select Manage fields for the content type you want to modify, such as Article or Page.
Select + Create a new field.
Select the reference field type
On the Add field dialog box:
For Choose a type of field, select Media as the field type.
In the Label field, enter a clear name such as Hero image, Gallery media, or Product media.
Select Continue.
Set up field configuration
On the next page, configure basic field settings such as the allowed number of values.
Under Media type, select the checkboxes for each Acquia DAM media type that you want to allow for this field. For example:
Acquia DAM: Image
Acquia DAM: Video
Acquia DAM: Audio
Configure any additional field settings as needed.
Select Save.
The content type now has a media reference field that allows editors to attach Acquia DAM assets.
Form display using the Media Library
When you configure a field to reference Media and enable Acquia DAM media types for that field:
The form display for that field uses the Media Library widget by default or can be switched to it.
Editors access the standard Media Library UI when they edit content and select Add media for that field.
Because the Acquia DAM module integrates with Drupal’s Media Library, users with the appropriate permissions and DAM authentication can:
Browse and search Acquia DAM assets.
Select assets to attach to the field.
Reuse existing DAM‑backed media entities stored in Drupal.
Note
No additional module‑specific configuration is necessary for the form display setup with the Media Library. Once the field is a Media reference and Acquia DAM media types are active, the Media Library UI is available.
Fine-tune form display
Go to Structure > Content types.
For the content type, select Manage form display.
Find your media field and ensure:
The Widget is set to the Media library.
The field is placed in the desired location on the form.
Select Save.
Display DAM media in content
To control how Acquia DAM media appears when the content is viewed:
Go to Structure > Content types.
For the relevant content type, select Manage display.
Find your media reference field.
In the Label column, select a label display option. Options include Above, Inline, or Hidden.
In the Format column, choose an appropriate formatter, such as:
Rendered entity: Also select a Media view mode such as Thumbnail, Teaser, or Hero.
Another media‑aware formatter used by your site.
Select Save.
Ensure that the chosen Media view mode is configured on the media type to use the desired image styles and metadata display.
Acquia DAM