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're logged in to the Collective and click a deep link URL, 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 clicking a deep link URL, and then you'll be taken directly to the specified page.

When a deep link is used in conjunction with a single sign-on (SSO), you will be authenticated through the SSO and not prompted to enter your username and password.

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

Constructing deep link URLs

Deep link URLs can be constructed from the name of a category, global collection, or spotlight search. Deep links can also be constructed from a unique ID 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

Use these formats to construct deep link URLs with the unique ID:

  • Collective URL/category/categoryID
  • Collective URL/collection/collectionID
  • 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 IDs can be found at the end of the URL when on the Collection Details page
 for a personal or global collection.

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 link URLs 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.