# Deep links in Amazon WorkSpaces Secure Browser
<a name="deep-links"></a>

When a user signs into WorkSpaces Secure Browser, they start the session on a home page set by the administrator. You can also allow portals to receive deep links that connect users to a specific website during a session. When a deep link is selected, the portal displays the URL specified in the deep link. The link is displayed alongside the home page(s) configured for session start, or by itself if a session is already in progress. This feature allows administrators to create more dynamic user experiences with WorkSpaces Secure Browser.

Deep links open pages in a WorkSpaces Secure Browser session. If a session is already running, it will open the deep link in a new tab. If a session is not already running, it will open the deep link URL in a new tab, and the portal default home page in a separate tab. If a deep link contains more than one URL, it will display the deep link URL listed first in focus, with each subsequent URL (including the default home page) opened in separate tabs.

**Topics**
+ [Setting up deep links in Amazon WorkSpaces Secure Browser](add-deep-links.md)
+ [Using URL filtering for deep links in Amazon WorkSpaces Secure Browser](filtering-deep-links.md)

# Setting up deep links in Amazon WorkSpaces Secure Browser
<a name="add-deep-links"></a>

To allow permission for deep links, choose **Allowed** when creating user settings. The site you want to deep link to must be URL-encoded. For example, to link a user to “https://www.example.com/?query=true”, update the link to https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue.

A deeplink can contain up to 10 URLs, delineated by comma. For example:

https://<uuid>.workspaces-web.com/?deepLinks=https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue2,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue3,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue4.

For more information about allowing deep links, see [Configuring user settings for Amazon WorkSpaces Secure Browser](user-settings.md).

# Using URL filtering for deep links in Amazon WorkSpaces Secure Browser
<a name="filtering-deep-links"></a>

Any user you share this portal link with can manipulate the deep link value to visit a website, if that domain is reachable from the portal and not on the URL blocklist. To create a restrictive allowlist or blocklist to prevent users from visiting unintended domains with your portal, use URL filtering.

The allowlist and blocklist for a portal can be edited with URL filtering in your portal’s browser settings. To do this, append the URL to an allow-listed portal URL in the following format, where UUID is the portal id: https://<uuid>.workspaces-web.com/?deepLinks=https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue

For more information, see [Web content filtering in Amazon WorkSpaces Secure Browser](web-content-filtering.md) and [Allow or block access to websites](https://support.google.com/chrome/a/answer/7532419?hl=en).