> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: FullScreenModalLayout Component

## Article: FullScreenModalLayout Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/overlays/full-screen-modal-layout/full-screen-modal-layout-component.md

## Article Content:

# FullScreenModalLayout

_Components/Overlays/FullScreenModalLayout_

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

## Overview

```jsx
() => {
  const [isModalOpened, setModalOpened] = React.useState(false);

  const openModal = () => setModalOpened(true);
  const closeModal = () => setModalOpened(false);

  const ModalWithButton = ({ isOpen: isOpenProp = false, children }) => {
    const [isOpen, setIsOpen] = React.useState(isOpenProp);
    const close = React.useCallback(() => setIsOpen(false), []);

    return (
      <>
        <Button onClick={() => setIsOpen(true)}>Open Modal</Button>
        <Modal transition="moveVertical" isOpen={isOpen} onRequestClose={close}>
          {children({ isOpen, close })}
        </Modal>
      </>
    );
  };

  return (
    <ModalWithButton>
      {({ close }) => (
        <FullScreenModalLayout>
          {/* Header */}
          <FullScreenModalLayout.Header
            startNode={<CloseButton skin="dark" size="large" onClick={close} />}
          >
            <Text size="small" weight="normal" ellipsis>
              Modal Title
            </Text>
          </FullScreenModalLayout.Header>

          {/* Content */}
          <FullScreenModalLayout.Content padding>
            <Box direction="vertical" align="center" textAlign="center">
              <Box marginBottom="36px" marginTop="91px">
                <Image src="Illustration.svg" />
              </Box>

              <Box marginBottom="12px">
                <Heading size="extraLarge">Welcome!</Heading>
              </Box>

              <Box marginBottom="36px">
                <Text weight="thin" secondary>
                  First impressions count. Apps have one chance to grab a new
                  user’s attention. Use it well.
                </Text>
              </Box>

              {/* These actions were originally in content, now removed for footer */}
            </Box>
          </FullScreenModalLayout.Content>

          {/* Footer (moved actions here) */}
          <FullScreenModalLayout.Footer>
            <Box gap="12px" width="100%" direction="vertical" align="center">
              <Button size="large" fullWidth>
                Start Now
              </Button>

              <TextButton fullWidth>Learn More</TextButton>
            </Box>
          </FullScreenModalLayout.Footer>
        </FullScreenModalLayout>
      )}
    </ModalWithButton>
  );
};
```

`FullScreenModalLayout` is a mobile first layout used for push screens and full screen modals inside native looking flows.

It takes over the whole viewport, with an optional header, scrollable content, and an optional sticky footer.

### Do

- Use for focused tasks that need the user's full attention (create, edit, review).
- Use for flows that feel like a new screen in the app, not just a small dialog.
- Use the `<FullScreenModalLayout.Header/>` for page level actions like back, close, save, done.
- Use the `<FullScreenModalLayout.Footer/>` for primary actions that should always stay visible (for example "Save", "Continue").

### Don't

- Do not use on desktop. Use `<CustomModalLayout/>`, `<AnnouncementModalLayout/>`, `<MessageModalLayout/>` instead
- Do not stack multiple full screen modals on top of each other.
- Do not turn it into a generic container for everything. If content feels like a long page, consider using a regular page instead.

### Feature examples

#### Structure

`FullScreenModalLayout` is built from three components:

- `FullScreenModalLayout.Header`
- `FullScreenModalLayout.Content`
- `FullScreenModalLayout.Footer`

