---
title: "Troubleshooting checklist"
date: "2026-03-19T12:23:18+00:00"
summary: "Fix Acquia DAM asset issues in Drupal with this troubleshooting checklist covering sync, bulk imports, rendering, and file system problems."
image:
type: "page"
url: "/acquia-dam/troubleshooting-checklist-0"
id: "d3773033-a12b-42f2-8a3a-10afa3184224"
---

Use this checklist if there are issues with Acquia DAM (Widen) assets in Drupal, for example, if they do not update, unpublish, render correctly, or are missing from bulk imports.

1.  **Assets in Drupal do not match changes in Acquia DAM (Widen) such as status, deletion, metadata, finalized version**
    
    *   Confirm that **Drupal cron** runs regularly.
        
    *   Check whether the **DAM media update queue** is backed up and, if needed, process it:
        
            drush queue:run acquia_dam_media_item_update
        
    *   If many assets appear out of sync, run a **bulk asset refresh**:
        
            drush acquia-dam:update-assets
        
    *   For finalized version changes, queue updates based on the latest finalized versions:
        
            drush acquia-dam:queue-update-assets --finalized-version
        
2.  **Pending Delete assets in Acquia DAM (Widen) still show as Published in Drupal**
    
    *   Verify that cron is running and the **DAM media update queue** has been processed.
        
    *   If needed, run:
        
            drush acquia-dam:update-assets
        
    *   For individual items, use **Check for update** on the DAM media listing in Drupal.
        
3.  **An asset does not render correctly or appears under the wrong media type**
    
    *   Check if the Drupal **media type** matches the actual asset format in Acquia DAM (Widen) such as image, video, document, archive, and so on.
        
    *   If it looks too generic or incorrect, run:
        
            drush acquia-dam:resolve-asset-media-type 
        
        optionally with `--media-type` and `--batch-size`.
        
    *   For SVGs, install and configure the contributed SVG Image module so that SVGs can use image styles.
        
4.  **Bulk import misses some expected assets**
    *   Confirm that assets are assigned to the categories or asset groups you configured for import.
    *   Imports run in batches through cron, not all assets appear in a single run.
    *   Check that assets are released and not expired in Acquia DAM (Widen), unreleased or expired assets are intentionally skipped by the bulk import.
5.  **Assets are not provided from the expected domain or file system**
    
    *   Check whether _Download and sync_ assets are enabled, if so, assets are provided from the Drupal file system.
        
    *   Confirm that you chose the correct public or private file system before you enable _Download and sync_, and avoid switching afterward.