--- title: "Acquia DAM Integration with Drupal" date: "2025-04-22T11:40:50+00:00" summary: "Seamlessly integrate Acquia DAM with Drupal's Media Library. Learn how to install, configure, and authenticate this powerful module for efficient digital asset management in your Drupal site." image: type: "page" url: "/acquia-dam/acquia-dam-integration-drupal" id: "9a9d325a-6382-4b04-a981-610669458d3e" --- The Acquia Digital Asset Management (Acquia DAM) module synchronizes Acquia DAM with Drupal's Media Library. This integration enables Drupal site creators to search, browse, and select assets stored in Acquia DAM without leaving the Drupal site builder interface. The module uses embed codes for downloading and serving assets through Drupal. Installing the Acquia DAM module -------------------------------- To install the module: 1. Add the module to the Drupal codebase by using Composer: `composer require drupal/acquia_dam` 2. Enable the module for use on the sites by running the following Drush command: `drush en acquia_dam acquia_dam_integration_link` Generating the API access token ------------------------------- To generate the API access token: 1. Log in to the Acquia DAM portal as an administrator. 2. From the global dropdown, select **Admin**. 3. Click **Global settings** > **API setup**. 4. On the API Setup page, click **New integration**. 5. In the **Integration Name** field, enter a friendly name for the integration. For example, DAM and Drupal Integration. 6. In the **Description** field, enter a brief description for the integration. For example, This token is created for the example.com site. 7. Click **Register**. ![Acquia-dam_register](https://acquia.widen.net/content/8cefa152-8e58-4a95-8b30-d530ed15459d/web/76c67_Acquia-DAM-Register-integration.png) The API Setup page displays a row for the integration. 8. In the row for the integration, click **Generate User Access Token**. ![Acquia-dam_generate-access](https://acquia.widen.net/content/a2354cfe-f62a-4df8-9b7e-13f0dda8fecf/web/58306_Acquia-DAM-generate-access-token-link.png) 9. In the Generate User Access Token dialog box, do the following: 1. In the **Email Address** field, select your email address. 2. Click **Generate Token**. ![Acquia-dam-email-address](https://acquia.widen.net/content/2efd1c49-9757-412b-a26a-52a783354c25/web/dd3d1_Acquia-DAM-select-email-address.png) The dialog box displays the access token. 3. Copy the access token and save it to a secure location. ![Acquia-dam-token-generated](https://acquia.widen.net/content/e1c19694-7c75-4b47-82e4-c3c3a82bdceb/web/a841e_Acquia-DAM-token-generated.png) 4. Click **Close**. Authenticating a site with an Acquia DAM account ------------------------------------------------ To use Acquia DAM with a site, complete the following steps to authenticate the site with an Acquia DAM account: 1. Authenticate with a secure API access token for site authentication 2. Authorize with Acquia DAM account for user authentication ### Authenticating the site To authenticate your site: 1. Log in to your Drupal site and go to the Acquia DAM configuration page at `/admin/config/acquia-dam.` ![Acquia-dam_site-authentication](https://acquia.widen.net/content/4be16d7b-144e-447f-94ab-1bad15403454/web/43a36_acquia-dam-authentication-form.png) 2. In the **Access token** field, enter the access token that you [generated and copied from Acquia DAM](#generate-access-token). 3. In the **Acquia DAM domain** field, enter your Acquia DAM domain. 4. Click **Authenticate Site**. The Acquia DAM configuration page displays a status message to confirm the authentication. ### Authenticating the user in Acquia DAM 1. Log in to your Drupal application. 2. Navigate to your user profile, which is usually located at /user. 3. In your profile menu, click the **Acquia DAM** tab. 4. Click the **Authorize** button to authenticate with Acquia DAM. **Configuring image styles** ---------------------------- To configure image styles: 1. On the Configuration page, select the **Image styles** tab. 2. In the **Allowed image styles** list, select the checkboxes for the required image styles. 3. Click **Save configuration**. ![Acquia-dam_image-styles](https://acquia.widen.net/content/d0f15ba6-79ce-4c0f-9213-102c18bb8fc6/web/8e2e6_acquia-dam-image-style-config-form.png) **Configuring metadata** ------------------------ ### Selecting fields To select fields: 1. On the Configuration page, select the **Metadata** tab. 2. In the **Name of metadata field in DAM** list, select the checkboxes for the fields that you want to map from Acquia DAM to the Drupal module. 3. Click **Save configuration**. ![Acquia-dam_metadata-handling](https://acquia.widen.net/content/6dee8910-0856-4035-afc5-f48d705e23af/web/191e3_acquia-dam-metadata-handling.png) ### Mapping fields To map fields: 1. Go to **Structure** and click **Media Types** in Drupal. 2. For images sourced from Acquia DAM, click **Edit**. 3. In **Map Fields**, view the DAM metadata fields selected during configuration. By default, only the name and alt text fields are available for mapping. 4. To map new fields, create the required fields in Drupal and select them for mapping. ![Acquia-dam_media-type](https://acquia.widen.net/content/4bcb4be7-6e04-4741-9518-1c97f993a872/web/60bca_acquia-dam-media-type-field-mapping.png) Note [Dependent metadata fields](/acquia-dam/what-are-dependent-metadata-fields "What are dependent metadata fields?") cannot be mapped to your Drupal application. Configuring DAM media as a field in a content type -------------------------------------------------- To configure DAM media as a field in a content type: 1. Create a media field and select Acquia DAM as the media source. For example, for the _page_ content type, add a new field named **Media**.
 2. Click **Create a new field** and choose a field of type as **Media**. ![Acquia-dam_media-type-select](https://acquia.widen.net/content/f5edf519-cb23-40ea-9576-7bb69a73f7ef/web/182e0_Acquia-DAM-media-field-type-selection.png?w=720&itok=VKNsDVkl) 3. Set the field label to **Media** in the Label field and click **Continue**. ![Acquia-dam_media-fields](https://acquia.widen.net/content/8d6844c4-082e-420c-a2ce-539aa951a0d1/web/a1f36_Acquia-DAM-media-field-creation.png?w=720&itok=MZ-ZaU6P) 4. After selecting the required media type from the list, click **Save**. ![Acquia-dam_media-settings](https://acquia.widen.net/content/260bb864-4e89-4154-be0a-7c748746f7bf/web/2d1f3_Acquia-DAM-media-type-selection.png?w=720&itok=aJSnNQ8O)