Title: ColorPicker
Published: March 9, 2021
Last modified: October 14, 2026

---

# ColorPicker

## In this article

 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#usage)
 * [Props](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#props)
    - [color: string](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#color-string)
    - [onChange: (hex8Color: string) => void](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#onchange-hex8color-string-void)
    - [enableAlpha: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#enablealpha-boolean)
    - [defaultValue: string | undefined](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#defaultvalue-string-undefined)
    - [copyFormat: ‘hex’ | ‘hsl’ | ‘rgb’ | undefined](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#copyformat-hex-hsl-rgb-undefined)

`ColorPicker` is a color picking component based on `react-colorful`. It lets you
pick a color visually or by manipulating the individual RGB(A), HSL(A) and Hex(8)
color values.

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#usage)󠁿

    ```language-jsx
    import { useState } from 'react';
    import { ColorPicker } from '@wordpress/components';

    function Example() {
        const [color, setColor] = useState();
        return (
            <ColorPicker
                color={color}
                onChange={setColor}
                enableAlpha
                defaultValue="#000"
            />
        );
    }
    ```

## 󠀁[Props](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#props)󠁿

### 󠀁[color: string](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#color-string)󠁿

The current color value to display in the picker. Must be a hex or hex8 string.

 * Required: No

### 󠀁[onChange: (hex8Color: string) => void](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#onchange-hex8color-string-void)󠁿

Fired when the color changes. Always passes a hex or hex8 color string.

 * Required: No

### 󠀁[enableAlpha: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#enablealpha-boolean)󠁿

When `true` the color picker will display the alpha channel both in the bottom inputs
as well as in the color picker itself.

 * Required: No
 * Default: `false`

### 󠀁[defaultValue: string | undefined](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#defaultvalue-string-undefined)󠁿

An optional default value to use for the color picker.

 * Required: No
 * Default: `'#fff'`

### 󠀁[copyFormat: ‘hex’ | ‘hsl’ | ‘rgb’ | undefined](https://developer.wordpress.org/block-editor/reference-guides/components/color-picker/?output_format=md#copyformat-hex-hsl-rgb-undefined)󠁿

The format to copy when clicking the displayed color format.

 * Required: No

First published

March 9, 2021

Last updated

October 14, 2026

Edit article

[ Improve it on GitHub: ColorPicker ](https://github.com/WordPress/gutenberg/edit/trunk/packages/components/src/color-picker/README.md)

[  Previous: ColorPalette](https://developer.wordpress.org/block-editor/reference-guides/components/color-palette/)

[  Next: ComboboxControl](https://developer.wordpress.org/block-editor/reference-guides/components/combobox-control/)