There are two options for the masthead design, one short option to save space and one tall option to accommodate for larger product logos. The order of information remains consistent regardless of whether you are using the tall or the short masthead design.

Short Option

Image of short masthead

The short design is recommended when using Horizontal Navigation in order to reduce the vertical real estate. The hamburger menu should only be visible in the top left corner when the primary navigation is no longer visible with smaller viewport sizes.

Tall Option

Image of tall masthead

The tall design is recommended when using Vertical Navigation. The hamburger menu should always be visible in the top left corner in this case.

The tall design should always be used when rebranding capabilities are desired, regardless of the navigation type.


While there are two options for the masthead design, the order of information remains consistent regardless of whether you are using the tall or the short masthead design.

Image of masthead details

The masthead contains the following items from left to right:

Hamburger Menu

1.Hamburger Icon: The hamburger icon acts as a way for the user to open and close the vertical navigation panel. When using vertical navigation, we recommend always having the hamburger icon visible. When using horizontal navigation, the hamburger menu is only required on mobile devices.


2.Logo (optional): When using the tall masthead design, there is space for a product logo to be placed to the left of the product title for additional branding.

3.Application Title: The logo area is in the left corner and contains the application product name image file, in the form of a sized SVG graphic.

4.Context Selector: The Context Selector is used when the data/resources shown in the UI are dependent on context. It is useful when the UI cannot show data for multiple contexts simultaneously, or when it makes sense not to. Jump to the Context Selector pattern for additional details.

5.Product Specific Icons (optional): Some products may have additional requirements for the masthead, such as the shopping cart icon shown in the example above. All icons that require badge updates should be grouped together in the masthead.

6.Notifications Icon (optional): If notifications or messages are being used, the “fa-bell” icon should be placed to the left of the Application Launcher icon. The bell icon is used for opening and closing the notification drawer. Jump to the Notification Drawer pattern for additional details.

7.Application Launcher Icon (optional): If additional interfaces are available via an app selection panel, the “fa-th” icon from the Font Awesome icon library should be placed to the left of the help icon. Jump to the Launcher pattern for additional details.

8.Help Icon:

  • The pficon-help icon should always be placed directly to the left of the user icon.
  • The dropdown items may vary, but any product documentation or helpful website links available to users should be listed here. This would also be the appropriate location for customer support links.
  • The dropdown should always include an “About” option that will launch the about modal for product version information. Jump to the About Modal pattern for additional details.

9.User Icon:

  • The user’s name of the current logged in user should be listed to the right of the pficon-user icon and should always be in the top right corner of the masthead.
  • The dropdown arrow should appear to the right of the name to indicate additional options below.
  • The dropdown items may vary based on the user settings and permissions available, but this section should always include a “Log out” option at the bottom of the dropdown list.
  • If a Language Selector exists, it should appear in this dropdown menu as well.

General Considerations


In some cases, badges may be used with the icons in the masthead to provide the user with additional information. Image of masthead details

  • Some examples include showing new notifications are available, or showing the number of items currently in a shopping cart.
  • In responsive states, most masthead icons will be collapsed into the responsive state, but any icons that use badges should remain in the masthead for easier access.

Hamburger Menu

In smaller viewport sizes, the hamburger menu should list all primary navigation items, followed by the items from the masthead (except for badged items like notifications and shopping cart which should remain in the masthead if possible).

Masthead items should be listed based on their order in the masthead from left to right. For instance, based on the example images, the hamburger menu would be the following from top to bottom: Category 1, Category 2, Category 3, Help, User. Where Category 1, Category 2, and Category 3 are items from the primary navigation of the application.

Image of masthead details

Any masthead options that have a dropdown should be displayed in the hamburger menu as fly-outs just as for other secondary pages.

Masthead Items

Icon only

If the item is a plain icon or icon with badge, use an image only. Do not use a caret next to an image, do not use a single image and a image with caret together on masthead.

Image of masthead details


If the item is a text or a button, use a caret on the right side of the text. Do not use text only.

Image of masthead details

Icon with text

If the item is an icon with text, use a caret on the right side of the icon.

Image of masthead details


Menus appears under the masthead bottom edge. The menu box should be right aligned with the light gray background selected state.

Image of masthead details


When the user clicks the menu item, the item and the background selected state will be highlighted to visually indicate when a user hovers or selects a menu label from the Masthead. This will help the user focusing on the current context.

Image of masthead details

Code icon

PatternFly Core Example Not Available

There is no PatternFly-Core code available for this pattern at this time. Links to the JS framework implementations can be seen above.

Visit the Contributing to PatternFly documentation to learn how to contribute the code.