> 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/smart-linkr.md).

# Smart-Linkr

Use Smart-Linkr to manage local and cloud links in Adobe documents.

Smart-Linkr is LinkrUI’s powerful Links dialog feature for managing placed files in Adobe documents.

Use it to review local and cloud links, relink files, upload assets, sync changes, and perform other link-management tasks.

### To open the Links dialog

1. Select the <kbd>Links</kbd> icon in the bottom toolbar.
2. The Links dialog opens and displays every link in the document.

<figure><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FplZbpcvFjagslZt2wkFv%2FScreenshot%202026-08-06%20212844.png?alt=media&amp;token=8844c2f0-f04e-4acf-89f5-1fe14091e158" alt="LinkrUI bottom toolbar with the Links icon highlighted" width="324"><figcaption><p>The Links icon in the LinkrUI bottom toolbar.</p></figcaption></figure>

{% hint style="info" %}
The Smart-Linkr feature is available in Adobe InDesign, Illustrator, Premiere Pro, and After Effects.
{% endhint %}

### Links dialog overview

LinkrUI displays badges on the Link button when links need attention.

Hover over a badge to see the number of links missing locally or from the cloud.

<figure><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2F90CLGgjgrKC3poxhRyX1%2FScreenshot%202026-08-06%20215459.png?alt=media&amp;token=0466fbbe-3bda-4a3b-b13b-920cb7a45922" alt="LinkrUI Link button showing red and pink status badges" width="317"><figcaption><p>Link-status badges shown on the Link button.</p></figcaption></figure>

* Pink badge: links missing from the cloud.
* Red badge: links missing from the local device.

The LinkrUI **Links dialog** lists every file placed in the document. This includes local files and cloud assets. Available actions depend on each file’s type, location, and status.

<figure><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FYlyCDkIJTOsNlQ00eUKq%2FScreenshot%202026-08-05%20155913.png?alt=media&amp;token=db2b2cef-3cbf-4044-8605-8b4c5219d63f" alt="LinkrUI Links dialog listing placed links and their statuses" width="394"><figcaption><p>The Links dialog lists placed files and their current link status.</p></figcaption></figure>

#### Check Links in Background toggle

Use **Check Links in Background** to control whether LinkrUI monitors links in open documents.

* When enabled, LinkrUI checks local and cloud links for changes.
* When disabled, LinkrUI does not check links until you enable it again.

When you re-enable this setting, LinkrUI checks the DAM for updated cloud assets. It then refreshes link status.

You can change how often LinkrUI checks for links in the background under <kbd>Main Menu</kbd> → <kbd>Preferences</kbd>.

Background link checks have little effect on performance in most documents, and you will likely not see any delays in most documents.

To improve performance in complex documents with many links, disable **Check Links in Background** unless you're actively working with links.

#### Download links

Use **Download Links** to control whether LinkrUI downloads cloud assets during link checks.

After downloading an asset, LinkrUI follows your link-update preference. It can update the link automatically, prompt you, or leave it unchanged.

{% hint style="info" %}
Disabling **Check Links in Background** also disables the **Download Links**\
option.

If you keep **Check Links in Background** on but turn off **Download Links**,\
LinkrUI will still find and show you any broken or missing links (with a badge over the\
Link button). However, it won't download the assets from the DAM to your computer.

These toggles are also available in the Preferences dialog.
{% endhint %}

#### Search and headers

Use the search bar above the links list to find specific links.

The links list includes **Status**, **Page**, and **Name** columns. Status shows the link state. Page shows where the link appears. Name shows the file name.

Select a column header to sort by that column. Select it again to reverse the sort order.

#### Link path

Hovering over a link in the Links dialog provides a tooltip of the full file path. By defaut, it's saved in the documents folder on your device.

#### Link actions

Select the three dots in the right side of the link to get a list of [available actions](/linkrui/smart-linkr/links-actions.md) for that link.

#### Link status icons in the LinkrUI Links dialog

The icon beside each link shows its current status. Link status can be local, cloud, downloading, missing locally, conflicted, modified, or embedded.

<table data-search="false"><thead><tr><th width="180.66668701171875">Link Status Icons</th><th valign="middle">Meaning</th></tr></thead><tbody><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FrE2nnUUzuegr3JHDBlxM%2FScreenshot%202026-08-06%20115610.png?alt=media&amp;token=3e041b9f-8162-49ed-a345-5ba5c7135408" alt=""></td><td valign="middle"><p><strong>Valid and Local:</strong></p><p>The file is linked to a local file and does not reside in the cloud.</p></td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2F6iBF8PGvTbjYWL7aWPD1%2FScreenshot%202026-08-06%20115511.png?alt=media&amp;token=6d7a5792-e452-4f80-ac8c-becb8d333c25" alt=""></td><td valign="middle"><strong>Valid Locally and in the cloud:</strong><br>The file is linked to a cloud asset and is available locally on your device.</td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FeGh4be7xGx7LuexWEdTo%2FScreenshot%202026-08-06%20115746.png?alt=media&amp;token=d4d08c99-f39c-411e-983b-c6cdc72ceb20" alt=""></td><td valign="middle"><strong>Downloading:</strong><br>Indicates that the asset is currently being downloaded from the DAM to your local device. Once the download is complete, the Downloading icon will be replaced with a checkmark icon, which means the file is<br>linked to a cloud asset and is available locally</td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2F338Cl71ZNdAoNnAWawqM%2FScreenshot%202026-08-06%20115856.png?alt=media&amp;token=e7f4e6fd-e1c6-4a6d-aaa7-2ccbf15981f7" alt=""></td><td valign="middle"><p><strong>Missing Locally but in cloud:</strong></p><p>The file is a cloud asset that exists in the<br>cloud, but is missing from the local device.<br>(The image exists in the DAM but is locally missing.)</p></td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FINqOkrkvDBXg87ImcxlW%2FScreenshot%202026-08-06%20115926.png?alt=media&amp;token=fe9648a1-c3a9-49ca-a741-f3ff73eb64d1" alt=""></td><td valign="middle"><strong>Conflict:</strong><br>This icon means conflict occurs when:<br>➔ Linked file is missing from local and from the cloud<br>➔ Local link version is newer than the version in cloud.<br>➔ cloud link version is newer.<br>➔ There is a conflict between your local linked asset<br>version and the DAM version (the asset was modified<br>both locally and in DAM).<br>Note: With hovering over the Conflict icon, a tooltip pops up<br>giving the reason for the conflict.</td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2Fv3pmVDe1oUkU3Ux05l33%2FScreenshot%202026-08-06%20120019.png?alt=media&amp;token=ba9d1c21-04b6-4fcd-8c4d-f3db53407653" alt=""></td><td valign="middle"><strong>Modified:</strong><br>The version of the file on disk is more recent than the version in your document. This may happen, for example, if you import a Photoshop graphic into InDesign, and then you or someone else edits and saves the original graphic in Photoshop.</td></tr><tr><td><img src="https://1895738376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2lt9lcavWcRN7izHUMZE%2Fuploads%2FOSF5iUJczLUP0DkCj2Me%2FScreenshot%202026-08-06%20120108.png?alt=media&amp;token=bd83a889-a697-437e-ab46-1f493a84b649" alt=""></td><td valign="middle"><strong>Embedded:</strong><br>This icon means the link is embedded.</td></tr></tbody></table>

#### Location in the document

Select a link in the Links dialog to locate the corresponding asset in the document.

#### Details section

The details pane shows information about the selected link. Cloud links display additional asset details. Local links display basic file information, including file name and path.


---

# 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/smart-linkr.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.