> 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: Page.Section Component

## Article: Page.Section Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/layout/page/page-section-component.md

## Article Content:

# Page.Section

_Components/Layout/Page_

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

## Overview

```jsx
<Page>
  <Page.Content>
    <Layout>
      <Cell>
        <Layout>
          <Cell>
            <Page.Section
              title="Customer management tools"
              showDivider
              actionsBar={<TextButton>View All Tools</TextButton>}
            />
          </Cell>
          <Cell span={4}>
            <Card>
              <Box padding="24px" height="90px" />
            </Card>
          </Cell>
          <Cell span={4}>
            <Card>
              <Box padding="24px" height="90px" />
            </Card>
          </Cell>
          <Cell span={4}>
            <Card>
              <Box padding="24px" height="90px" />
            </Card>
          </Cell>
        </Layout>
      </Cell>
    </Layout>
  </Page.Content>
</Page>;
```

Page section is a standalone element that divides content of a page into multiple sections.

### Do

- Use it to divide content into sections on a page.
- Use it to group grid layouts visually.

### Don't

- Don't use it to divide content into sections inside of a card.

### Feature examples

#### Structure

Component consists of a title area and actions bar (optional). Actions bar can contain any number of actions.

```jsx
<PageSection
  title="Section title"
  actionsBar={
    <StorybookComponents.Placeholder width="300px">
      Actions bar
    </StorybookComponents.Placeholder>
  }
/>;
```

#### Subtitle

Use subtitle to provide more context about section content.

```jsx
<PageSection
  title="Marketing tools"
  subtitle="Check out just a few of the marketing apps you can use to grow your business"
/>;
```

#### Divider

Use divider to visually merge elements into one entity when section content is built using grid layout.

```jsx
<PageSection title="Automations" showDivider />;
```

#### Text overflow

Both title and subtitle are limited to a single line of text. Longer values will be truncated and displayed in a tooltip on a hover.

```jsx
<PageSection
  title="Track your workflows on simple boards"
  subtitle="Manage any work process from start to finish. Track leads, contacts & orders on a simple board."
  actionsBar={<TextButton>Go to Workflows</TextButton>}
/>;
```

### Common use case examples

#### Content grouping

Use `<PageSection/>` to group elements into sections inside of a page

```jsx
<Page>
  <Page.Header
    title="Marketing Integrations"
    subtitle="Use these tools to make your marketing more effective."
    actionsBar={<Button skin="premium">Upgrade</Button>}
  ></Page.Header>
  <Page.Content>
    <Layout>
      <Cell>
        <Layout>
          <Cell span={6}>
            <Card>
              <Box height="120px" />
            </Card>
          </Cell>
          <Cell span={6}>
            <Card>
              <Box height="120px" />
            </Card>
          </Cell>
          <Cell span={6}>
            <Card>
              <Box height="120px" />
            </Card>
          </Cell>
          <Cell span={6}>
            <Card>
              <Box height="120px" />
            </Card>
          </Cell>
        </Layout>
      </Cell>
      <Cell>
        <Layout>
          <Cell>
            <Page.Section
              title="Marketing tools from the App Market"
              subtitle="Check out just a few of the marketing apps you can use to grow your business"
              showDivider
              actionsBar={<TextButton>Manage Your Apps</TextButton>}
            />
          </Cell>
          <Cell span={3}>
            <Card>
              <Box height="160px" />
            </Card>
          </Cell>
          <Cell span={3}>
            <Card>
              <Box height="160px" />
            </Card>
          </Cell>
          <Cell span={3}>
            <Card>
              <Box height="160px" />
            </Card>
          </Cell>
          <Cell span={3}>
            <Card>
              <Box height="160px" />
            </Card>
          </Cell>
        </Layout>
      </Cell>
    </Layout>
  </Page.Content>
</Page>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `actionsBar` | `ReactNode` | — | A placeholder for a component that can contain actions. |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `showDivider` | `boolean` | — | Renders a divider. |
| `subtitle` | `ReactNode` | — | The subtitle content. |
| `title` | `ReactNode` | — | The main title content. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getTitleText` | Gets PageSection title text |
| `isTitleExists` | Checks whether the PageSection title exists |
| `getSubtitleText` | Gets PageSection subtitle text |
| `isSubtitleExists` | Checks whether the PageSection subtitle exists |
| `isActionsBarExists` | Checks whether the PageHeader action bar exists |
| `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

No released changes have been recorded for this component.