> 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/~/changes/eaCuYFhybbREuBouwZp6/upload/uploading-new-assets.md).

# Uploading New Assets

To upload Assets to HIVO, a user will need to be Active and have the light user right "Can Upload Assets" turned on.

The uploading process is comprised of 3 steps:

1. Add Assets - Selecting assets, managing upload duplicates and renaming filenames.
2. Tagging Assets - Adding manual asset tags.
3. Asset Details - Adding additional information (e.g. copyright, license and other metadata), assigning permissions, running automations etc.

## Step 1: Add Assets

On the 'Add Assets' step, you can either drag files/folders onto the browser, or click the respective **"Add Files" or "Add Folder"** button. If you are uploading a folder, **the folder structure will be retained** within HIVO, unless you deliberately set a new path during the '[Asset Details](#step-3-asset-details)' step.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FeIknyTAxmBMpy7CElC3v%2FGroup%20672%20(1).png?alt=media&amp;token=c87c2bb2-7a13-49ae-96f7-9622f6bf871e" alt=""><figcaption><p>Add Assets</p></figcaption></figure>

### View Duplicates Deteced During Upload

* You may have duplicate files detected when selecting assets that already exist in your Library. If this happens, you can click the '**View Duplicates' button** that will appear to see the asset comparisons, and optionally discard them from the 'Add Assets' selection.
* Duplicates are detected by comparing attributes such as file name, size etc. There is a chance that a duplicate found could be a false positive and be different.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FD7PbshCwN2WcCJNgaKex%2FGroup%20669%20(1).png?alt=media&amp;token=6f69d237-d5bb-4313-86eb-e6ae7ea6a9d2" alt=""><figcaption><p>View Duplicates </p></figcaption></figure>

### Renaming Assets During Upload

During the Add Assets step you can also bulk rename filenames of assets, which can help with maintaining a consistent filename convention accross your asset names and help improve your search results. You can also rename individual assets by entering the name directly in the 'Name' section corresponding to that Asset.

\*Note: Default filename conventions can also be set for the account in Client Profile > Settings > File Name Settings.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FLmYAQLm0n7W8Vr7hthQ2%2FGroup%20676%20(1).png?alt=media&amp;token=3e52c4af-a601-434e-841b-09c931c6bfb6" alt=""><figcaption><p>Renaming Asset on Upload</p></figcaption></figure>

***

## Step 2: Tag Assets

After selecting Assets to upload to the Library, click 'Next'. The next step is 'Tag Assets', where you can add labels to all selected Assets.

Labels help you organize data more effectively, such as adding labels by event name or Property department.  Adding as many related labels as possible will make it easier for you to search for Assets by those label values ​​later, see more '[Tagging Asset](https://support.hivo.co/~/changes/eaCuYFhybbREuBouwZp6/assets/tagging-assets)'.&#x20;

### How to add tags?

* You can choose from the list of tags pre-configured by Admin or enter directly in the '**Your Tags**' free text field.&#x20;
* An asset can have multiple tags.
* Click the question mark (?) icon in the top right corner to learn more about adding tags, including how to only tag a selection of Assets.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Ffcc9A3GbED4qDM5GH1Uw%2FGroup%20669%20(2).png?alt=media&amp;token=1c5cee91-1c54-48bb-8bd6-13d0ed83f9a7" alt=""><figcaption><p>Tagging Assets</p></figcaption></figure>

