(New) This article provides instructions for creating custom links using the Deep Linking feature in Employee View. These links can be placed in widgets for quick access, used in articles such as posts, pages, or stories, or saved as bookmarks to provide direct access to specific reservation pages.
By using deep links, users can bypass repeated navigation through menus, options, and filters, enabling faster and more efficient access to commonly used booking views.
Introduction to Deep Linking
Navigating to the right reservation view, such as a specific building, floor, desk type, or room availability page, often requires multiple clicks through menus and filters. This slows down the booking process, as employees must repeatedly follow the same steps to reserve familiar spaces, and limits how organizations are able to guide users toward preferred workplace experiences. The lack of direct, shareable links also makes it harder to embed Space Reservation into intranets, widgets, or custom homepages.
Deep linking in Employee View addresses this by providing URL-based links to specific selection options on the Places tab, where you can then proceed to create a reservation or building pass. These links can point to workspaces or rooms, buildings, floors, or filtered views based on criteria such as location, date, or time. You can also preconfigure searches using URL parameters.
They can be embedded into dashboards, digital signage, portals, or custom homepage widgets, taking employees directly to the most relevant booking options. This reduces the time required for space selection and enables booking experiences that are better aligned with user needs.
Supported Sections in Employee View
You can create deep links in the following sections of Employee View. Each section supports specific options and filters, with corresponding URL parameters:
Places > Workspaces with the following filters:
| Option/Filter | Description | Parameter |
| Location or Building | The current location/building selected. | buildingid |
| Date | Refer to the Filters section of the Reserve a Workspace, Desk, or Room – Employees (part 1) article. | start |
| Time |
| start |
| Duration |
| duration |
| Floor | This requires a building (buildingid) to be defined in parameters. | floorid |
| Zone/Neighborhood | This requires a building (buildingid) to be defined in parameters. | zones |
| Workspace Type |
| type |
| Workspace subtype |
| subtype |
| Status |
| status |
| Capacity |
| minCapacity |
| Amenities |
| facilities |
| Current Lighting |
| lightStates |
| Min temperature |
| minTemperature |
| Max temperature |
| maxTemperature |
| Open link in Map View sidebar | This requires a building (buildingid) to be defined in parameters. | crosslaunch=viewmap |
| Open link in View More Info sidebar | This requires a building (buildingid) to be defined in parameters. | crosslaunch=viewmoreinfo |
Places > Building pass with the following filters:
| Option/Filter | Description | Parameter |
|---|---|---|
| Date | The date selected | start |
| Duration | Day Pass, Week Pass or Month Pass | duration |
Places > At the office with the following filters:
| Option/Filter | Description | Parameter |
|---|---|---|
| Location | The location selected | buildingId |
| Week | The first date of the work week selected (Mon - Fri) | startDate |
| Everyone / My Favorites | Show Everyone or My Favorites only | attendeeType |
Using Deep Links with URL Parameters
URL parameters allow you to refine deep links by preselecting specific options such as building, date, time, or capacity. By appending parameters to the end of a deep link, you can create targeted views that match specific booking needs.
Parameters are added to the URL using a query string:
- The first parameter begins with a
? - additional parameters are added using
& - Each parameter consists of a key and a value (for example,
?buildingid=HQ&start=2026-04-01).
Important
When constructing deep links, use only parameters supported by the selected section of Employee View, as unsupported parameters will be ignored.
Places > Workspaces:
Examples of URL parameters in deep links:
The floor (floorid) and zones (zones) parameters requires requires the building (buildingid) parameter to be defined.
https://app4.cloud.appspace.com/console/#!/browse/places/workspaces?buildingid=350b4281-6955-4350-a216-6e960d37e995&floorid=1900b9de-c23a-4310-bd1e-bd2182dca557&zones=251a9c88-fcb1-4530-bb43-d954d501c61c&start=2026-06-01T09:30:00.000Z&duration=45&status=available&type=space&subtype=Desk&capacity=3&minTemperature=18&maxTemperature=22&lightStates=Dim| Parameter | Value | Option/Filter |
|---|---|---|
| buildingid | 350b4281-6955-4350-a216-6e960d37e995 | Location |
| floorid | 1900b9de-c23a-4310-bd1e-bd2182dca557 | Floor |
| zones | 251a9c88-fcb1-4530-bb43-d954d501c61c | Zone |
| start | 2026-06-01T09:30:00.000Z | Date and Time |
| duration | 45 | Duration |
| status | available | Status |
| type | space | Workplace Type |
| subtype | Desk | Workplace Subtype |
| capacity | 3 | Capacity |
| minTemperature | 18 | Minimum Temperature |
| maxTemperature | 22 | Maximum Temperature |
| lightStates | Dim | Current Lighting |
- To open the building in Map view with parameters included (similar to going to Places > Select a building > View Map button)
Add the following parameter and value to the end of the link: &crosslaunch=viewmap
Important
You must define the building (buildingid) parameter and value first to use this feature.
Example:
https://app4.cloud.appspace.com/console/#!/browse/places/workspaces?buildingid=350b4281-6955-4350-a216-6e960d37e995&floorid=1900b9de-c23a-4310-bd1e-bd2182dca557&zones=251a9c88-fcb1-4530-bb43-d954d501c61c&start=2026-06-01T09:30:00.000Z&duration=45&status=available&type=space&crosslaunch=viewmap - To open the building in Map view with parameters included (similar to going to Places > Select a building > View More Info button)
Add the following parameter and value to the end of the link: &crosslaunch=viewmoreinfo
Important
You must define the building (buildingid) parameter and value first to use this feature.
Example:
https://app4.cloud.appspace.com/console/#!/browse/places/workspaces?buildingid=350b4281-6955-4350-a216-6e960d37e995&floorid=1900b9de-c23a-4310-bd1e-bd2182dca557&zones=251a9c88-fcb1-4530-bb43-d954d501c61c&start=2026-06-01T09:30:00.000Z&duration=45&status=available&type=space&crosslaunch=viewmoreinfo
Places > Building pass
https://app4.cloud.appspace.com/console/#!/browse/places/buildingpass?start=2026-06-01T16:00:00.000Z&duration=weekpass| Parameter | Value | Option/Filter |
|---|---|---|
| start | 2026-06-01 | Date |
| duration | weekpass | Duration (Day Pass, Week Pass or Month Pass) |
Places > At the office
https://preview.appspace.com/console/#!/browse/places/attheoffice?buildingId=87ae209f-3c6e-4bc5-8ab4-2adbc049f215&startDate=2026-06-01&attendeeType=favorites| Parameter | Value | Option/Filter |
|---|---|---|
| buildingId | 87ae209f-3c6e-4bc5-8ab4-2adbc049f215 | The current Building selected |
| startDate | 2026-06-01 | Week (The first date of the work week selected (Mon - Fri)) |
| attendeeType | favorites | Show Everyone or My Favorites only |
Creating Deep Links from Employee View
You can create a deep link directly from the Employee View URL and add as a custom link to widgets, or as a standard link in posts, pages, or stories.
To create and copy a deep link, perform the following steps:
- Navigate to the desired section in Employee View.
- On the page, apply the required filters (for example, building, date, or workspace type). Click Apply if required.
- After you have applied all the filters, copy the URL from the browser’s address bar. If required, save it to a note or text editor, such as Notepad, Notes, or another application of your choice.
- You may modify the custom URL based on the URL parameters (explained in the Supported Sections in Employee View section above) if necessary.
Adding Deep Links to Posts, Pages, and Stories
- Create or edit a post, page or story. Refer to the Create Posts in The Employee App article.
- In the contents, create a link using the deep link URL.
Adding Deep Links to Widgets
You can use deep links it in any widget that allows displays of URLs for quick access to specific reservation pages. Widgets that support the display of URLs include:
- Bookmarks
- Shortcuts
- App Links
- Web Frame
To create and use a deep link in a widget, perform the following steps:
Important
- Ensure that you have the required permissions for creating widgets and themes. Refer to the prerequisites section at the top of the article Configure Employee Experience Settings (part 1) article.
- Ensure that you are familiar with how to create widgets and themes. Refer to the Theme Settings for Employee Experience article.
- Go to the Appspace console.
- Click the ☰ Appspace menu, and click Settings > Configuration.
- Click the Employee Experience tab, and click Themes from the side panel menu.
- Select the theme or sub-theme that you wish to add the widget to. To add the widget to the global theme, select Global Locations or similar. Refer to Step 9. of the Theme Settings for Employee Experience article for widget configuration.
-
Create a link with the deep link URL in the widget.
- Save and publish the widget.
Once configured, the widget with deep links will appear in Employee View. Clicking the link will direct users to the same reservation page and view defined by the deep link, enabling faster access to relevant booking options.