Use metadata configuration to control which Acquia DAM metadata fields are available in Drupal and how they map to fields on your DAM-backed media types. This lets you display key metadata such as keywords, descriptions, usage rights, product codes, and other custom fields directly in Drupal.
Selecting metadata fields
First, select which metadata fields from Acquia DAM you want to make available to Drupal. These fields are then mapped to your Drupal media types that use Acquia DAM for integration.
To select metadata fields:
These selected fields are available for mapping on your DAM‑backed media types.
Mapping metadata fields to media types
After you select which DAM metadata fields are available, map them to specific fields on the Drupal media types that use the Acquia DAM media source.
To map fields:
- In the administrative menu, go to Structure > Media types such as
/admin/structure/media - For each media type that sources assets from Acquia DAM, such as Acquia DAM: Image, Acquia DAM: Video, select Edit.
Step 3: Create fields in Drupal (if needed)
To map DAM metadata to Drupal, you must have corresponding fields on the media type.
- Select the Manage fields for the media type.
- Select + Create a new field.
- Select Add field to create a new field or reuse an existing field for each DAM metadata value you want to store. For examples:
- A plain text field for a short title.
- A long text field for a description.
- A list or taxonomy reference for categories or tags.
- In the Label field, enter a clear name for the metadata field and select Continue.
- On the next page, configure the basic field settings as required, such as the allowed number of values.
- Configure the field settings as required and select Save.
- Repeat these steps for each Drupal field you need for DAM metadata.
Step 4: Map DAM fields to Drupal fields
- After you create the necessary fields, return to the Edit tab for the media type.
- In the Map Fields section:
- For each DAM metadata field, select the corresponding Drupal mapped field from the dropdown.
- Select Save to store the mapping.
Once saved, DAM metadata are populated into the mapped Drupal fields when assets are synchronized or imported from Acquia DAM.
Verifying metadata mappings
To confirm that metadata mapping is working as expected:
- In Drupal, go to Content > Media > DAM media.
- Locate an asset that has been synchronized from Acquia DAM and select Edit.
- Verify that:
- The mapped Drupal fields display the expected DAM metadata values.
- Updates to metadata in Acquia DAM are reflected in Drupal after synchronization or queue processing.
If metadata does not appear:
- Confirm that the DAM field is selected on the Metadata tab at
/admin/config/acquia-dam. - Confirm that a Drupal field exists on the media type and is mapped correctly in Map Fields.
- Ensure that the asset has those metadata values populated in Acquia DAM.
Metadata configuration
Use metadata configuration to control which Acquia DAM metadata fields are available in Drupal and how they map to fields on your DAM-backed media types. This lets you display key metadata such as keywords, descriptions, usage rights, product codes, and other custom fields directly in Drupal.
Selecting metadata fields
First, select which metadata fields from Acquia DAM you want to make available to Drupal. These fields are then mapped to your Drupal media types that use Acquia DAM for integration.
To select metadata fields:
These selected fields are available for mapping on your DAM‑backed media types.
Mapping metadata fields to media types
After you select which DAM metadata fields are available, map them to specific fields on the Drupal media types that use the Acquia DAM media source.
To map fields:
- In the administrative menu, go to Structure > Media types such as
/admin/structure/media - For each media type that sources assets from Acquia DAM, such as Acquia DAM: Image, Acquia DAM: Video, select Edit.
Step 3: Create fields in Drupal (if needed)
To map DAM metadata to Drupal, you must have corresponding fields on the media type.
- Select the Manage fields for the media type.
- Select + Create a new field.
- Select Add field to create a new field or reuse an existing field for each DAM metadata value you want to store. For examples:
- A plain text field for a short title.
- A long text field for a description.
- A list or taxonomy reference for categories or tags.
- In the Label field, enter a clear name for the metadata field and select Continue.
- On the next page, configure the basic field settings as required, such as the allowed number of values.
- Configure the field settings as required and select Save.
- Repeat these steps for each Drupal field you need for DAM metadata.
Step 4: Map DAM fields to Drupal fields
- After you create the necessary fields, return to the Edit tab for the media type.
- In the Map Fields section:
- For each DAM metadata field, select the corresponding Drupal mapped field from the dropdown.
- Select Save to store the mapping.
Once saved, DAM metadata are populated into the mapped Drupal fields when assets are synchronized or imported from Acquia DAM.
Verifying metadata mappings
To confirm that metadata mapping is working as expected:
- In Drupal, go to Content > Media > DAM media.
- Locate an asset that has been synchronized from Acquia DAM and select Edit.
- Verify that:
- The mapped Drupal fields display the expected DAM metadata values.
- Updates to metadata in Acquia DAM are reflected in Drupal after synchronization or queue processing.
If metadata does not appear:
- Confirm that the DAM field is selected on the Metadata tab at
/admin/config/acquia-dam. - Confirm that a Drupal field exists on the media type and is mapped correctly in Map Fields.
- Ensure that the asset has those metadata values populated in Acquia DAM.