Intro

The page header is a crucial component of any application interface, serving as the first point of interaction for users. A well-designed header not only enhances navigation but also sets the tone for the entire user experience. This guideline is based on the dynamic page header, which offers a flexible structure and interaction capabilities to support a variety of application scenarios.

Page header

When to Use

Do

Apply the page header guidance for the following page types:

  • Object list (list report)
  • Analytical list
  • Object page
  • Guided process (wizard)
  • Create page
  • Overview
  • Dashboard

Don't

Don’t apply the page header guidance for the following page types:

  • Home page and pages with a banner
  • Pages that use a canvas or canvas-like element as the main UI, such as a spreadsheet or calendar.
  • Other page types that aren't mentioned in the "Do" list.

Anatomy

Page header areas

  1. Header title: The title area hosts the mandatory page title and the common, but optional elements – breadcrumbs, subtitle/summary, key information, and actions. When the header collapses, the title area remains visible, with the page title and actions always persistent. The contents can adapt between expanded and collapsed modes (for example, a list report can show the filter summary in the subtitle when collapsed).
  2. Header content: A collapsible area which can hold any structured or unstructured content. The entire content is hidden when the header is collapsed.

Anatomy of page header areas

Page header elements

  1. Title: A title describes the purpose and/or the contents of the page.
  2. Breadcrumbs (optional): A breadcrumb is a type of secondary navigation that indicates the position of a page within the application hierarchy.
  3. Key information (optional): Key information is a dedicated section that showcases essential indicators of the page contents, such as KPIs or object status.
  4. Global actions (optional): Actions relevant for the entire page appear on the right-hand side of the header title bar. For more information, see header toolbar.
  5. Layout actions (optional): Typical layout actions are the Close, Full Screen, or Exit Full Screen icons, which are mainly used when a page is presented in a flexible column layout.
  6. Header feature (optional): Controls to expand/collapse and pin/unpin the header content. These controls are hidden if the header content area isn’t used.
  7. Header content (optional): The content varies based on the use case and floorplan. This area is used to display contextual information about the object or filters relevant to the page content. It’s hidden when the header is collapsed.
  8. Subtitle/summary (optional): A subtitle is a secondary text that supports the main title. It can also be used to display summarized header content, such as applied filters, when the header is collapsed.

Elements of a page header

Behavior and Interaction

Since the page header is part of the dynamic page layout, it follows the same interaction patterns.

For more details on page header behavior and interactions, see the dynamic page layout.

Expand and collapse

The page header supports expanded and collapsed modes. In the expanded mode, users can see more page-level information in the header. In the collapsed state, the header content area is hidden and the title shrinks, freeing vertical space for the page content. The page-level messages remain visible until the user dismisses them manually.

Pin

Activating the pin feature keeps the header expanded while the user scrolls through the page content. This interaction works only in combination with expandable/collapsible header content.

To save vertical space, don’t offer the pin feature for size S screens.

Dynamic page header with pin feature activated

guideline
To save vertical space, don’t offer the pin feature for size S screens.

Responsive Behavior

The page header adapts automatically to all screen sizes based on the responsive spacing system. For more details on page header responsiveness, see the dynamic page layout.

Title and subtitle

The title and subtitle truncate in collapsed mode to save vertical space and wrap in expanded mode to show the full text. This behavior is provided by the respective controls. We recommend a maximum of two lines in collapsed mode to avoid an oversized header, especially on mobile when no summary line is present. Those two lines can be either a title with a subtitle, or a single longer title that wraps to two lines.

The title has the highest priority for space allocation. Elements that share the same horizontal space, such as key information and actions, move to overflow before the title wraps or truncates.

For more information, see Wrapping and Truncation.

Title and subtitle wrap in expanded mode and truncate in collapsed mode

Key information

Key information, such as a generic tag or KPI (middle area, left-aligned), remains visible as long as possible before moving into the overflow. If no key information is present, the title and global actions automatically receive more space.

Key Information remains visible

guideline
Be mindful of the space available for key information. To avoid excessive truncation or wrapping of the page title and to prevent key information from being hidden in overflow, use header content if multiple indicators need to be displayed.

Global actions

Global actions also remain visible as space allows.

The toolbar follows standard overflow behavior, moving actions into the overflow menu from right to left.

For more information, see Toolbar.

Global action in overflow

Layout actions

The placement of layout actions depends on the page width:

This breakpoint is based on the page width, not the window width, and applies regardless of whether the page is used in the flexible column layout, on desktop, or on mobile.

Size L: Layout actions next to global actions

