---
title: "Auditing Acquia DAM metadata fields and schema mappings"
date: "2026-08-12T08:43:05+00:00"
summary: "Audit your Acquia DAM metadata schema with ease—export field names, API keys, and taxonomy to CSV for fast analysis."
image:
type: "page"
url: "/acquia-dam/auditing-acquia-dam-metadata-fields-and-schema-mappings"
id: "0a681e6e-4881-4806-9b58-7de1d871d5a4"
---

Administrators often need a comprehensive view of their DAM metadata architecture that includes field names, API keys, controlled vocabulary options, and assigned metadata types. The Acquia DAM Metadata Schema Auditor is a client-side utility designed to export and inspect your site's complete metadata taxonomy directly within your browser.

### Security and privacy

The Metadata Schema Auditor runs locally on your machine.

*   No external data transmission: The tool routes all network requests directly between your browser and your Acquia DAM instance API endpoints ([api.widencollective.com](http://api.widencollective.com/ "http://api.widencollective.com")).
    
*   Zero server storage: Your bearer token and metadata details are never sent to external servers or logged by third parties.
    
*   Session isolation: Refresh or close the browser window to clear your session data.
    

### Prerequisites

Before you run the Metadata Schema Auditor, obtain an API bearer token with permission to view metadata settings. If you need to create a token, follow the step-by-step instructions in [Generate the API access token](/acquia-dam/generate-api-access-token "https://community.acquia.com/acquiadam/s/article/Generate-the-API-access-token").

### How to use the Metadata Schema Auditor

#### 1\. Launch the tool

Open the [Metadata Structure Report](https://acquia.widen.net/content/xg2o6ss4gn/original/Metadata-Structure-Report.html?u=l4iftr&download=true "https://acquia.widencollective.com/details/asset/xg2o6ss4gn") in Acquia DAM to access the tool. Download the `Metadata Structure Report.html` file to your computer, then double-click the file to open it in a modern web browser such as Chrome, Firefox, Safari, or Edge.

#### 2\. Enter your API bearer token

1.  Locate the Bearer Token field.
    
2.  Paste your Acquia DAM v2 API Token.
    
3.  Select **Generate Report**.
    

Note

If you encounter a 401 or 403 error after you select **Generate Report**, verify that your API token is active and that it includes read permissions for system metadata settings.

The tool queries the `v2/metadata/fields/viewable` endpoint and sequentially builds controlled vocabulary lists for selection fields. The tool displays progress in real time in the status area.

    Querying viewable structural metadata...
    Resolving vocabulary sets: 4 of 28 (Asset Category)...

### Understanding the audit report

Once processing finishes, an interactive table displays your metadata schema:

Column name

Description

Metadata Field Name

The user-facing display label of the field in your DAM.

Metadata Field Key

The unique system/API key associated with the field.

Metadata Field Values

Populated values for controlled lists (selection\_list, checkboxes), or the field input type. Examples include Open text, Numeric, and Date.

Metadata Types Contained In

Lists all DAM Metadata Types where this field is currently active.

### Exporting your taxonomy

To analyze your schema in Microsoft Excel, Google Sheets, or a data warehouse, select **Download Schema CSV**.

The resulting dam\_metadata\_taxonomy\_report.csv file uses UTF-8 encoding to preserve special characters and formats multi-value cells using semicolons as delimiters for standard data parsing.