```jsx
() => {
  const [isOpen, setIsOpen] = React.useState(false);

  const closeModal = () => setIsOpen(false);

  return (
    <Box padding="20px" gap="20px" direction="vertical">
      <Button onClick={() => setIsOpen(true)}>Open Modal</Button>

      <Modal isOpen={isOpen} onRequestClose={closeModal}>
        <FullScreenModalLayout>
          <FullScreenModalLayout.Header
            startNode={
              <Box border="1px dashed" padding="SP2">
                1 Node slot
              </Box>
            }
            endNode={
              <Box border="1px dashed" padding="SP2">
                2 Node slot
              </Box>
            }
          >
            <Box direction="vertical" gap="SP1">
              <Text>Modal title goes here</Text>
              <Text size="small" secondary>
                Subtitle goes here
              </Text>
            </Box>
          </FullScreenModalLayout.Header>

          <FullScreenModalLayout.Content padding>
            <Box
              border="1px dashed"
              height="240px"
              padding="SP4"
              direction="vertical"
              align="space-between"
            >
              <Box direction="vertical" align="center" gap="SP2">
                <Text>Modal content starts here</Text>
                <TextButton onClick={closeModal}>Close modal</TextButton>
              </Box>
              <Text>Modal content ends here</Text>
            </Box>
          </FullScreenModalLayout.Content>

          <FullScreenModalLayout.Footer>
            <Box border="1px dashed" padding="SP3">
              <Text>Footer is sticky</Text>
            </Box>
          </FullScreenModalLayout.Footer>
        </FullScreenModalLayout>
      </Modal>
    </Box>
  );
};
```

#### Animation

Control `FullScreenModalLayout` animation styles using `Modal` transition property:

`zoomIn` (default) - the modal appears from the middle of the screen

- `moveVertical` - the modal slides in from the bottom
- `moveHorizontal` - the modal slides in from the right side of the screen

```jsx
() => {
  const ModalWithButton = ({
    isOpen: isOpenProp = false,
    buttonLabel,
    transition,
    children,
  }) => {
    const [isOpen, setIsOpen] = React.useState(isOpenProp);
    const close = React.useCallback(() => setIsOpen(false), []);

    return (
      <>
        <Button onClick={() => setIsOpen(true)}>{buttonLabel}</Button>
        <Modal transition={transition} isOpen={isOpen} onRequestClose={close}>
          {children({ isOpen, close })}
        </Modal>
      </>
    );
  };

  return (
    <StorybookComponents.Stack>
      <ModalWithButton
        buttonLabel="Horizontal transition"
        transition="moveHorizontal"
      >
        {({ close }) => (
          <FullScreenModalLayout>
            <FullScreenModalLayout.Header
              startNode={
                <CloseButton skin="dark" size="large" onClick={close} />
              }
              endNode={
                <TextButton size="small" onClick={close}>
                  Save
                </TextButton>
              }
            >
              <Text size="small" weight="normal" ellipsis>
                Modal Title
              </Text>
            </FullScreenModalLayout.Header>
            <FullScreenModalLayout.Content padding>
              <Text>This is the main content area with padding.</Text>
            </FullScreenModalLayout.Content>
            <FullScreenModalLayout.Footer>
              <Text>Footer</Text>
            </FullScreenModalLayout.Footer>
          </FullScreenModalLayout>
        )}
      </ModalWithButton>

      <ModalWithButton
        buttonLabel="Vertical transition"
        transition="moveVertical"
      >
        {({ close }) => (
          <FullScreenModalLayout>
            <FullScreenModalLayout.Header
              startNode={
                <CloseButton skin="dark" size="large" onClick={close} />
              }
              endNode={
                <TextButton size="small" onClick={close}>
                  Save
                </TextButton>
              }
            >
              <Text size="small" weight="normal" ellipsis>
                Modal Title
              </Text>
            </FullScreenModalLayout.Header>
            <FullScreenModalLayout.Content padding>
              <Text>This is the main content area with padding.</Text>
            </FullScreenModalLayout.Content>
            <FullScreenModalLayout.Footer>
              <Text>Footer</Text>
            </FullScreenModalLayout.Footer>
          </FullScreenModalLayout>
        )}
      </ModalWithButton>
    </StorybookComponents.Stack>
  );
};
```

### Common use case examples

#### Long forms

It is recommended to use `FullScreenModalLayout.Footer` for modals that are longer. This way the main actions are always visible to users

