Overview
Go Headless

Changelog

Wix Design System (WDS)
Introduction
About Wix Design System
Get started developing
Get started designing
Theming
Wix Design System AI

Guidelines
Themes
Interaction & Behavior
Guidelines
Localization

Patterns
Patterns Overview
Table Pattern
Grid Switch Pattern
Grid Pattern

Foundations
Tokens and Theming basics
Icon Theming

Contributing
AI-Assisted Development
Component Structure
Contributing to Wix Design System
Creating a New Component
Creating a Pull Request
Deprecating a Component
Documenting
Fixing a Bug
Test Drivers
Contributing Tokens
Token Migration Guidelines
Updating Props
Writing Tests

Components
Actions
Animations
Charts
Feedback
Form
Layout
Lists
Mechanisms
Media
Navigation
Overlays
Drawer Component
FloatingHelper Component
FullScreenModalLayout
Modal
Modal Component
AnnouncementModalLayout Component
CustomModalLayout Component
MessageModalLayout Component
ModalMobileLayout Component
ModalPreviewLayout Component
Popover Component
PopoverMenu Component
SidePanel Component
Tooltip Component
Panels
Typography
In This Article

  1. Overview
  2. Code
  3. Testkit
  4. Changelog

ModalMobileLayout

Components/Overlays/Modal/ModalMobileLayout

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

Overview

Use modal mobile layout inside a <Modal/> to display content on mobile screens. You can add a title and a footer with actions related to the content.

Do

  • Use it for modals on mobile screens.
  • Make the title and footer sticky when the content scrolls, so they stay in view.
  • Use the fullscreen layout when the content is long.

Don't

  • Don't use it on desktop screens. Use <MessageModalLayout/> or <CustomModalLayout/> instead.
  • Don't hide the close button unless the footer gives users another way to close the modal.

Feature examples

Plain Example

A simple example with short content and buttons in the footer.

Copy

Title

Copy

Sticky Title

Copy

Footer

Copy

Sticky Footer

Copy

Close Button

Copy

Common use case examples

Default Template

Copy

Fullscreen Template

Copy

Code

Copy

Props

NameTypeDefaultDescription
contentReactNode—Accepts any content to render in the body of the modal.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
footerReactNode—Accepts any content to render in the footer of the modal.
fullscreenboolean—If true, the modal takes up the whole screen.
onCloseButtonClickMouseEventHandler—Defines a callback function which is called when the close button is clicked. The close button is displayed only when this prop is provided.
onOverlayClick() => void—Defines a callback function which is called when the overlay around the modal is clicked. Applies only when the modal isn't fullscreen.
stickyFooterboolean—If true, the footer is sticky to the bottom of the modal.
stickyTitleboolean—If true, the title is sticky to the top of the modal.
titleReactNode—Sets the title displayed in the header strip of the modal.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
titleGets the title node
getTitle—
contentGets the content node
getContentGets the content node
getFooterGets the footer node
footerGets the footer node
clickOverlayClicks on the overlay
clickCloseButtonClicks on the close button
closeButtonExistsChecks whether close button exist
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.331.0 (2026-10-01) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.322.0 (2026-09-09) — maintenance release, no component-specific changes
  • 1.321.0 (2026-09-08) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — fix: fixed issue with title not wrapping (#16109) — has visual changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.253.0 (2026-01-30) — maintenance release, no component-specific changes
  • 1.250.0 (2026-01-27) — maintenance release, no component-specific changes
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.133.0 (2024-10-14) — maintenance release, no component-specific changes
  • 1.111.0 (2024-06-26) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?