Size S: Layout actions above global actions

Best Practices

Title

Every application page must have a visible title in the page header that describes its topic and purpose.

Make the title concise. Remove non-essential words to improve scannability and to avoid excessive wrapping or truncation when space is limited.

If using an object name or ID as the title, ensure it’s identifiable. Add the type before the name/ID to help the user identify the object, if needed. Use the format "Object type: <Object name/ID>". For example, "Order: A100201".

There are two types of title in page header:

A. Static: A simple, static text title in the page header.
B. Dynamic: A title that contains dynamic elements, such as variant management.

Page title types

Accessibility requirements

Every page must have a single static <h1> heading that describes its topic and purpose. Dynamic elements – such as variant management components or input fields – don’t qualify, because their labels change, and assistive technologies can’t rely on them to identify the page.

The <h1> can be visible or visually hidden, but it must always be present in the DOM. If a visible heading suits the design, add a simple text title (<h1>) alongside the dynamic element. If a visible heading doesn’t fit, insert an <h1> at the top of the page using a screen-reader-only technique. The heading won’t appear on screen but remains fully accessible to assistive technologies.

Page-level avatar

You can add a page-level avatar to the page header title area or header content area.

Use a size S avatar before the page title and subtitle in the title area. In the header content area, pick the size based on the other elements.

Use only one avatar per header in expanded and collapsed modes.

For more information, see Avatar.

Page-level avatar in collapsed mode

Global actions

The global actions toolbar located in the page header contains actions that are valid for the entire page, except for the closing and finalizing actions that end the current process.

For more information, see Toolbar.

Global actions in the page header

Page-level breadcrumbs

Presenting the current page in breadcrumbs is optional but must be consistent across all pages within a product.

In applications with a fixed hierarchy, use static breadcrumbs. These breadcrumbs always display the current page location the same way, regardless of how the user arrives there.

Consistent presentation of breadcrumbs throughout the product helps users orient themselves and sets clear expectations. Breadcrumbs should consistently start from the same hierarchy level to improve usability.

Use the breadcrumb patterns described below for each navigation level.
Note: Underscore indicates a navigable link.