```jsx
() => {
  const [isOpen, setIsOpen] = React.useState(false);

  const openModal = () => setIsOpen(true);
  const closeModal = () => setIsOpen(false);

  return (
    <StorybookComponents.Stack>
      <Button onClick={openModal} prefixIcon={<Icons.Add />}>
        New dish
      </Button>

      <Modal
        isOpen={isOpen}
        onRequestClose={closeModal}
        transition="moveVertical"
      >
        <FullScreenModalLayout>
          {/* HEADER */}
          <FullScreenModalLayout.Header
            startNode={
              <CloseButton skin="dark" size="large" onClick={closeModal} />
            }
            endNode={
              <TextButton size="small" onClick={closeModal}>
                Save
              </TextButton>
            }
          >
            <Text size="small" weight="normal">
              New dish
            </Text>
          </FullScreenModalLayout.Header>

          {/* CONTENT */}
          <FullScreenModalLayout.Content padding>
            <Box direction="vertical" gap="24px">
              <FormField label="Image">
                <ImageViewer width="100%" height="176px" />
              </FormField>

              <FormField label="Name">
                <Input value="My New Dish" />
              </FormField>

              <FormField label="Price">
                <Input value="0" prefix={<Input.Affix>$</Input.Affix>} />
              </FormField>

              <FormField label="Description">
                <InputArea
                  placeholder="Describe your dish in a few sentences."
                  resizable
                  rows={3}
                />
              </FormField>

              <FormField
                label="Dietary preferences"
                infoContent="Choose which dietary preferences your dish is appropriate for."
              >
                <Box direction="vertical" gap="12px">
                  <Checkbox>No salt</Checkbox>
                  <Checkbox>Vegan</Checkbox>
                  <Checkbox>Vegetarian</Checkbox>
                  <Checkbox>Gluten free</Checkbox>
                  <Checkbox>Organic</Checkbox>
                  <Checkbox>Spicy</Checkbox>
                </Box>
              </FormField>

              <FormField label="Visibility">
                <Checkbox checked>Visible on site</Checkbox>
              </FormField>

              <FormField label="Availability">
                <Checkbox checked>In stock</Checkbox>
              </FormField>
            </Box>
          </FullScreenModalLayout.Content>

          {/* FOOTER */}
          <FullScreenModalLayout.Footer>
            <StorybookComponents.Stack spacing="12px" width="100%">
              <Button fullWidth priority="secondary" onClick={closeModal}>
                Cancel
              </Button>
              <Button fullWidth onClick={closeModal}>
                Create dish
              </Button>
            </StorybookComponents.Stack>
          </FullScreenModalLayout.Footer>
        </FullScreenModalLayout>
      </Modal>
    </StorybookComponents.Stack>
  );
};
```

#### Push screens

You can use `FullScreenModalLayout` as push screens

```jsx
() => {
  const [isOpen, setIsOpen] = React.useState(false);
  const [newsletter, setNewsletter] = React.useState(true);

  const open = () => setIsOpen(true);
  const close = () => setIsOpen(false);

  return (
    <StorybookComponents.Stack>
      <Button onClick={open}>Show upgrade message</Button>

      <Modal isOpen={isOpen} onRequestClose={close} transition="moveHorizontal">
        <FullScreenModalLayout>
          {/* Header */}
          <FullScreenModalLayout.Header
            startNode={<CloseButton skin="dark" size="large" onClick={close} />}
          >
            <Text size="small" weight="normal">
              Upgrade to accept payments
            </Text>
          </FullScreenModalLayout.Header>

          {/* Content */}
          <FullScreenModalLayout.Content padding>
            <Layout cols={1} alignItems="vertical" gap="24px">
              {/* Intro text */}
              <Text size="small">
                Unlock secure online payments and help your business grow with a
                Business Basic plan.
              </Text>

              {/* Benefits list */}
              <Box direction="vertical" gap="12px">
                <Text weight="bold">What you get:</Text>
                <Box direction="vertical" gap="6px">
                  <Text size="small">
                    • Accept credit and debit card payments
                  </Text>
                  <Text size="small">• Automated invoice and tax handling</Text>
                  <Text size="small">• Faster payouts to your bank</Text>
                </Box>
              </Box>

              {/* Optional settings */}
              <FormField label="Notifications">
                <ToggleSwitch
                  checked={newsletter}
                  onChange={() => setNewsletter(!newsletter)}
                />
              </FormField>

              <Box>
                <Text size="small" secondary>
                  Enabling notifications helps you stay updated on payouts and
                  payment changes.
                </Text>
              </Box>
            </Layout>
          </FullScreenModalLayout.Content>

          {/* Footer */}
          <FullScreenModalLayout.Footer>
            <StorybookComponents.Stack spacing="12px" width="100%">
              <Button fullWidth priority="secondary" onClick={close}>
                Not now
              </Button>

              <Button fullWidth skin="premium" onClick={close}>
                Upgrade
              </Button>
            </StorybookComponents.Stack>
          </FullScreenModalLayout.Footer>
        </FullScreenModalLayout>
      </Modal>
    </StorybookComponents.Stack>
  );
};
```

