> 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: Palette Component

## Article: Palette Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/form/palette-component.md

## Article Content:

# Palette

_Components/Form/Palette_

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

## Overview

```jsx
<StorybookComponents.Stack height="30px" width="75%">
  <Palette
    fill={[
      'rgb(50, 132, 144)',
      'rgb(50, 183, 198)',
      'rgb(146, 224, 225)',
      'rgb(203, 246, 255)',
      'rgb(255, 255, 255)',
    ]}
  />
</StorybookComponents.Stack>;
```

Palette displays a set of colors.

### Do

- Use it to represent a set of solid colors, gradients or images.
- Use it to display available styles to choose from.

### Don't

- Don't use it to select a fill option from a set. Use `<Swatches/>` instead.

### Feature examples

#### Fills

Add any number of fill options inside of a palette.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <StorybookComponents.Stack height="42px">
    <Palette fill={['rgb(50, 132, 144)', 'rgb(50, 183, 198)']} />
  </StorybookComponents.Stack>
  <StorybookComponents.Stack height="42px">
    <Palette
      fill={[
        'rgb(50, 132, 144)',
        'rgb(50, 183, 198)',
        'rgb(146, 224, 225)',
        'rgb(203, 246, 255)',
        'rgb(255, 255, 255)',
      ]}
    />
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

#### Type

Accepts following \`fill types\`:\
 - \`solid color\`\
 - \`gradient\`\
 - \`image\`

```jsx
<StorybookComponents.Stack flexDirection="column">
  <StorybookComponents.Stack height="30px">
    <Palette
      fill={['rgb(50, 132, 144)', 'rgb(50, 183, 198)', 'rgb(146, 224, 225)']}
    />
  </StorybookComponents.Stack>
  <StorybookComponents.Stack height="30px">
    <Palette
      fill={[
        'linear-gradient(to right, #8364e8, #d397fa)',
        'linear-gradient(to right, #0061ff, #60efff)',
        'linear-gradient(to right , #099773, #87f4b5)',
      ]}
    />
  </StorybookComponents.Stack>
  <StorybookComponents.Stack height="30px">
    <Palette
      fill={[
        <Image src="PatternExample1.jpg" borderRadius={0} />,
        <Image src="PatternExample2.jpg" borderRadius={0} />,
        <Image src="PatternExample3.jpg" borderRadius={0} />,
      ]}
    />
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

#### Dimensions

Control component dimensions with a parent container. Component have no dimensions of its own - It inherits the width and height of a container it is wrapped to.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <StorybookComponents.Stack height="42px">
    <Palette
      fill={[
        'rgb(50, 132, 144)',
        'rgb(50, 183, 198)',
        'rgb(146, 224, 225)',
        'rgb(203, 246, 255)',
        'rgb(255, 255, 255)',
      ]}
    />
  </StorybookComponents.Stack>
  <StorybookComponents.Stack height="24px" width="40%">
    <Palette
      fill={[
        'rgb(50, 132, 144)',
        'rgb(50, 183, 198)',
        'rgb(146, 224, 225)',
        'rgb(203, 246, 255)',
        'rgb(255, 255, 255)',
      ]}
    />
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

### Common use case examples

#### Form Field

Use `<FormField/>` to give the palette a label.

```jsx
<FormField label="Mellow Salmon">
  <Box height="24px" width="50%">
    <Palette
      fill={[
        'rgb(84, 84, 84)',
        'rgb(229, 150, 111)',
        'rgb(252, 225, 207)',
        'rgb(254, 194, 130)',
        'rgb(255, 255, 255)',
      ]}
    />
  </Box>
</FormField>;
```

#### Thumbnail

Create a selection of palette using `<Thumbnail/>` component.

```jsx
() => {
  const [selected, setSelected] = React.useState(0);

  return (
    <Layout>
      <Cell span={6}>
        <FormField label="Select a palette">
          <Layout gap="12px">
            <Cell span={12}>
              <Thumbnail
                selected={selected === 0}
                onClick={() => setSelected(0)}
              >
                <Box height="30px">
                  <Palette
                    fill={[
                      '#003049',
                      '#d62828',
                      '#f77f00',
                      '#fcbf49',
                      '#f3dfc1',
                    ]}
                  />
                </Box>
              </Thumbnail>
            </Cell>
            <Cell span={12}>
              <Thumbnail
                selected={selected === 1}
                onClick={() => setSelected(1)}
              >
                <Box height="30px">
                  <Palette
                    fill={[
                      '#6d2e46',
                      '#a26769',
                      '#c09891',
                      '#cebebe',
                      '#f4dbd8',
                    ]}
                  />
                </Box>
              </Thumbnail>
            </Cell>
          </Layout>
        </FormField>
      </Cell>
    </Layout>
  );
};
```

#### Composer

Use a palette in a variety of composer side panels to allow users to select themes for their designs.

```jsx
() => {
  const [selected, setSelected] = React.useState(0);

  return (
    <SidePanel>
      <SidePanel.Header title="Theme" />
      <SidePanel.Content>
        <Layout gap="12px">
          <Cell span={12}>
            <Text>Current theme</Text>
            <Thumbnail selected={selected === 0} onClick={() => setSelected(0)}>
              <Box padding="12px" direction="vertical">
                <FormField label="Palette 1">
                  <Box height="24px">
                    <Palette
                      fill={[
                        '#000000',
                        '#E43510',
                        '#D6CEDF',
                        '#0227CF',
                        '#00CE83',
                      ]}
                    />
                  </Box>
                </FormField>
              </Box>
            </Thumbnail>
          </Cell>
          <Cell span={12}>
            <Box paddingTop="24px">
              <Text>Featured themes</Text>
            </Box>
          </Cell>
          <Cell span={12}>
            <Thumbnail selected={selected === 1} onClick={() => setSelected(1)}>
              <Box padding="12px" direction="vertical">
                <FormField label="Palette 2">
                  <Box height="24px">
                    <Palette
                      fill={[
                        '#000000',
                        '#C97D7C',
                        '#637EB3',
                        '#5EA6B0',
                        '#DFC2B8',
                      ]}
                    />
                  </Box>
                </FormField>
              </Box>
            </Thumbnail>
          </Cell>
          <Cell span={12}>
            <Thumbnail selected={selected === 2} onClick={() => setSelected(2)}>
              <Box padding="12px" direction="vertical">
                <FormField label="Palette 2">
                  <Box height="24px">
                    <Palette
                      fill={[
                        '#F2F2F2',
                        '#FFC824',
                        '#E68E93',
                        '#FD773F',
                        '#A01F25',
                      ]}
                    />
                  </Box>
                </FormField>
              </Box>
            </Thumbnail>
          </Cell>
        </Layout>
      </SidePanel.Content>
      <SidePanel.Footer>
        <Box align="right" gap="12px">
          <Button priority="secondary">Cancel</Button>
          <Button>Save</Button>
        </Box>
      </SidePanel.Footer>
    </SidePanel>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `fill` | `ReactNode[]` | — | Defines an array of fill items for the palette. Accepts solid colors, gradients or images. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `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.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.326.0** (2026-09-17) — 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.289.0** (2026-06-17) — maintenance release, no component-specific 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.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.207.0** (2025-07-24) — maintenance release, no component-specific changes
- **1.151.0** (2025-01-07) — 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