> For the complete documentation index, see [llms.txt](https://docs.santacruzsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.santacruzsoftware.com/linkrui/asset-action-menu-list/upload-new-assets.md).
# Upload Assets
Add files from your local device to the DAM.
### Choose an upload method
{% hint style="info" %}
Your file needs to be saved before you can upload new assets.
{% endhint %}
{% tabs %}
{% tab title="Main Menu" %}
1. Select Upload New Asset or Export New Asset under the 
.
2. Choose Switch file to the uploaded asset (optional).
3. Fill in required fields.
4. Select Upload or Export.
{% endtab %}
{% tab title="Document icon" %}
1. Select the Document icon in the bottom-left corner of the LinkrUI panel.
2. Select Upload.
3. Choose Switch file to the uploaded asset (optional).
4. Fill in required fields.
5. Select Upload.
{% hint style="info" %}
The document icon is only available in Adobe Creative Cloud applications.
{% endhint %}
{% endtab %}
{% endtabs %}
{% hint style="info" %}
The options in the upload/export new asset window differ depending on the DAM and the assets.
{% endhint %}
You can also upload new assets to the DAM under the [links dialog](/linkrui/smart-linkr/links-actions.md) in some Adobe Applications.
When permitted, the upload destination can be the DAM's root location. The root label depends on the DAM; see [DAM root labels](/linkrui/search-assets.md#dam-root-labels).
For Brandfolder, upload destinations can include **Sections**.
LinkrUI loads the upload fields from the DAM. Required fields and available choices can change according to the selected destination and DAM configuration.
After you click Upload or Export, the window closes and you are returned to the same location in the DAM that you were in previously.
You can refresh the panel or search for the uploaded assets to view them.
The original files remain unchanged.
{% hint style="info" %}
If the upload fails, check that you filled in all required fields.
{% endhint %}
### Link local and DAM assets
New uploads do not automatically link your local file to its DAM asset.
To create a link during upload or export:
1. Open the upload or export dialog.
2. Select Switch file to the uploaded asset.
3. Complete the required fields.
4. Select Upload or Export.
After the upload completes, LinkrUI opens the DAM asset as the current file. The local file and DAM asset are now linked.
When you edit the local file later, you can sync those changes to the linked DAM asset, and vice versa.
{% hint style="success" %}
After the upload is complete, the asset will appear with a checkmark icon, which means that it exists both in the DAM and locally.
If you choose not to link your local file and the DAM asset, the newly uploaded DAM asset will be indicated with a cloud icon.
{% endhint %}
---
# 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://docs.santacruzsoftware.com/linkrui/asset-action-menu-list/upload-new-assets.md?ask=&goal=
```
`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.