> 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/upload-links.md).

# Upload Links

Upload Links allow external non-HIVO users to upload to your Library under restricted conditions. Only users with the appropriate permissions can create or modify them.

## **Overview of Upload Links**

The Upload Links feature in HIVO enables external users to upload assets directly into a library under predefined settings. Users with the **Can Create/Update/Delete Upload Links** permission can configure these links with specific conditions, such as:

* Expiration dates
* Maximum upload limits
* Approval requirements
* Set who will receive notifications
* A custom header for the upload receipt email sent to guests

By setting these conditions, you ensure that uploaded content aligns with the library’s standards and security requirements.

👉 For the guest's side of the process, see [**How to add assets to a Library via Upload link**](https://support.hivo.co/assets/how-to-add-assets-to-a-library-via-upload-link.md)**.**

## How can you create upload links

Upload Links can currently be found in the following areas: Library, Collection and Task.

#### **🔹** Method 1: Creating an Upload Link from the Library

* In the **Library** by clicking the cloud icon in the top right. Click **Add Assets** > **Create Upload Link**.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FUucOfZrgIO5p5E6QaQxM%2FGroup%20770.png?alt=media&amp;token=ad2b917a-0479-4cc8-a49c-6eda4a077599" alt=""><figcaption><p>Create Upload link from Library</p></figcaption></figure>

#### **🔹 Method 2:** Creating an Upload Link from the Collection

* In a **Collection** **detail page** using the create upload link icon seen below. This will pre-fill the Asset Settings step with the Collection pre-selected.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FE2Vqs5mWXYNlcYz5G2uA%2FGroup%20778.png?alt=media&amp;token=f43aed85-22f5-46d9-b4b3-858e89ecd8da" alt=""><figcaption><p>Create Upload link from Collection</p></figcaption></figure>

* Or Go to Collections -> Click the **three-dot menu** at the bottom corner of the desired collection card to open the **Collection Menu** -> Select **Create Upload Link**.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FEQFi5CV7bfVwsEeLI3cw%2FGroup%20980%20(1).png?alt=media&amp;token=aa0bf9e0-af9d-4e01-9bb2-6e26575f20d0" alt=""><figcaption></figcaption></figure>

#### **🔹** Method 3: Creating an Upload Link from the Task

In a **Task** by clicking the create upload link at the bottom of the Task. This will pre-fill the Asset Settings step in the Upload Link settings with the Task pre-selected.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F82sVMfKxTyj6BQ0a8Ujt%2FGroup%20779.png?alt=media&amp;token=17121795-f073-4485-8730-02ef1785c418" alt=""><figcaption><p>Create Upload link from Task Page</p></figcaption></figure>

## How to set up Asset upload link

### **🔹** Step 1: Link Settings

