The register integration links feature in Acquia DAM enables you to track where DAM assets are used throughout your Drupal website. When you register integration links, Acquia DAM displays all the locations where each asset is referenced, making it easier to manage asset usage, identify dependencies, and ensure content consistency.
Note
The Acquia DAM module automatically registers integration links whenever a new DAM asset is added. The commands and user interface steps detailed in this document are primarily for:
Re-registration: After a major content migration or enabling Enhanced mode.
Troubleshooting: Running a one-time registration of existing assets or fixing instances where an expected link is missing.
For ongoing maintenance, manual action is not required.
Prerequisites
In your Drupal application:
Confirm that the Acquia DAM module version 1.1.11+ is enabled.
Confirm that you have administrative access to the Drupal site.
Verify that your site is authenticated with Acquia DAM.
(Optional) Enable the Acquia DAM - Enhanced integration links sub-module for enhanced tracking of content entity references.
Tracking modes: Basic vs. Enhanced
Registration operates in two modes depending on which sub-modules you enable:
Mode
Sub-module
Tracking Scope
Basic
Disabled
Direct media entities only
Enhanced
Acquia DAM - Enhanced integration links
Media entities and content entities (nodes, taxonomy terms, paragraphs, etc.)
Register integration links
Through the admin user interface
In the administrative menu, select Configuration.
Select Acquia DAM under Media to open the Acquia DAM configuration page.
Select the Integration links tab.
Review the status dashboard showing total assets, registered links, and remaining assets by media type.
Click the Register Integration Links button to start the batch process.
Monitor the progress bar as the system:
Processes media entities
Processes content entities (Enhanced mode only)
Completes all registration operations
Review the completion summary showing media items queued, content entity references queued, and queue items processed.
Through the Command-Line interface (Drush)
The feature supports three Drush commands for different workflows:
1. Register integration links (All-in-One)
Performs the complete workflow: queues assets and processes them immediately.
Command syntax:
drush acquia-dam:register-integration-links [--batch-size=<number>] [--media-type=<type>] [--process-limit=<number>]
Options:
--batch-size: Number of assets to process per batch. Default: 50.
--media-type: Process only a specific media type.
--process-limit: Maximum queue items to process. Default: 0 (no limit).
Examples:
drush acquia-dam:register-integration-links
drush acquia-dam:register-integration-links --batch-size=100
drush acquia-dam:register-integration-links --media-type=acquia_dam_image_asset
Recommended Usage:
Ideal for small to medium datasets or manual one-time operations.
2. Queue integration links
Discovers assets and adds them to the queue without processing. Useful for large datasets or decoupled workflows.
Cron handles ongoing registration automatically. New or updated assets are queued and processed during scheduled Cron jobs without configuration changes.
Large sites:
For sites with many assets, use the decoupled workflow: queue assets first with queue-integration-links, then process in controlled batches with process-integration-links-queue. Schedule large operations during off-hours to minimize performance impact.
Enhanced mode:
Enable the Enhanced integration links sub-module early in your implementation for complete tracking. After you enable it, re-run the registration to catch existing content entity references.
How do I use the register integration links feature?
The register integration links feature in Acquia DAM enables you to track where DAM assets are used throughout your Drupal website. When you register integration links, Acquia DAM displays all the locations where each asset is referenced, making it easier to manage asset usage, identify dependencies, and ensure content consistency.
Note
The Acquia DAM module automatically registers integration links whenever a new DAM asset is added. The commands and user interface steps detailed in this document are primarily for:
Re-registration: After a major content migration or enabling Enhanced mode.
Troubleshooting: Running a one-time registration of existing assets or fixing instances where an expected link is missing.
For ongoing maintenance, manual action is not required.
Prerequisites
In your Drupal application:
Confirm that the Acquia DAM module version 1.1.11+ is enabled.
Confirm that you have administrative access to the Drupal site.
Verify that your site is authenticated with Acquia DAM.
(Optional) Enable the Acquia DAM - Enhanced integration links sub-module for enhanced tracking of content entity references.
Tracking modes: Basic vs. Enhanced
Registration operates in two modes depending on which sub-modules you enable:
Mode
Sub-module
Tracking Scope
Basic
Disabled
Direct media entities only
Enhanced
Acquia DAM - Enhanced integration links
Media entities and content entities (nodes, taxonomy terms, paragraphs, etc.)
Register integration links
Through the admin user interface
In the administrative menu, select Configuration.
Select Acquia DAM under Media to open the Acquia DAM configuration page.
Select the Integration links tab.
Review the status dashboard showing total assets, registered links, and remaining assets by media type.
Click the Register Integration Links button to start the batch process.
Monitor the progress bar as the system:
Processes media entities
Processes content entities (Enhanced mode only)
Completes all registration operations
Review the completion summary showing media items queued, content entity references queued, and queue items processed.
Through the Command-Line interface (Drush)
The feature supports three Drush commands for different workflows:
1. Register integration links (All-in-One)
Performs the complete workflow: queues assets and processes them immediately.
Command syntax:
drush acquia-dam:register-integration-links [--batch-size=<number>] [--media-type=<type>] [--process-limit=<number>]
Options:
--batch-size: Number of assets to process per batch. Default: 50.
--media-type: Process only a specific media type.
--process-limit: Maximum queue items to process. Default: 0 (no limit).
Examples:
drush acquia-dam:register-integration-links
drush acquia-dam:register-integration-links --batch-size=100
drush acquia-dam:register-integration-links --media-type=acquia_dam_image_asset
Recommended Usage:
Ideal for small to medium datasets or manual one-time operations.
2. Queue integration links
Discovers assets and adds them to the queue without processing. Useful for large datasets or decoupled workflows.
Cron handles ongoing registration automatically. New or updated assets are queued and processed during scheduled Cron jobs without configuration changes.
Large sites:
For sites with many assets, use the decoupled workflow: queue assets first with queue-integration-links, then process in controlled batches with process-integration-links-queue. Schedule large operations during off-hours to minimize performance impact.
Enhanced mode:
Enable the Enhanced integration links sub-module early in your implementation for complete tracking. After you enable it, re-run the registration to catch existing content entity references.
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