> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/connected-devices/usage-guides/importing-metadata.md).

# Importing Metadata

This guide shows you how to attach custom metadata to individual agents via a CSV import. You can use extended metadata to provide a richer analytics experience, allowing for deeper reporting through enhanced filtering options.

## Metadata via CSV Import

1. Navigate to **Connected Devices > Settings > Agent Settings > Agents**.

   ![](/files/iHVVolgsZP2rVytxZRoa)
2. Click **Upload metadata** in the top right of your screen.
3. In the resulting popup, use the **Choose file** button to navigate to your saved CSV file (see step 5, below, if you do not have a compatible CSV file).

   ![](/files/DqtsV4XFHpi0JrbeaF6A)

   * Your CSV file must include the required fields, which are:
     * Unique ID
     * Isp
     * Package
     * Timezone
     * Country
4. Click **Upload**.
5. \[Optional] If you do not have a compatible CSV file with the required fields, click **Download export** from the **Agents** tab.

   ![](/files/eDwEH65rAHLccYJ0Kbcx)

   a. Select **Agent metadata**.

   b. With this file, you can add, remove, or change any metadata fields, except for the required ones, to suit your needs.

   ![](/files/MbsOdRkbrDJOCl9w0G3K)

   c. Save the amended file.