Deep links are a URL convention for directly accessing common areas of the Widen Collective, like search results for a categoryglobal collection, or a spotlight search.

When you click a deep link URL while logged in to the Collective, 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.

Note that deep links are not supported in the mobile site or app.

Constructing deep links

Deep links can be constructed from the name of a category, global collection, or spotlight search or from a unique ID, or UUID, for categories, personal and global collections, and spotlight searches.

A best practice is to use the unique ID because that ensures the link will work even if the name is altered. If the category or collection’s name is changed, deep links with that name will break.

Deep links with IDs or UUIDs

Use these formats to construct deep link URLs with an ID or UUID:

  • Collective URL/category/categoryID
  • Collective URL/collection/collectionUUID
  • Collective URL/spotlightsearch/spotlightsearchID

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.

An example collection deep link URL is:

Collection UUIDs can be found at the end of the URL when you're on the Collection Details page for personal and global collections.

An example spotlight search deep link URL is:

Spotlight search IDs can be found at the end of the URL when editing the spotlight.

Deep links with names

Use these formats to construct deep links with asset, collection, or spotlight search names:

  • Collective URL/asset/name/AssetName
  • Collective URL/collection/title/CollectionName
  • Collective URL/spotlightsearch/SpotlightSearchName

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.

Multiple branded sites

When deep links are used in system messages for multiple branded sites, use a local URL of a deep link in the system message instead of an absolute URL. A local URL does not specify the protocol (e.g., http/https) or domain. An absolute URL typically includes the protocol and the domain.