Admin users can customize the default available manual tags in the [Uploader Settings](https://support.hivo.co/~/changes/eaCuYFhybbREuBouwZp6/client-profile/client-profile-settings/uploader-settings) (Client Profile => Settings => [Uploader Settings](/~/changes/eaCuYFhybbREuBouwZp6/client-profile/client-profile-settings/uploader-settings.md)).&#x20;

***

## Step 3: Asset Details

The next step of the uploading process is to add additional information to the Asset selection.

{% hint style="info" %}
Note: *These settings **will apply to all of the selected assets**. Be sure to enter as much detail in the Asset Information section as possible, as the more granular you are with your Asset information, the easier it will be to find the Assets you are uploading at a later date.*
{% endhint %}

👉 It’s recommended to leave the ‘Create Thumbnail’ and ‘Create Web Version’ automation options ticked on.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FRmQ73fuxuDGrsPPWWmNf%2FGroup%20677.png?alt=media&amp;token=d0389567-0354-4a8e-9d42-965520b5c89e" alt=""><figcaption><p>Asset Detail Page</p></figcaption></figure>

There’s a number of input fields here:

<table><thead><tr><th width="169">Types</th><th>Discription</th></tr></thead><tbody><tr><td><strong>Description</strong></td><td>A short description for the Assets. This will be added to each Asset’s metadata.</td></tr><tr><td><strong>Copyright</strong></td><td>Add property owner. This will be added to each Asset’s metadata.</td></tr><tr><td><strong>License</strong></td><td>What is the license for the Assets? This will be added to each Asset’s metadata.</td></tr><tr><td><strong>License Expiry Date</strong></td><td>Optionally set a Date on which the Asset's license will Expire.</td></tr><tr><td><strong>Attached Asset</strong></td><td>Select a related Asset such as a release form. You will be able to see related assets under the ‘Related’ section of the Asset Detail page. The ‘+’ icon on the selector will allow you to attach a new asset that doesn't exist on HIVO.</td></tr><tr><td><strong>Task</strong></td><td>Add the Assets to a given Task.</td></tr><tr><td><strong>Collections</strong></td><td>Add the Assets to a given Collection.</td></tr><tr><td><strong>Folder Path</strong></td><td>Enter in a new folder path for the Assets. This will overwrite any existing folder structures on the Assets if set.</td></tr><tr><td><strong>Production Date</strong></td><td>Optionally add when the Asset was created. You will be able to search for these Assets by production time range in the Library and elsewhere if this has been set.</td></tr><tr><td><strong>Location</strong></td><td>Add a location for where the Assets were created (which later can be searched by).</td></tr><tr><td><strong>Permissions</strong></td><td>Assign permissions to Users for the Asset selection.</td></tr><tr><td><strong>Archive Date</strong></td><td>Set a date at which the Assets will automatically expire and become archived.</td></tr><tr><td><strong>Sensitive</strong> </td><td>Mark the Assets as being sensitive.</td></tr><tr><td><strong>Asset Approval</strong></td><td>Optionally set an Approval Request form. Asset Approval(s) will be launched based on this form after the Asset(s) are successfully uploaded, see more <a href="https://support.hivo.co/~/changes/eaCuYFhybbREuBouwZp6/approvals/asset-approvals">Asset Approval.</a></td></tr></tbody></table>

### Automations

The Automation section in HIVO automatically performs tasks on your assets when you upload them, saving you time and effort.&#x20;

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FcxgcNuCUaKZCxtvprax0%2FGroup%20677%20(1).png?alt=media&amp;token=0eae6e55-9ea1-4bb7-a23d-f067809b70ab" alt=""><figcaption><p>Additional Automations</p></figcaption></figure>

Specifically, the automation tasks are as follows:

<table><thead><tr><th width="171">Types</th><th>Discription</th></tr></thead><tbody><tr><td><strong>Tag Prediction</strong></td><td>Automatic tags will be added to the Assets, see more '<a href="https://support.hivo.co/assets/tagging-assets">Tagging Asset</a>'.</td></tr><tr><td><strong>Face Detection</strong></td><td>Automatically detect faces appearing in assets, see more '<a href="https://support.hivo.co/recognition">Recognition</a>'.</td></tr><tr><td><strong>Image Caption Prediction</strong></td><td>This feature allows you to generate captions for images automatically.</td></tr><tr><td><strong>Create Thumbnail</strong> </td><td>A ‘thumbnail’ version will be added to each asset. This version is a 450x450 .jpeg with a small (~15kb) file size, which will be used as a small preview within HIVO (e.g. in the Library).</td></tr><tr><td><strong>Create Web Version</strong></td><td>A ‘web’ version will be added to image Assets. This version will retain the image aspect ratio, but be scaled down to have a maximum width/height of 2048px in order to reduce the file size and load faster.</td></tr><tr><td><strong>Create Watermark Version</strong></td><td>See more '<a href="https://support.hivo.co/client-profile/client-profile-settings/watermark-settings">Watermarking</a>'</td></tr><tr><td><strong>Create "square" Version</strong></td><td>A 'square' version will be added to image assets.  This version is a size of 1048px.</td></tr><tr><td>Create "edm header" Version</td><td>A 'edm header' version will be added to image assets.  This version is a size of 800x200 .jpeg.</td></tr><tr><td><strong>Create Custom</strong></td><td>For image Assets, create a ‘custom’ version. Clicking the checkbox will open a list of properties for this version, such as the image type or height/width.</td></tr><tr><td><strong>Skip Approval Step for Uploads</strong></td><td>Only for users with approval rights or users in a group that allows skipping approval of uploaded assets, see more '<a href="https://support.hivo.co/">Upload Approval</a>'.</td></tr></tbody></table>

Admins can add additional metadata fields and set the default value given to the permissions field by going to the Client Profile => settings tab => uploader settings.

Note: The '[Blacklisted Tags](https://support.hivo.co/~/changes/eaCuYFhybbREuBouwZp6/client-profile/client-profile-settings/blacklist-settings)' setting is a way to prevent specific listed auto tags ​​from being automatically added to asset tags. Use automation


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.hivo.co/~/changes/eaCuYFhybbREuBouwZp6/upload/uploading-new-assets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