#### Multiple actions

```jsx
() => {
  const [shown, setShown] = React.useState(false);

  const openModal = () => setShown(true);
  const closeModal = () => setShown(false);

  return (
    <Layout>
      <Cell span={6}>
        <Card>
          <Box
            direction="vertical"
            gap="1"
            paddingTop="2"
            paddingLeft="4"
            paddingRight="4"
            paddingBottom="2"
          >
            <Text secondary>From name:</Text>
            <Text weight="bold">User 1</Text>

            <Text secondary>Reply-to email:</Text>
            <Text weight="bold">user1@mail.com</Text>
          </Box>

          <Divider />

          <Box padding="12px" align="center">
            <TextButton onClick={openModal}>Confirm Email</TextButton>
          </Box>

          {/* Full Screen Modal */}
          <Modal
            isOpen={shown}
            onRequestClose={closeModal}
            transition="moveVertical"
          >
            <FullScreenModalLayout>
              {/* HEADER */}
              <FullScreenModalLayout.Header
                startNode={
                  <CloseButton skin="dark" size="large" onClick={closeModal} />
                }
                endNode={
                  <TextButton size="small" onClick={closeModal}>
                    Change Details
                  </TextButton>
                }
              >
                <Text size="small" weight="normal">
                  Confirm your email address
                </Text>
              </FullScreenModalLayout.Header>

              {/* CONTENT */}
              <FullScreenModalLayout.Content padding>
                <StorybookComponents.Stack
                  flexDirection="column"
                  spacing="24px"
                >
                  <Text>
                    To make changes to your sender details, please confirm your
                    email address.
                    <br />A confirmation code was sent to <b>user1@mail.com</b>.
                  </Text>

                  <FormField label="Confirmation Code">
                    <Input placeholder="XX-XXX-XX" />
                  </FormField>

                  <Text>
                    Didn’t get the code? <a>Send again</a>
                  </Text>
                </StorybookComponents.Stack>
              </FullScreenModalLayout.Content>

              {/* FOOTER */}
              <FullScreenModalLayout.Footer>
                <StorybookComponents.Stack spacing="12px" width="100%">
                  <Button fullWidth onClick={closeModal}>
                    Confirm
                  </Button>

                  <Button fullWidth priority="secondary" onClick={closeModal}>
                    Cancel
                  </Button>
                </StorybookComponents.Stack>
              </FullScreenModalLayout.Footer>
            </FullScreenModalLayout>
          </Modal>
        </Card>
      </Cell>
    </Layout>
  );
};
```

## Code

```jsx
import { FullScreenModalLayout } from '@wix/design-system';
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Renders modal content. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute to be used in the tests. |
| `style` | `CSSProperties` | — |  |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { FullScreenModalLayoutUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { FullScreenModalLayoutTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { FullScreenModalLayoutTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { FullScreenModalLayoutTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `getHeaderText` | Gets the header text |
| `getContentText` | Gets the content text |
| `getFooterText` | Gets the footer text |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## Changelog

- **1.344.0** (2026-10-28) — maintenance release, no component-specific changes
- **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.0** (2026-09-28) — 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.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.305.0** (2026-07-28) — 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.271.0** (2026-04-22) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.225.0** (2025-11-07) — feat: add initial implementation ([#15464](invalid-url))