&#x3C;p&#x3E;&#x3C;div&#x3E; &#x3C;div&#x3E;&#x3C;strong&#x3E;Use Case&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;div&#x3E;&#x3C;strong&#x3E;Breadcrumb Pattern&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;div&#x3E;On &#x3C;strong&#x3E;home page&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;div&#x3E;No breadcrumb&#x3C;/div&#x3E; &#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;div&#x3E;&#x3C;strong&#x3E;Multiple tab pages on the home page&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;div&#x3E;Don&#x27;t show a breadcrumb on the &#x3C;strong&#x3E;selected tab page&#x3C;/strong&#x3E;.&#x3C;/div&#x3E; &#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;div&#x3E;&#x3C;strong&#x3E;Navigation item (L1)&#x3C;/strong&#x3E; in the side navigation menu is &#x3C;strong&#x3E;navigational&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;p&#x3E;On &#x3C;strong&#x3E;L1 landing page:&#x3C;/strong&#x3E;&#x3C;br&#x3E;&#x3C;u&#x3E;Home&#x3C;/u&#x3E; / Current page (L1 item)&#x3C;/p&#x3E; &#x3C;p&#x3E;On a &#x3C;strong&#x3E;navigation subitem (L2) landing page:&#x3C;/strong&#x3E;&#x3C;br&#x3E;&#x3C;u&#x3E;Home&#x3C;/u&#x3E; / &#x3C;u&#x3E;L1 item&#x3C;/u&#x3E; / Current page (L2 item)&#x3C;/p&#x3E; &#x3C;p&#x3E;Drilling down to the &#x3C;strong&#x3E;subsequent child page:&#x3C;/strong&#x3E;&#x3C;br&#x3E;&#x3C;u&#x3E;Home&#x3C;/u&#x3E; / &#x3C;u&#x3E;L1 item&#x3C;/u&#x3E; / &#x3C;u&#x3E;L2 item&#x3C;/u&#x3E; / Current page&#x3C;/p&#x3E; &#x3C;p&#x3E; &#x3C;picture&#x3E; &#x3C;source type=&#x22;image/webp&#x22; srcset=&#x22;/content/dam/sapcom/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media1_1c7ad8227c6d4cf76922d836b1a41e68ad8a2328d.png?width=2000&#x26;format=webply&#x26;optimize=medium&#x22; media=&#x22;(min-width: 600px)&#x22;&#x3E; &#x3C;source type=&#x22;image/webp&#x22; srcset=&#x22;./media_1c7ad8227c6d4cf76922d836b1a41e68ad8a2328d.png?width=750&#x26;format=webply&#x26;optimize=medium&#x22;&#x3E; &#x3C;source type=&#x22;image/png&#x22; srcset=&#x22;./media_1c7ad8227c6d4cf76922d836b1a41e68ad8a2328d.png?width=2000&#x26;format=png&#x26;optimize=medium&#x22; media=&#x22;(min-width: 600px)&#x22;&#x3E; &#x3C;img loading=&#x22;lazy&#x22; alt=&#x22;&#x22; src=&#x22;&#x3C;a href=&#x22;https://www.sap.com/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media%5C_1c7ad8227c6d4cf76922d836b1a41e68ad8a2328d.png?width=750%5C&#x26;format=png%5C&#x26;optimize=medium&#x22;&#x3E;https://www.sap.com/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media_1c7ad8227c6d4cf76922d836b1a41e68ad8a2328d.png?width=750&#x26;format=png&#x26;optimize=medium&#x3C;/a&#x3E;&#x22; width=&#x22;1779&#x22; height=&#x22;866&#x22;&#x3E; &#x3C;/picture&#x3E; &#x3C;/p&#x3E; &#x3C;p&#x3E;&#x3C;em&#x3E;Breadcrumb examples when L1 is navigational&#x3C;/em&#x3E;&#x3C;/p&#x3E; &#x3C;/div&#x3E; &#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;div&#x3E;&#x3C;strong&#x3E;Navigation item (L1)&#x3C;/strong&#x3E; in the side navigation menu is &#x3C;strong&#x3E;not navigational&#x3C;/strong&#x3E;&#x3C;/div&#x3E; &#x3C;div&#x3E; &#x3C;p&#x3E;On a &#x3C;strong&#x3E;navigation subitem (L2) landing page:&#x3C;/strong&#x3E;&#x3C;br&#x3E;&#x3C;u&#x3E;Home&#x3C;/u&#x3E; / L1 item: Current page (L2 item)&#x3C;/p&#x3E; &#x3C;p&#x3E;Drilling down &#x3C;strong&#x3E;from L2 landing page to an object:&#x3C;/strong&#x3E;&#x3C;br&#x3E;&#x3C;u&#x3E;Home&#x3C;/u&#x3E; / &#x3C;u&#x3E;L1 item: L2 item&#x3C;/u&#x3E; / Current page (object)&#x3C;/p&#x3E; &#x3C;p&#x3E; &#x3C;picture&#x3E; &#x3C;source type=&#x22;image/webp&#x22; srcset=&#x22;/content/dam/sapcom/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media1_1cd7e1817c291ba3efccc718adab80dfb3b8bd6de.png?width=2000&#x26;format=webply&#x26;optimize=medium&#x22; media=&#x22;(min-width: 600px)&#x22;&#x3E; &#x3C;source type=&#x22;image/webp&#x22; srcset=&#x22;./media_1cd7e1817c291ba3efccc718adab80dfb3b8bd6de.png?width=750&#x26;format=webply&#x26;optimize=medium&#x22;&#x3E; &#x3C;source type=&#x22;image/png&#x22; srcset=&#x22;./media_1cd7e1817c291ba3efccc718adab80dfb3b8bd6de.png?width=2000&#x26;format=png&#x26;optimize=medium&#x22; media=&#x22;(min-width: 600px)&#x22;&#x3E; &#x3C;img loading=&#x22;lazy&#x22; alt=&#x22;&#x22; src=&#x22;&#x3C;a href=&#x22;https://www.sap.com/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media%5C_1cd7e1817c291ba3efccc718adab80dfb3b8bd6de.png?width=750%5C&#x26;format=png%5C&#x26;optimize=medium&#x22;&#x3E;https://www.sap.com/design-system/fiori-design-web/v1-145/page-types/page-layouts/page-header/media_1cd7e1817c291ba3efccc718adab80dfb3b8bd6de.png?width=750&#x26;format=png&#x26;optimize=medium&#x3C;/a&#x3E;&#x22; width=&#x22;1779&#x22; height=&#x22;666&#x22;&#x3E; &#x3C;/picture&#x3E; &#x3C;/p&#x3E; &#x3C;p&#x3E;&#x3C;em&#x3E;Breadcrumb examples when L1 is not navigational&#x3C;/em&#x3E;&#x3C;/p&#x3E; &#x3C;/div&#x3E; &#x3C;/div&#x3E;&#x3C;/p&#x3E;

