--- title: "How do I use the register integration links feature?" date: "2026-02-05T12:29:41+00:00" summary: image: type: "page" url: "/acquia-dam/how-do-i-use-register-integration-links-feature" id: "a364bfd6-c5da-4fa6-84f0-35c02765bac2" --- 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=] [--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, providing 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 via 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, preventing 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.