Skip to main content Home
About About the Design SystemRoadmap
Get started OverviewDesignersDevelopers
Foundations OverviewColorGridIconographyInteractionsSpacingTypography
Tokens Overview Global colorbox shadowTypographyborderopacityspacelengthIconBreakpointsMedia Queries
Elements All elements Accordion Alert Announcement Audio player Avatar Back to top Badge Blockquote Breadcrumb Button Card Chip Code block Call to action Dialog Disclosure Footer Health index Icon Jump links Navigation (primary) Navigation (secondary) Pagination PopoverPlanned Progress stepper Scheme toggle Site status Skeleton Skip link Spinner Statistic Subnavigation Surface Switch Table Tabs Tag Tile Timestamp Tooltip Video embed
Theming OverviewColor PalettesCustomizingDevelopers
Patterns All PatternsCardFilterFormLink with iconLogo wallSearch barSticky bannerSticky cardTabsTagTile
Personalization All Personalization PatternsAnnouncement
Accessibility FundamentalsAccessibility toolsAssistive technologiesCI/CDContentContributorsDesignDevelopmentManual testingResourcesScreen readers
Design/code status Release notes Get support

Navigation (secondary)

OverviewStyleGuidelinesCodeAccessibilityDemos
StyleColor schemeConfigurationSpaceInteraction statesStyleColor schemeConfigurationSpaceInteraction states

Style

A secondary navigation is a group of links and menus placed in a bar container that spans the width of the browser window.

Anatomy

A secondary navigation is divided into three slots. It is not required to use all three slots.

  • Logo (logo) - includes primary elements, like a linked logo or a product name
  • Navigation (nav) - includes navigation elements, such as inline links, menus, and external links
  • Call to action (cta) - includes a call to action, typically the default variant (optional)
A secondary navigation featuring a logo, menu nav item, link, an external link, and a default call to action

Slots and breakpoints

On small breakpoints, elements in the nav slot will collapse into an accordion within a menu (also called the mobile-menu slot). Optional elements in the cta slot will be placed below the accordion or hidden completely.

Three diagrams illustrating the responsiveness of secondary nav. The first shows a logo slot, nav slot, and cta slot. The second shows the tablet view with only the logo and mobile-menu slots. The third shows the nav and cta slots in the expanded mobile menu.

Using the expandable menu

The expandable menu is an area where content can be placed like text, links, calls to action, and more. The menu requires a backdrop so it can separate itself from the page underneath, this helps users focus on the menu content.

Property Current value
Color - backdrop --rh-color-gray-90
Opacity - background --rh-opacity-80

Color scheme

A secondary navigation is available in both light and dark schemes. The light scheme background includes a box shadow whereas the dark scheme background includes a gray bottom border.

Light scheme

The light scheme secondary navigation should be used in environments with a lighter look and feel. The box shadow is always visible unless covered by an expanded menu.

A light scheme secondary navigation with black text, light gray background, and slight box shadow

Dark scheme

The dark scheme secondary navigation should be used in environments with a darker look and feel. The gray bottom border is always visible unless covered by an expanded menu.

A dark scheme secondary navigation with white text, a dark gray background, and a light gray bottom border

Configuration

A secondary navigation spans the entire width of a browser window on all breakpoints. It has a fixed height of 86px on large breakpoints and a fixed height of 80px on small breakpoints even if the logo slot’s text is only one line. Content in all slots is horizontally centered with the background.

A responsive secondary navigation, transitioning from a full desktop view with multiple links to a collapsed mobile menu.

Expandable menu styles

An expandable menu includes content like text, links, calls to action, and more. The menu tab, panel, and backdrop have the same styles on all breakpoints.

Two diagrams: A desktop-size secondary nav with all nav items showing and a mobile menu view with nav items styled like accordions

Space

The amount of space in a secondary navigation remains about the same on all breakpoints.

Large breakpoints

Image of secondary navigation spacing values on large breakpoints

Small breakpoints

Image of secondary navigation spacing values on small breakpoints

Interaction states

Interaction states are visual representations used to communicate the status of an element or pattern.

Hover

Image of light scheme secondary navigation hover states Image of dark scheme secondary navigation hover states

Focus

Image of light scheme secondary navigation focus states Image of dark scheme secondary navigation focus states

Active

Image of light scheme secondary navigation active states Image of dark scheme secondary navigation active states
© 2025 Red Hat Deploys by Netlify