> For the complete documentation index, see [llms.txt](https://support.hivo.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.hivo.co/assets/asset-metadata.md).

# Asset Metadata

Metadata is optional information that may be attached to Assets.

### What is the Metadata Feature in HIVO?

Metadata in HIVO allows you to attach optional additional information to Assets, providing more detailed descriptions that go beyond basic attributes like Name, Tag, or Collection.

* **Structure**: Metadata consists of key-value pairs (e.g., Author: John Doe).
* **Searchability**: You can use Metadata to search for Assets in HIVO's library search.

Viewing Metadata on the Asset Preview and Asset Detail Page (Note: Metadata is only displayed if it has been filled in).

* [**Asset Detail Page**](https://support.hivo.co/assets/asset-detail-page): You can also view metadata on the Asset Detail page.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fhsr7NmrJ8ulZqW8shX4A%2FGroup%20729.png?alt=media&amp;token=ad358118-9089-4e59-ad67-d1bc1f815e34" alt=""><figcaption><p>View Metadata in Asset Detail Page</p></figcaption></figure>

* [**Asset Preview**](https://support.hivo.co/assets/asset-preview-page): You can view metadata directly in the preview view.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fbo32oFnTA7OxnKWbDoeK%2FGroup%20734.png?alt=media&amp;token=f60176df-7cc1-49c4-a1c5-3457a6d03a83" alt=""><figcaption><p>View Metadata in Asset Preview</p></figcaption></figure>

### How to use & setting Metadata

#### 2.1. How to Edit Metadata on the Asset Detail Page

* **Navigate to the Asset Details Page**: Click on the Metadata section.
* **Add Metadata**:
  * Use the 'Add Entry' button to select from default metadata fields that are configured in the account.
  * Use the 'Custom Entry' button to input any custom desired metadata field and information.
* **Save Changes**: Click 'Submit' to save your changes.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FGwgTzONYoV2HZHqrb52Z%2Fedit%20metadata.gif?alt=media&amp;token=90311bde-5548-416c-801c-96626e10218f" alt=""><figcaption><p>Edit Metadata</p></figcaption></figure>

#### 2.2. Setting Metadata for a whole folder

You can set Metadata on all Assets in a folder through **Folder Actions -> Edit Metadata**.&#x20;

* Tick **"Also set this Metadata on Assets added to this folder later"** to also set it on Assets uploaded or moved into the folder in future.&#x20;
* Folder Metadata never overwrites a value an Asset already has. See [**Folder Actions**](https://support.hivo.co/library/folder-management-tools/folder-actions.md#can-a-folder-add-tags-and-metadata-to-assets-added-to-it-later)**.**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FjNV03AQXNLpYqZEuFn0w%2FGroup%201152.png?alt=media&amp;token=6577fa93-16fb-4889-a98f-5c345ececdde" alt=""><figcaption></figcaption></figure>

#### 2.3. Setting for Downloading Assets with Original Metadata or HIVO Metadata

Admin accounts can configure the account to ensure Assets are downloaded with HIVO metadata (this is metadata that gets created and added when assets are in HIVO, as opposed to metadata that exists on the Assets before they are uploaded. eg. data generated from a camera or editing software). If this option is selected this will download a version of the Asset with some of it's metadata replaced with metadata values created in HIVO.

In the Client Profile, go to **Settings** -> **Upload/Download Settings** -> **Toggle 'Users can download Assets with HIVO metadata' ON:**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FBJMUu6aMI1oBcStwrNMO%2FGroup%20733.png?alt=media&amp;token=81152dad-f46b-4d73-b4d3-4878d5b5c560" alt=""><figcaption><p>Metadata Settings</p></figcaption></figure>

#### 2.4. Warn Users Before Downloading Assets

Admin accounts can set up warnings for users when downloading Assets that contain specific metadata fields, such as copyright, description, or license information. When a user goes to download an asset that has one of these fields, a warning dialogue will pop up asking the user to confirm and accept the relevant metadata fields:

* In the Client Profile, go to **Settings** -> **Upload/Download Settings** -> **Toggle 'Warn Users before downloading Assets ON'.**
* Then enter the metadata field names that you would like to display a warning for when there is an entry in one of the fields or leave blank to use the default fields (copyright / license / usage):

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F3sRryLs40KBGaUtGu56z%2FScreenshot%202024-07-24%20at%2010.15.18%E2%80%AFPM.png?alt=media&amp;token=2e664b3e-a397-4f2f-9b4d-0b31707bf361" alt=""><figcaption></figcaption></figure>

If you have any questions, don't hesitate to ask, we're always here to help!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.hivo.co/assets/asset-metadata.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
