Display custom metadata fields from Acquia DAM (Widen) in your Drupal asset library view.

About this feature

The asset library view displays assets from Acquia DAM (Widen) in a grid layout. By default, the view displays thumbnails and filenames. You can add any metadata field from your Acquia DAM (Widen) instance, such as descriptions, keywords, owner information, or custom fields, to display with each asset.

Use this feature to:

• Display asset descriptions for additional context.
• Display keywords or tags for faster browsing.
• Display owner or author information.
• Display custom metadata fields specific to your organization.

Before you begin

Ensure that you have the following prerequisites configured:

• Permission to administer views.
• Metadata fields configured in your Acquia DAM instance.

Add a metadata field to the asset library

To add a metadata field to the view:

1. In the Drupal administrative menu, go to Structure > Views > Acquia DAM Asset Library > Edit.
2. Select the display where you want to add the field:
   • For the media browser widget: Widget table
   • For the page display: Page
3. In the Fields section, click Add.
4. In the Add fields dialog, search for DAM Metadata Field and select it.
5. Click Add and configure field.
6. In the field configuration window, configure the following settings:
   • Label: Enter a label or leave this field empty to hide the label.
   • Display Keys: Select the metadata field that you want to display.
   • Field formatting.
7. Click Apply.
8. Click Save to save the view.

The metadata field now appears under each asset thumbnail in the grid layout.

Add multiple metadata fields

Following is the example of how to add the DAM Metadata field multiple times with different configurations.

1. Add DAM Metadata Field:
   • Display Keys: description
   • Maximum length: 200
   • Trim to word boundary: Selected
2. Add DAM Metadata Field again:
   • Display Keys: keywords
   • Array separator: ,
   • Limit number of values: 10
3. Add DAM Metadata Field a third time:
   • Display Keys: owner

Each field displays independently with its own formatting settings.

Hide empty fields

By default, metadata fields are hidden when they contain no value. To change this behavior:

1. Edit the metadata field in the view.
2. Expand No results behavior.
3. Clear the Hide if empty checkbox.
4. Optional: In No results text, enter the text to display when the field is empty.
5. Select Apply.
6. Select Save to save the view.

Available metadata fields

The available metadata fields depend on your Acquia DAM configuration. If a required field does not appear in the list, ensure that the field is configured in your Acquia DAM instance.

Troubleshooting

Metadata field does not display

Problem: The field appears in the Views administrative interface, but does not display values in the asset library.

Solution:

• Ensure that the field contains values in your Acquia DAM instance.
• Ensure that the field is included in the asset metadata.
• Ensure that Hide if empty is cleared if you want to display the field label or fallback text when empty.

Field is truncated or overlaps

Problem: Metadata text is truncated unexpectedly or overlaps with other elements.

Solution:

• The field displays a maximum of three lines by default.
• Use the Maximum length setting to control text length.
• For long text strings, select Trim to word boundary for clean word truncation.

New metadata fields do not appear in the list

Problem: You added new metadata fields to your Acquia DAM instance, but they do not appear in Drupal. Metadata field discovery is cached for 24 hours to minimize API calls.

Solution:

• Clear the Drupal cache by going to Configuration > Development > Performance > Clear all caches.
• Alternatively, rebuild the cache through Drush:

drush cache:rebuild

The new fields appear in the list after you clear the cache.

Acquia DAM metadata fields in the asset library view

drush cache:rebuild