Acquia DAM
What are deep links?
Deep links are a URL convention for directly accessing common areas of the Acquia DAM (Widen), like search results for a category, global collection, or a spotlight search.
When you click a deep link URL while logged in to the DAM, you'll be automatically taken to the appropriate page on the site and not be required to log in again. If you're not logged in, you'll be required to enter your username and password when you click a deep link, and then you'll be taken to the specified page.
When a deep link is used in conjunction with single sign-on (SSO), you'll be authenticated through the SSO and not prompted to enter your username and password. Make sure the deep link has the same base URL as your SSO login. For example, if your SSO login uses a vanity URL, the deep link must also include the vanity URL.
If you are using the redesigned search experience, you don't have to construct deep links for category and search results. Simply, copy and paste the URL for your search results. The URL will include the search terms, sort, pagination, and filters applied.
Deep links can be constructed from unique IDs or UUIDs, names, search shortcuts, or display keys. A best practice is to use the unique ID or display key because that ensures the link will work even if the name or metadata field name is altered.
Use these formats to construct deep link URLs to categories, personal and global collections, or spotlight searches with an ID or UUID:
An example category deep link URL is:
Find category IDs next to each category in Search Settings under Asset categories in the left navigation of the Admin app.
Collection UUIDs can be found at the end of the URL when you're on the Collection Details page for personal and global collections.
Spotlight search IDs can be found at the end of the URL when editing the spotlight.
Use these formats to construct deep links with asset, collection, or spotlight search names:
An example asset name deep link URL is:
Note that, when using the name of the asset, collection, or spotlight search, the deep link will break if the name is changed.
To create a deep link for an advanced search in DAM, first create a search shortcut.
For searches including categories, asset groups, and filenames:
For searches of metadata fields:
Next, create the deep link using the search shortcut.
For deep links, you can make them a relative link – also called a local URL – instead of an absolute URL.
An absolute URL typically includes the protocol (e.g., http / https) and the website domain. A local URL does not include the protocol or domain and looks like this:
/search/ag%3A%20Photo%20Menagerie%20Asset%20Group%20vac%3A%20Cape%20Co
We recommend using a local URL so that when your users click the deep link, they won’t get redirected to a login page. Using local URLs will future-proof deep links for any site. If you change your DAM site domain, deep links using local URLs will still work.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Acquia DAM