* **Expiration date:** Like [Shared Links](https://support.hivo.co/assets/sharing-assets) (used to share Assets outside of HIVO), Upload Links have an expiration date. Pick a date or use a quick option: **Tomorrow**, **One Week**, **One Month** (default), **Six Months** or **One Year (max)**. The link expires at the start of the chosen day. A short expiration date is recommended where possible.
* **Upload Limit:** Set the maximum number of files that can be uploaded through the link (1,000 by default). When the limit is reached, the link expires automatically. Leave it empty for no limit.
* **Description:** Optionally add a description. It is shown at the top of the uploader for the people who receive the link.
* **Upload Receipt Header:** Customise the header shown in the [upload receipt email](https://support.hivo.co/assets/how-to-add-assets-to-a-library-via-upload-link.md#upload-receipt-and-approval-emails-for-guests) that guests receive after uploading. Leave it blank to use the default header, *"Thanks for your upload"*.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F8k7GQ9wOJS3Jxs3aF4Dm%2FGroup%201159.png?alt=media&amp;token=b00dec67-0c34-4103-941f-e67f5eba64a2" alt=""><figcaption></figcaption></figure>

* **Custom UI Upload Link:** Customise the uploader's look with a **Background Image** and a **Logo Image**. You can also choose **Display As Full Screen** (full-screen mode or  standard HIVO layout), and **Dark Text** for light background images.

👉  See more [**How can I customise the UI of a shared link?**](https://support.hivo.co/assets/share-asset-s-via-url-link#id-4.-how-can-i-customise-the-ui-of-a-shared-link)

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FmJE9gV9pcnlDVZ3tqVWb%2FGroup%201161.png?alt=media&amp;token=5195d5f9-7993-44b2-bdec-f6b68123d1cc" alt=""><figcaption></figcaption></figure>

### **🔹** Step 2: Asset Settings

The Asset Settings apply to all files uploaded through the link. Which fields you see depends on your permissions, and your organisation's [**Upload Link Defaults**](https://support.hivo.co/client-profile/client-profile-settings/asset-and-metadata-management/uploader-settings) may make some of them required:

* **Permissions:** The permissions given to each uploaded asset.
* **Asset Owner:** The owner of the uploaded assets.
* **Library Folder Path:** The folder where uploaded assets will be stored.
* **Collections:** Automatically add uploaded assets to one or more existing Collections.
* **Tasks:** Automatically link uploaded assets to one or more Tasks.
* **SKU/ Product IDs:** Assign uploaded assets to existing SKUs (Product IDs).
* **Tags:** Tags added to every uploaded asset (see 2.1).
* **Notifications:** Who is notified about new uploads (see 2.3).
* **Archive Date**, **Sensitive Date** and **License Expiry Date:** Set when uploaded assets are archived, marked as sensitive, or have their license expire, with an optional end date where available.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fk9t7lBAZ2q6T6jyyvGhb%2Fimage%20635.png?alt=media&amp;token=37b7aaea-c5ec-48ea-a3b0-e453943f612b" alt=""><figcaption></figcaption></figure>

Under **More Settings**, you can also turn on options such as&#x20;

* **Require Approval**&#x20;
* **Tag Prediction**, **Face Prediction**, **Run Check Asset Readiness**, **Create Watermarked Version** and other version options
* **Allow Guest to Add Tags**&#x20;
* **Allow Guest to Edit Asset Details**&#x20;

Some options only appear if your account has the related feature or permission.

#### **2.1. Require Approval**

One of the important settings recommended to be enabled is the "**Require Approval**" checkbox - this feature will send all Assets to the Approvals area. This helps moderate incoming Assets and ensure they are tagged correctly, in the correct folder, etc. This option is only shown to users who can approve uploads.

When a link requires approval, guests who opted in to emails are also told that their files will be reviewed first, and they get an email once their files are approved.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FGUuUQq9H764kRwnH9V6x%2FGroup%20810.png?alt=media&amp;token=50644637-d067-4f85-ba21-c6b2564de0d6" alt=""><figcaption><p>Requires Approval</p></figcaption></figure>

#### **2.3.** Tags - Set tags for assets when uploaded through the link

* When you create an upload link, you can pre-assign one or more tags. All assets uploaded via that link will automatically be tagged with the selected tags.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FVT9E5BzO9yEdLEwuLKVV%2FGroup%20812.png?alt=media&amp;token=149ca20f-ab48-4210-87fa-e42a20e8710a" alt=""><figcaption><p>Set tags for assets when uploaded through the link</p></figcaption></figure>

* If you have set up rules to automatically add assets to collections based on tag, the system will check the assigned tags and place the assets into the corresponding collections — completely automatically, with no manual steps needed. See more [Automated Collections.](https://support.hivo.co/collections/automated-collections) This helps you manage and categorize assets quickly and accurately right from the moment they’re uploaded.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FdB0b4emBJh7oyIUUuRLH%2FGroup%20813.png?alt=media&amp;token=8a9ff866-17f4-42d2-9ea1-cd5ec8783741" alt=""><figcaption><p>Set up rules to automatically add assets to collections</p></figcaption></figure>

#### **2.3.** Allow Guest to Add Tags

Settings to control how tags are applied to assets upon upload:

* **Allow Guest to Add Tags:** Allows guests to add their own tags in addition to the pre-set tags.
* **Show Tag Categories:** Display tags by category (eg: Digital Content, Brand...).

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FSugJdKYwrDDUTDLKN0dS%2FGroup%20814.png?alt=media&amp;token=4ad65f19-b8db-434e-9b28-a91f9b02eca7" alt=""><figcaption></figcaption></figure>

👉 If you disable **Allow Guest to Add Tags** (uncheck), guests will not be able to add tags when uploading files — the Tag Assets step will be hidden in the uploader. These options are not shown if your organisation has hidden the Tag Assets step in the Uploader Settings.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FGEs7of3L5ecRjrodeZwj%2FGroup%20816.png?alt=media&amp;token=51b192c3-860c-41d3-86f0-13aa0cdbceb3" alt=""><figcaption><p>Disable this option <strong>Allow Guest to Add New Tags</strong></p></figcaption></figure>

👉 If you disable **Show Tag Categories**, tags will only display example tags, not by categories.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FPEdKnWVrPZuPtN67Spyz%2FGroup%20815.png?alt=media&amp;token=7e28b809-7a8f-4c96-bcff-531a2b57f9aa" alt=""><figcaption><p>Disable option <strong>Show Tag Categories</strong></p></figcaption></figure>

#### **2.4.** Upload Link Notification Setting

Notify users or groups when assets are added via an Upload Link. Only users with the **View All Assets** permission can receive notifications.

* **Approval Required**: If an upload link requires approval, only users with the **Approval** permission will receive a notification.
* **Custom Notifications**: Users added in the **Notification Field** during upload link creation will receive notifications if they have the **View All Assets** permission.

This ensures that only relevant users receive updates, reducing unnecessary notifications while maintaining workflow efficiency.

👉 These notifications are for HIVO users. Guests who upload through the link can get their own emails instead, see [Upload receipt and approval emails for guests](https://support.hivo.co/assets/how-to-add-assets-to-a-library-via-upload-link.md#upload-receipt-and-approval-emails-for-guests).

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FsNnobXjmLBdOftMijoR2%2FGroup%20809.png?alt=media&amp;token=6ff14da6-4f00-4264-8d6e-bc503adb2888" alt=""><figcaption><p>Upload Link Notification Setting</p></figcaption></figure>

#### **2.5. Allow Guest to Edit Asset Details**

The recipients of the link will be able to input metadata in the guest uploader, such as a description or copyright. Turn on **Include Custom Metadata Fields** to also show your organisation's custom metadata fields.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F4ZNs6aIOdq21eNHjxERa%2FGroup%20818.png?alt=media&amp;token=81fdccf5-6e58-45b3-8339-fe358a8ebb27" alt=""><figcaption></figcaption></figure>

## View and Manage Upload Links

* To view your created upload links from within the Library, you can switch to the "**Existing Links**" tab after clicking the '**Add Assets**' button and then '**Create Upload Link**'. Here you will see all upload links created.
* You can also view more detailed Upload link information (including all other link types and the options you set when creating the link) via the [Links feature](https://support.hivo.co/links.md).

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FM3WNyhYdfMMnEBvJ0Av4%2F0723_23.gif?alt=media&amp;token=d0efa762-50aa-4fef-93c0-4691a4a3e049" alt=""><figcaption><p>View and manage Upload Link</p></figcaption></figure>

## **Key Points to Remember**

* **Controlled Access**: Set expiration dates and upload limits to manage the content being uploaded.
* **Detailed Settings**: Configure asset settings to ensure uploaded files are correctly categorized and metadata is properly added.
* **Approval Workflow**: Use the "Require Approval" feature to moderate assets.
* **Guest Emails**: Guests can get an upload receipt and, for links that require approval, an approval email. Customise the receipt header in Link Settings.
* **Easy Management**: View, edit, and delete upload links from the "Existing Links" tab or the Links section.

⚠️ **User Right Required:** User must have the **Can Create/Update/Delete Upload Links** permission to create, edit or delete Upload Links.

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/upload-links.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.
