Skip to main content

Added Support for Customizing the Left Navigation Bar

· 2 min read

You can now customize the behavior and appearance of the Left Navigation Bar in your developer portal. The new options include two navigation modes and three layout variations that give you more control over how navigation is structured and displayed.

What’s New​

The Left Navigation Bar now supports:

  • Two navigation modes
  • Three layout variations

These settings work together to define both how top-level items are grouped and how first-level sections behave when the page loads.

  • standard: Displays all navigation items in a vertical list, including nested levels.

  • dropdown: Groups top-level (level 0) navigation items in a dropdown menu. Child items are shown based on the selected item.

Layout Variations​

Layout variations define the on-load behavior of first-level sections (the sections nested under top-level items):

  • basic: All first-level sections are visible and not collapsible.

  • expanded: All first-level sections are visible and can be collapsed by the user.

  • collapsed: All first-level sections are collapsed by default and can be expanded by the user.

note

These options are only supported in the theme configuration. They are not available with themeOverrides.

Standard Mode​

Standard Basic UI

Dropdown Basic UI

Configuration Example​

Use the following structure to configure the Left Navigation Bar in your portal theme:

theme: {
  layout: {
    sidebar: {
      mode: "standard", // or "dropdown"
      variation: "basic" // or "expanded", "collapsed"
    }
  }
}

For full configuration details, see the theme layout configuration reference.

Deprecation Notice​

The portalSettings.sideMenuTitleBehavior flag is now deprecated. It was previously used to control the collapsed state of top-level navigation items.

You should now use:

  • theme.layout.sidebar.mode
  • theme.layout.sidebar.variation

Update your configuration to ensure consistency and to take advantage of the new behavior options.