You can include an additional link before the breadcrumbs for quick access to a previously visited page that isn’t part of the current hierarchy.

Use a descriptive label like Back to Project XYZ to specify the destination.

If you need a persistent back button that functions like the browser back button but can’t depend on the browser’s back button, use the back button in the shell bar.

Breadcrumb example with an extra “Back to” link

Header content

Depending on the use case, the header can include various elements such as filters, charts, or forms. See Use Cases and Page Types.

If no extra header content is required, use a single, static header without expand/collapse functionality.

No header content, without expand/collapse feature

Use Cases and Page Types

The page header can display different elements based on the use cases or page types. The following are some of the common use cases.

List report (object list)

A list report page enables users to view and manage a large collection of items. Users can locate and interact with relevant items using the search and filter options in the page header. It often serves as an entry point for navigating to item details, which are typically displayed on an object page.

Use the object type in plural form as the page title (for example, Purchase Orders). If variant management is used, provide a meaningful, descriptive label for the default view, such as Active Orders.

Mandatory elements

  • Title (text, variant Management, or both)
  • Subtitle (show filter summary when the header is collapsed)

Optional elements

  • Breadcrumbs
  • Key information (KPIs, generic tags)
  • Global actions
  • Header content (search, filter or smart filter bar)
  • Header features (pin, expand/collapse)

For more information, see List Report Floorplan.

Example of a list report page header with a filter bar

Analytical list page

An analytical list page enables users to analyze large datasets, identify root causes, and take action on transactional content. It helps users find interesting areas within datasets or significant individual instances through data visualization and business intelligence. A visual filter bar, consisting of a set of interactive charts, offers a unique way to filter large datasets via visualization and is included in the page header.

Use the object type in plural form as the page title (for example, Suppliers). If variant management is used as the page title, provide a meaningful, descriptive label for the default view, such as Active Suppliers.

Mandatory Elements

  • Title (text, variant management, or both)
  • Subtitle (show filter summary when the header is collapsed)

Optional Elements

  • Breadcrumbs
  • Key information (KPIs, generic tags)
  • Global actions
  • Header contents (visual filter bar, filter bar)
  • Header feature (pin, expand/collapse)

For more information, see Analytical List Page Floorplan.

Example of an analytical list page header with a visual filter bar and filter toggle

Object page

The object page displays and organizes all relevant information about an object. It can be in display or edit mode. The page header provides context to help the user identify the object shown and the actions they can take.

Use the object name or object ID directly as the page title. If the object name or ID is unclear, append the object type in front to provide the context (for example, Order Item: 019204X), or use the subtitle for context.

Mandatory Elements

  • Title (text)

Optional Elements

  • Breadcrumbs
  • Subtitle
  • Key information
  • Global actions
  • Header content (form, text, avatar, key value, micro chart, progress indicator, rating indicator)

For more information, see Object Page Floorplan.

Example of an object page header with context information

Wizard page

A wizard page assists users in completing lengthy or complex tasks by dividing them into sections and guiding them step-by-step. It includes two types of screens: walkthrough screens and a summary screen. A progress bar, which can be either in anchor or tab mode, is located just below the page header to help users follow their progress. When an anchor bar is used, the summary page appears as a separate screen. With a tab bar, the summary is usually the final step. Typically, use a wizard page for tasks with 3 to 8 steps.

If the wizard page is used to create new object, use the format, New <Object Type>, as the page title. For example, New Customer. If the wizard page is used to walk users through a complex process, use the process name as the page title. For example, Check Out.

If the wizard page is used to create a new object, use the format "New <Object Type>" as the page title (for example, New Customer). If the wizard page is used to walk users through a complex process, use the process name as the page title (for example, Check Out).

Mandatory Elements

  • Title (text)
  • Progress bar

Optional Elements

  • Breadcrumbs
  • Subtitle
  • Global actions

For more information, see Wizard Floorplan.

Example of a wizard page header with a progress bar

Create Page

A "create" page is an object page in create mode.

Use the format “New <Object Type>” as the page title (for example, New Customer). This page title can be replaced with the actual object name or object ID as soon as it is entered or generated.

Mandatory Elements

  • Title (text)

Optional Elements

  • Breadcrumbs
  • Subtitle
  • Key information (draft/version switcher)
  • Global actions

For more information, see Object Page Floorplan.

Example of a page header for a "create" object page

Guidelines

Implementation

SAPUI5

SAP Web Components

Specifications

Guidelines

Implementation

SAPUI5

SAP Web Components