# 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 > Management > Management Suite > Agents**.

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-70f9eeb3d55fc624f287a6e999a4fa8ed03fa5c4%2Fimporting-metadata_1.png?alt=media\&token=e213e20b-481a-4eff-ba91-df541207281d)
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).

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e3d9498dd873e83142c0215ca70d03a5ed6015f3%2Fimporting-metadata_2.png?alt=media\&token=d0fdd2f0-2886-450c-a6fc-152310046ca2)

   * 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.

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-23f1bc7cf72159650dd90bf6f52bcfc29a5180da%2Fimporting-metadata_3.png?alt=media\&token=7c6814cb-cf15-44d7-b52d-59da184b96b9)

   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.

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-410be5c11ccaf1efaabedda23e5bf4190eb2b61d%2Fimporting-metadata_4.png?alt=media\&token=892e756d-4439-4ea3-8568-2acf6c60df26)

   c. Save the amended file.