The register integration links features 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 locations where each asset is referenced. This simplifies asset use management, helps to identify dependencies, and ensures 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-register: Perform this after a major content migration or to enable Enhanced mode.
Troubleshoot: Run a one-time registration of existing assets or fix 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.
Feature comparison: Standard versus enhanced tracking
The level of tracking detail depends on your configuration. While the parent module enables the link, the Acquia DAM – Enhanced Integration Links submodule is required for deep-link visibility.
Feature
Acquia DAM parent module
Enhanced integration links submodule
Tracking level
Media Entity level
Content Entity level
What is tracked?
Tracks the Media item itself, such as /media/1/edit.
Tracks every specific page/node where that media is used.
Visibility
Shows that a Media entity exists in Drupal.
Shows every Node, Paragraph, or Block where the asset is embedded.
Best for
Basic asset inventory.
Comprehensive dependency mapping and audit trails.
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 to check total assets, registered links, and remaining assets by media type.
Select the Register Integration Links 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 to check 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.
Integration links are automatically registered when:
A new DAM asset is added to Drupal
An existing media entity is updated
Content entities are saved with DAM references (Enhanced mode)
The registration happens through Drupal's queue system. Cron processes the queue automatically with no manual action required for ongoing maintenance.
To manually trigger queue processing:
drush cron
Or process the specific queue:
drush queue:run acquia_dam_integration_links
Re-registering integration links
You can re-run the registration process at any time. The system automatically skips assets that already have registered links, which prevents duplicates.
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 features 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 locations where each asset is referenced. This simplifies asset use management, helps to identify dependencies, and ensures 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-register: Perform this after a major content migration or to enable Enhanced mode.
Troubleshoot: Run a one-time registration of existing assets or fix 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.
Feature comparison: Standard versus enhanced tracking
The level of tracking detail depends on your configuration. While the parent module enables the link, the Acquia DAM – Enhanced Integration Links submodule is required for deep-link visibility.
Feature
Acquia DAM parent module
Enhanced integration links submodule
Tracking level
Media Entity level
Content Entity level
What is tracked?
Tracks the Media item itself, such as /media/1/edit.
Tracks every specific page/node where that media is used.
Visibility
Shows that a Media entity exists in Drupal.
Shows every Node, Paragraph, or Block where the asset is embedded.
Best for
Basic asset inventory.
Comprehensive dependency mapping and audit trails.
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 to check total assets, registered links, and remaining assets by media type.
Select the Register Integration Links 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 to check 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.
Integration links are automatically registered when:
A new DAM asset is added to Drupal
An existing media entity is updated
Content entities are saved with DAM references (Enhanced mode)
The registration happens through Drupal's queue system. Cron processes the queue automatically with no manual action required for ongoing maintenance.
To manually trigger queue processing:
drush cron
Or process the specific queue:
drush queue:run acquia_dam_integration_links
Re-registering integration links
You can re-run the registration process at any time. The system automatically skips assets that already have registered links, which prevents duplicates.
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