---
title: "Color"
description: "This article explains what the color field is and how to configure it."
meta_title: "Color"
category: "fields"
audience: developers
lastUpdated: "2026-04-23T01:17:46.000Z"
---

The color field allows content writers to select a color. The field is displayed as a color picker in the [Page Builder](https://prismic.io/docs/guides/page-builder.md).

The color is saved as a hex value, like `#FFFFFF`.

Color field values can be used anywhere hex color values are supported.

**Next.js example:**

```tsx
<span style={{ color: slice.primary.text_color }}>Hello!</span>
```

**Nuxt example:**

```vue-html
<span :style="{ color: slice.primary.text_color }">Hello!</span>
```

**SvelteKit example:**

```svelte
<span style={`color: ${slice.primary.text_color}`}>Hello!</span>
```

# Add a color field to a content model

Color fields are added using the [Type Builder](https://prismic.io/docs/type-builder.md), a tool for building by hand, or the [Prismic CLI](https://prismic.io/docs/cli.md), a tool for AI agents.

* **Type Builder:**

  > **Important**
  >
  > Type Builder is rolling out to new users. If you do not have access, use **Slice Machine**.

  1. **Watch for changes**

     In your local website project, start the Prismic CLI's `sync` command. The CLI will watch for changes in the Type Builder and pull them into your project.

     ```sh
     npx prismic sync --watch
     ```

     > **Tip**: You can pull Type Builder changes at any time using `npx prismic
     >   sync`.

  2. **Add a color field**

     In the Type Builder, navigate to the slice, page type, or custom type you want to modify. Add a **color** field and provide the following:

     * **Label**: The label shown to content writers in the [Page Builder](https://prismic.io/docs/guides/page-builder.md). Use an easily understandable name.
     * **API ID**: The property name in the Content API. Use a short, snake-cased name.

     You can now close the Prismic CLI `sync` command or add your next field.

* **Prismic CLI:**

  > Your AI agent can perform these steps for you. See [Prismic with AI](https://prismic.io/docs/ai.md) for details.

  1. **Add a color field**

     Use the `prismic field add color` command to add a color field to a slice.

     ```sh
     npx prismic field add color text_color --to-slice MySlice
     ```

     Use `--to-type` to add the field to a page type or custom type instead.

     ```sh
     npx prismic field add color text_color --to-type page
     ```

* **Slice Machine:**

  1. **Open Slice Machine**

     In your Prismic project, start Slice Machine to begin editing content models.

     ```sh
     npx start-slicemachine --open
     ```

  2. **Add a color field**

     In Slice Machine, navigate to the slice, page type, or custom type you want to modify. Add a **color** field.

     The **label** determines the label shown to content writers in the [Page Builder](https://prismic.io/docs/guides/page-builder.md). Use an easily understandable name.

     The **API ID** determines the property name in the Content API. Use a short, snake-cased name.

# Use color fields

Color fields can be used anywhere hex color values are supported.

In this example, the `text_color` field determines the `<span>`'s color.

**Next.js example:**

```tsx
<span style={{ color: slice.primary.text_color }}>Hello!</span>
```

**Nuxt example:**

```vue-html
<span :style="{ color: slice.primary.text_color }">Hello!</span>
```

**SvelteKit example:**

```svelte
<span style={`color: ${slice.primary.text_color}`}>Hello!</span>
```

# Check if a color field has a value

Use `isFilled.color()` from [`@prismicio/client`](https://prismic.io/docs/technical-reference/prismicio-client/v7.md) to check if a color field has a value.

```ts
import { isFilled } from "@prismicio/client";

if (isFilled.color(slice.primary.my_color_field)) {
  // Do something if `my_color_field` has a value.
}
```

[Learn more about `isFilled`](https://prismic.io/docs/technical-reference/prismicio-client/v7.md#isfilled)

# API response

Here is what a color field looks like from the Content API:

```json
{
  "example_color": "#5B295F"
}
```
