---
title: "How do I configure the Acquia DAM module with Media Library support?"
date: "2025-01-09T16:14:00+00:00"
summary: "Configure Acquia DAM module with Media Library: Install, set up domain, authorize, map metadata fields for seamless DAM-Drupal integration."
image:
type: "page"
url: "/acquia-dam/how-do-i-configure-acquia-dam-module-media-library-support"
id: "7a2cd405-9171-40f3-a337-54daa7830b8a"
---

Table of contents will be added

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 enable Acquia DAM assets in rich text editors, refer to Text editor configuration in [How do I configure the Acquia DAM module with Media Library support?](https://docs.acquia.com/acquia-dam/how-do-i-configure-acquia-dam-module-media-library-support)

Add a media reference field to a content type
---------------------------------------------

To make Acquia DAM assets available in the fields of a content type:

1.  In the administrative menu, go to **Structure > Content types**.
2.  Select **Manage fields** for the content type you want to modify, such as ****Article**** or ****Page****.
3.  Select **\+ Create a new field**.

### Select the reference field type

1.  On the _Add field_ dialog box:
    
2.  For _Choose a type of field_, select ****Media**** as the field type.
    
3.  In the _Label_ field, enter a clear name such as Hero image, Gallery media, or Product media.
    
4.  Select ****Continue****.
    

### Set up field configuration

1.  On the next page, configure basic field settings such as the allowed number of values.
    
2.  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
3.  Configure any additional field settings as needed.
4.  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

1.  Go to **Structure > Content types**.
2.  For the content type, select **Manage form display**.
3.  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.
        
        ![Acquia-DAM_manage-form-display](https://acquia.widen.net/content/3bdf8c57-3aed-4c00-a57c-9fd7b1c105f3/web/5366f_Acquia-DAM-content-type-manage-form-display.png?w=480&itok=6_3KaP-p)
        
4.  Select **Save**.

Display DAM media in content
----------------------------

To control how Acquia DAM media appears when the content is viewed:

1.  Go to **Structure > Content types**.
2.  For the relevant content type, select **Manage display**.
3.  Find your media reference field.
4.  In the _Label_ column, select a label display option. Options include ****Above****, ****Inline****, or ****Hidden****.
    
5.  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.
        
        ![Acquia-DAM_manage-display](https://acquia.widen.net/content/a881adbb-0b07-42fd-b684-3504252c6f11/web/b471e_Acquia-DAM-content-type-manage-display.png?w=480&itok=_bYH9RML)
        
6.  Select **Save**.

Ensure that the chosen Media view mode is configured on the media type to use the desired image styles and metadata display.

For more details about configuring image styles and display modes for DAM‑backed media, refer to [Configuring image styles](/acquia-dam/configure-image-styles "Configure image styles") and [Metadata configuration](/acquia-dam/metadata-configuration "Metadata configuration").

More about the module
---------------------

*   [How do I use the Acquia DAM module?](https://docs.acquia.com/acquia-dam/how-do-i-use-acquia-dam-module)
*   [How to migrate from Media Acquia module to Acquia DAM module?](https://docs.acquia.com/acquia-dam/how-migrate-media-acquia-module-acquia-dam-module)