Customize navigation panels

Table of Contents

Navigation experience
Customize the top navigation bar
- Example
Command palette availability in embed
Customize the left navigation panel on the home page
Related resources

You can customize the navigation experience and the visibility of navigation menu elements using the Visual Embed SDK.

Important

The classic V1 and V2 navigation and homepage experience modes are deprecated as of ThoughtSpot Cloud 26.8.0.cl. Starting from this release, all embedded sessions render in the V3 navigation experience by default.

Navigation experience🔗

Both V3 and V4 experience provide the following navigation experience:

Top navigation bar with a modern look and feel. Includes the following components:
- A hamburger icon for the sliding navigation overlay
- Object search bar
- Help and profile icons
- Org switcher
Left navigation
- A sliding left navigation panel controlled via the hamburger icon
- Persona-based app selection icons in the panel header
- Left navigation menu that adjusts its contents according to the application context

Note	The V4 focused home page experience (`HomePage.Focused`) uses the same navigation customization controls as the V3 experience. All SDK properties listed in this article apply to the V4 experience when `PrimaryNavbarVersion.Sliding` is also configured.

Customize the top navigation bar🔗

The following customization settings are available for the top navigation bar.

SDK property V3 experience
HomePage.ModularWithStylingChanges V4 experience
HomePage.Focused

SDK property	V3 experience `HomePage.ModularWithStylingChanges`	V4 experience `HomePage.Focused`
`showPrimaryNavbar` To show or hide the navigation experience.	✓ Supported	✓ Supported
`hideApplicationSwitcher` To show or hide the application switcher.	✓ Supported Hides the app selection icons on the left navigation panel.	✓ Supported Hides the app selection icons on the left navigation panel.
`disableProfileAndHelp` To show or hide the help and user profile icons in the top navigation bar.	✓ Supported Also hides or shows the Help menu on the left navigation panel of the home page.	✓ Supported
`hideOrgSwitcher` To show or hide the Org switcher.	✓ Supported	✓ Supported
`hideNotification` To show or hide the notification (bell) icon.	✓ Supported	✓ Supported
`hideObjectSearch` To show or hide the object search bar in the top navigation bar.	✓ Supported	✓ Supported
`hideHamburger` To show or hide the hamburger icon in the top navigation bar.	✓ Supported Hides the hamburger icon available on pages where the left navigation panel is hidden by default.	✓ Supported

showPrimaryNavbar
To show or hide the navigation experience.

✓ Supported

hideApplicationSwitcher
To show or hide the application switcher.

✓ Supported
Hides the app selection icons on the left navigation panel.

disableProfileAndHelp
To show or hide the help and user profile icons in the top navigation bar.

✓ Supported
Also hides or shows the Help menu on the left navigation panel of the home page.

✓ Supported

hideOrgSwitcher
To show or hide the Org switcher.

✓ Supported

hideNotification
To show or hide the notification (bell) icon.

✓ Supported

hideObjectSearch
To show or hide the object search bar in the top navigation bar.

✓ Supported

hideHamburger
To show or hide the hamburger icon in the top navigation bar.

✓ Supported
Hides the hamburger icon available on pages where the left navigation panel is hidden by default.

✓ Supported

Example🔗

The following example hides the icons in the top navigation and the application selection menu:

const embed = new AppEmbed("#embed", {
    //... V3 experience attributes
    showPrimaryNavbar: true,
    hideApplicationSwitcher: true,
    disableProfileAndHelp: true,
    hideObjectSearch: true,
    hideNotification: true,
    //... other attributes
});

Command palette availability in embed🔗

In ThoughtSpot application, users can open the command palette by pressing kbd:[Cmd+K] on macOS or kbd:[Ctrl+K] on Windows to quickly navigate to objects and perform actions. However, when you embed ThoughtSpot, this feature is disabled and embedded pages include only the standard object search experience.

Customize the left navigation panel on the home page🔗

In the V3 and V4 experience modes, the left navigation panel on the Insights > Home page includes menu items such as Spotter, Answers, Liveboards, SpotIQ Analysis, Monitor Subscriptions, and more. You can hide this navigation panel by setting the hideHomepageLeftNav property to true in the SDK. Note that this attribute hides the left navigation only on the home page.

If you want to include the left navigation, but hide only a specific section in the Insights panel, use the hiddenHomeLeftNavItems property and specify the menu items to hide. The allowed values for hiddenHomeLeftNavItems are listed in the following table:

Allowed values V3 experience
HomePage.ModularWithStylingChanges V4 experience
HomePage.Focused

Allowed values	V3 experience `HomePage.ModularWithStylingChanges`	V4 experience `HomePage.Focused`
`HomeLeftNavItem.Create` To show or hide the `+` icon that allows users to create a Liveboard or Answer in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.Home` To show or hide the Home menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.Spotter` To show or hide the Spotter menu item in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.SearchData` To show or hide the Search Data in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.Liveboards` To show or hide the Liveboards menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.Answers` To show or hide the Answers menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.MonitorAlerts` To show or hide the Monitor > Alerts menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.MonitorSubscriptions` To show or hide the Monitor > Subscriptions menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.SpotIQAnalysis` To show or hide the SpotIQ Analysis menu in the Insights panel.	✓ Supported	x Not supported
`HomeLeftNavItem.Learning` To show or hide the Learning menu in the Insights panel.	✓ Supported	✓ Supported
`HomeLeftNavItem.LiveboardSchedules` To show or hide the Scheduled Liveboards section in the Insights panel.	✓ Supported	✓ Supported

HomeLeftNavItem.Create
To show or hide the + icon that allows users to create a Liveboard or Answer in the Insights panel.

✓ Supported

HomeLeftNavItem.Home
To show or hide the Home menu in the Insights panel.

✓ Supported

HomeLeftNavItem.Spotter
To show or hide the Spotter menu item in the Insights panel.

✓ Supported

HomeLeftNavItem.SearchData
To show or hide the Search Data in the Insights panel.

✓ Supported

HomeLeftNavItem.Liveboards
To show or hide the Liveboards menu in the Insights panel.

✓ Supported

HomeLeftNavItem.Answers
To show or hide the Answers menu in the Insights panel.

✓ Supported

HomeLeftNavItem.MonitorAlerts
To show or hide the Monitor > Alerts menu in the Insights panel.

✓ Supported

HomeLeftNavItem.MonitorSubscriptions
To show or hide the Monitor > Subscriptions menu in the Insights panel.

✓ Supported

HomeLeftNavItem.SpotIQAnalysis
To show or hide the SpotIQ Analysis menu in the Insights panel.

✓ Supported

x Not supported

HomeLeftNavItem.Learning
To show or hide the Learning menu in the Insights panel.

✓ Supported

HomeLeftNavItem.LiveboardSchedules
To show or hide the Scheduled Liveboards section in the Insights panel.

✓ Supported

Customize navigation panels

Navigation experience🔗

Customize the top navigation bar🔗

Example🔗

Command palette availability in embed🔗

Customize the left navigation panel on the home page🔗

Related resources🔗