--- title: "How do I use the register integration links feature for the Acquia DAM Module?" date: "2026-02-05T12:29:41+00:00" summary: image: type: "page" url: "/acquia-dam/how-do-i-use-register-integration-links-feature-acquia-dam-module" id: "a364bfd6-c5da-4fa6-84f0-35c02765bac2" --- 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 1. In the administrative menu, select **Configuration**. 2. Select **Acquia DAM** under **Media** to open the Acquia DAM configuration page. 3. Select the **Integration links** tab. 4. Review the status dashboard to check total assets, registered links, and remaining assets by media type. 5. Select the **Register Integration Links** to start the batch process. 6. Monitor the progress bar as the system: 1. Processes media entities 2. Processes content entities (Enhanced mode only) 3. Completes all registration operations 7. 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=] [--media-type=] [--process-limit=] 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. Command syntax: drush acquia-dam:queue-integration-links [--batch-size=] [--media-type=] Examples: drush acquia-dam:queue-integration-links drush acquia-dam:queue-integration-links --media-type=acquia_dam_video_asset #### 3\. Process the integration links queue Processes items already queued and provides controlled batch execution. Command syntax: drush acquia-dam:process-integration-links-queue [--process-limit=] Examples: drush acquia-dam:process-integration-links-queue drush acquia-dam:process-integration-links-queue --process-limit=100 Automated registration through Cron ----------------------------------- 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. **When to re-register:** * After you import new DAM assets in bulk. * After you enable Enhanced mode. * If you suspect tracking is incomplete. * After major content migrations. Troubleshooting --------------- **Issue** **Solution** "Queue is empty" but assets show as remaining Run the register integration links command:  drush acquia-dam:register-integration-links Processing is slow or times out Use smaller batch sizes:  drush acquia-dam:register-integration-links --batch-size=10 --process-limit=100 Enhanced mode not detecting content entities Clear cache:  drush cr Verify sub-module is enabled:  drush pm:list | grep integration. Re-run registration. Important notes --------------- **Automatic maintenance:** 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.