FullScreenModalLayout.Header

Components/Overlays/FullScreenModalLayout

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/fullscreenmodallayout-header

Overview

Copy

The FullScreenModalLayout.Header is the top section of the full screen modal. It holds key actions that help users understand where they are and what they can do next.

It stays fixed at the top of the screen while the user scrolls through the content below, making the most important controls always accessible.

Do

  • Use the header to clearly communicate the purpose of the modal.
  • Keep actions simple and predictable. For example: Close, Back, Save.
  • Use ellipsis on long titles to prevent wrapping. Ellipsis property is applied on <Text/>
  • Use subtitles to provide additional context.

Don't

  • Do not overload the header with too many actions.
  • Don't use long titles that wrap to multiple lines.
  • Don't include complex layouts or content in the header. Keep it lightweight.

Feature examples

Title

Use the title to communicate the main purpose of the modal.

For long titles, ensure that <Text/> is using ellipsis property.

The title can be removed when the modal doesn't require the context for the user.

Copy

Actions

Header has two slots:

  1. startNode
  2. endNode

These slots are nodes that you can use for any component

Copy

Subtitle

Subtitle text should be used to provide more context to user.

For subtitle use small secondary text

Copy

Code

Copy

Props

NameTypeDefaultDescription
childrenReactNode—The main content node (e.g. title)
dataHookstring—Applies a data-hook HTML attribute that can be used in tests.
endNodeReactNode—The right node (in LTR)
startNodeReactNode—The left node (in LTR)

Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

Changelog

No released changes have been recorded for this component.

Last updated: 28 October 2026

Did this help?