The 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 supports two delivery methods:
Embed codes: These serve assets through a CDN.
Download and sync: This method downloads assets to the Drupal local file system and serves them from there.
Before you begin
Ensure that the Acquia DAM module is in place and your Drupal site and users are authenticated. Verify the following:
The Acquia DAM module is installed and enabled on your Drupal site.
Your Drupal site is authenticated with your Acquia DAM account.
Your Drupal user account is authenticated with Acquia DAM.
If a user is not authenticated, they may not see any DAM assets in the Media Library or may receive permission errors. For details, refer to Authenticate a Drupal user with Acquia DAM.
Note
This integration uses version 3 (v3) embed links. If you currently use version 2 (v2) embeds, be aware of this difference before you proceed.
Using Acquia DAM assets in Drupal content
When you create content in Drupal, explore assets in Acquia DAM and add them to your pages through the Media Library.
In the content edit page, select Insert Media where you can select the media files or upload a new file.
In the Media Library, select DAM as the media source.
Select one of the media types, as per your requirement.
Refine your results by using search or category filters as configured in your DAM.
Select one or multiple assets to embed in the page, then select Next: Select Format.
Choose a format for your media. The selected asset is added to the Drupal page as an embed code so that it remains synchronized with Acquia DAM. For images, the maximum width and height is 2,048 x 2,048 px.
Under Version, choose one of these options:
Automatically update: Update automatically when assets are updated in Acquia DAM.
Manually update: Require a manual update when a new version becomes available.
Select Insert selected to add the asset to your content.
Note
All media types have these version options except spinsets.
How version updates work
The Acquia DAM module checks for new asset versions approximately every hour.
If you selected Manually update, Drupal displays an alert on the content edit page when a new version of that asset exists in Acquia DAM.
On the edit page, select Update media to review.
Review the current media and the new version side by side.
Select Cancel to keep the existing media or Update to change the media to the new version.
Note
Drupal only detects a new version when it is uploaded to Acquia DAM. If you switch to a previous version in Acquia DAM, the asset in Drupal does not update and no alert appears.
To force Drupal to detect a switch to a previous version:
In Acquia DAM, access the Asset details page.
Select Switch Version, and then select a previous version of the asset.
Edit at least one metadata field.
Select Set Version as Finalized.
Drupal detects the metadata change as an update. After the next sync cycle of up to one hour, you should see the previous version of the asset reflected on the Drupal page if you chose automatic updates or as an available update if you choose manual updates.
DAM media report and manual sync in Drupal
The DAM media report in Drupal provides an overview of Acquia DAM assets that are in use on your site and their status.
To view the report:
In Drupal, go to Content > Media > Media library.
Click on the DAM media.
From this report, you can:
Manually synchronize asset information with Acquia DAM for specific assets or the entire list.
Identify which assets are in use across pages, articles, and other content types.
Identify expired or deleted assets.
Note
After a sync, it is not possible to revert the updated dates.
Work with deletions, expirations, and broken embeds
Asset deletions behave differently between systems:
If a user deletes an asset in Drupal, it is not deleted in Acquia DAM.
If an asset that is embedded on a Drupal page is deleted or expired in Acquia DAM:
A gray placeholder box replaces the asset on the Drupal page.
The module checks for deletions and expirations of assets approximately every hour.
You can check for expired or missing assets:
Across all Drupal pages with the DAM media report
While you work on the Drupal edit page:
Within the WYSIWYG editor
Within media fields or the Media Library
Track asset usage across systems
To identify where an asset is used across Drupal and other integrated applications:
In Acquia DAM, open the Asset Digest page.
Go to the Asset associations section.
Select Integration links.
Links appear in the list when the asset is inserted into Drupal content through:
The WYSIWYG editor
Media Library fields
Other media-enabled components
For more information about how assets are rendered and delivered in Drupal, including Embed (CDN delivery) and Download and sync (local file system) behavior, refer to How do I configure asset rendering in Acquia DAM?
How do I use the Acquia DAM module?
The 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 supports two delivery methods:
Embed codes: These serve assets through a CDN.
Download and sync: This method downloads assets to the Drupal local file system and serves them from there.
Before you begin
Ensure that the Acquia DAM module is in place and your Drupal site and users are authenticated. Verify the following:
The Acquia DAM module is installed and enabled on your Drupal site.
Your Drupal site is authenticated with your Acquia DAM account.
Your Drupal user account is authenticated with Acquia DAM.
If a user is not authenticated, they may not see any DAM assets in the Media Library or may receive permission errors. For details, refer to Authenticate a Drupal user with Acquia DAM.
Note
This integration uses version 3 (v3) embed links. If you currently use version 2 (v2) embeds, be aware of this difference before you proceed.
Using Acquia DAM assets in Drupal content
When you create content in Drupal, explore assets in Acquia DAM and add them to your pages through the Media Library.
In the content edit page, select Insert Media where you can select the media files or upload a new file.
In the Media Library, select DAM as the media source.
Select one of the media types, as per your requirement.
Refine your results by using search or category filters as configured in your DAM.
Select one or multiple assets to embed in the page, then select Next: Select Format.
Choose a format for your media. The selected asset is added to the Drupal page as an embed code so that it remains synchronized with Acquia DAM. For images, the maximum width and height is 2,048 x 2,048 px.
Under Version, choose one of these options:
Automatically update: Update automatically when assets are updated in Acquia DAM.
Manually update: Require a manual update when a new version becomes available.
Select Insert selected to add the asset to your content.
Note
All media types have these version options except spinsets.
How version updates work
The Acquia DAM module checks for new asset versions approximately every hour.
If you selected Manually update, Drupal displays an alert on the content edit page when a new version of that asset exists in Acquia DAM.
On the edit page, select Update media to review.
Review the current media and the new version side by side.
Select Cancel to keep the existing media or Update to change the media to the new version.
Note
Drupal only detects a new version when it is uploaded to Acquia DAM. If you switch to a previous version in Acquia DAM, the asset in Drupal does not update and no alert appears.
To force Drupal to detect a switch to a previous version:
In Acquia DAM, access the Asset details page.
Select Switch Version, and then select a previous version of the asset.
Edit at least one metadata field.
Select Set Version as Finalized.
Drupal detects the metadata change as an update. After the next sync cycle of up to one hour, you should see the previous version of the asset reflected on the Drupal page if you chose automatic updates or as an available update if you choose manual updates.
DAM media report and manual sync in Drupal
The DAM media report in Drupal provides an overview of Acquia DAM assets that are in use on your site and their status.
To view the report:
In Drupal, go to Content > Media > Media library.
Click on the DAM media.
From this report, you can:
Manually synchronize asset information with Acquia DAM for specific assets or the entire list.
Identify which assets are in use across pages, articles, and other content types.
Identify expired or deleted assets.
Note
After a sync, it is not possible to revert the updated dates.
Work with deletions, expirations, and broken embeds
Asset deletions behave differently between systems:
If a user deletes an asset in Drupal, it is not deleted in Acquia DAM.
If an asset that is embedded on a Drupal page is deleted or expired in Acquia DAM:
A gray placeholder box replaces the asset on the Drupal page.
The module checks for deletions and expirations of assets approximately every hour.
You can check for expired or missing assets:
Across all Drupal pages with the DAM media report
While you work on the Drupal edit page:
Within the WYSIWYG editor
Within media fields or the Media Library
Track asset usage across systems
To identify where an asset is used across Drupal and other integrated applications:
In Acquia DAM, open the Asset Digest page.
Go to the Asset associations section.
Select Integration links.
Links appear in the list when the asset is inserted into Drupal content through:
The WYSIWYG editor
Media Library fields
Other media-enabled components
For more information about how assets are rendered and delivered in Drupal, including Embed (CDN delivery) and Download and sync (local file system) behavior, refer to How do I configure asset rendering in Acquia DAM?
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Acquia DAM