# Customize navigation panels

> For the complete documentation index, see [llms.txt](https://developers.thoughtspot.com/docs/llms.txt)

Source: https://developers.thoughtspot.com/docs/customize-nav-controls

# Customize navigation panels

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` |
| --- | --- | --- |
| 
`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

 |

### Example

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

```JavaScript
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](https://docs.thoughtspot.com/cloud/latest/thoughtspot-homepage#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.

## Navigate to the Collections page

To set the Collections page as the default landing page for full application embedding, use `Page.Collections` in the `pageId` property of `AppViewConfig`.

```JavaScript
import { AppEmbed, Page } from '@thoughtspot/visual-embed-sdk';

const embed = new AppEmbed('#tsEmbed', {
    // ... other embed view config
    pageId: Page.Collections,
    showPrimaryNavbar: true,
});
embed.render();
```

You can also use `navigateToPage` to route users to the Collections page programmatically after the app loads:

```JavaScript
appEmbed.navigateToPage('collections');
```

## 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` |
| --- | --- | --- |
| 
`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.Collections`  
To show or hide the **Collections** menu item in the **Insights** left navigation panel.

 | 

✓ Supported

 | 

✓ Supported

 |

## Related resources

-   [Customize full application embedding]({{navprefix}}/{{full-app-customize}})
    
-   [Customize home page experience]({{navprefix}}/{{customize-homepage-full-embed}})
    
-   [AppViewConfig reference page]({{navprefix}}/{{AppViewConfig}})
    
-   [Host events]({{navprefix}}/{{HostEvent}})
    
-   [Embed Events]({{navprefix}}/{{EmbedEvent}})
    
-   [Actions]({{navprefix}}/{{Action}})