> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Schema overview

> Referência de field types estáveis para schemas de section, block e theme settings.

Referência normativa dos **field types estáveis** para `settings[]` em schemas de section, block e theme settings.

Contrato base: [Schema Contract](https://docs-loja.usecorvex.com.br/reference/contracts/schema.md). Fonte canônica de tipos: pacote `@corvex/theme-contract` (`STABLE_SETTING_TYPES`).

***

## Field types estáveis

Validados por `corvex validate`, import validator e Editor:

| Type | Valor salvo | Página |
| - | - | - |
| `text` | `string` | [text](https://docs-loja.usecorvex.com.br/schema/fields/text.md) |
| `textarea` | `string` | [textarea](https://docs-loja.usecorvex.com.br/schema/fields/textarea.md) |
| `richtext` | `string` (HTML) | [richtext](https://docs-loja.usecorvex.com.br/schema/fields/richtext.md) |
| `number` | `number` | [number](https://docs-loja.usecorvex.com.br/schema/fields/number.md) |
| `range` | `number` | [range](https://docs-loja.usecorvex.com.br/schema/fields/range.md) |
| `color` | `string` (hex) | [color](https://docs-loja.usecorvex.com.br/schema/fields/color.md) |
| `checkbox` | `boolean` | [checkbox](https://docs-loja.usecorvex.com.br/schema/fields/checkbox.md) |
| `select` | `string` | [select](https://docs-loja.usecorvex.com.br/schema/fields/select.md) |
| `radio` | `string` | [radio](https://docs-loja.usecorvex.com.br/schema/fields/radio.md) |
| `image` | `string` (URL) | [image](https://docs-loja.usecorvex.com.br/schema/fields/image.md) |
| `image_picker` | `string` (URL) | alias de `image` no Editor |
| `url` | `string` | [url](https://docs-loja.usecorvex.com.br/schema/fields/url.md) |
| `product` | `string` (UUID do picker) | [product](https://docs-loja.usecorvex.com.br/schema/fields/product.md) |
| `product_list` | `string[]` | [product\_list](https://docs-loja.usecorvex.com.br/schema/fields/product-list.md) |
| `collection` | `string` (UUID do picker) | [collection](https://docs-loja.usecorvex.com.br/schema/fields/collection.md) |
| `collection_list` | `string[]` | [collection\_list](https://docs-loja.usecorvex.com.br/schema/fields/collection-list.md) |
| `font_picker` | `string` (família) | [font\_picker](https://docs-loja.usecorvex.com.br/schema/fields/font-picker.md) |
| `color_scheme` | `string` (scheme id) | [color\_scheme](https://docs-loja.usecorvex.com.br/schema/fields/color-scheme.md) |
| `menu` | `string` (handle) | [menu](https://docs-loja.usecorvex.com.br/schema/fields/menu.md) |
| `header` | — (sem valor) | [header](https://docs-loja.usecorvex.com.br/schema/fields/header.md) |
| `paragraph` | — (sem valor) | [paragraph](https://docs-loja.usecorvex.com.br/schema/fields/paragraph.md) |

***

## Propriedades comuns (campos com `id`)

| Prop | Obrigatório | Descrição |
| - | - | - |
| `id` | REQUIRED | Chave em `settings` |
| `type` | REQUIRED | Field type |
| `label` | SHOULD | Label no Inspector |
| `default` | OPTIONAL | Valor inicial |
| `info` | OPTIONAL | Texto de ajuda |
| `placeholder` | OPTIONAL | Placeholder de input |
| `visibleWhen` | OPTIONAL | Visibilidade condicional no Inspector — [visibleWhen](https://docs-loja.usecorvex.com.br/schema/visible-when.md) |

***

## Tipos experimentais

O Editor também renderiza tipos ainda **não** estáveis no contrato público: `inline_richtext`, `html`, `video`, `video_url`, `page`, `blog`, `link_list`. O campo `video` tem documentação em [Biblioteca de vídeos](https://docs-loja.usecorvex.com.br/guides/video-library.md) — use com testes no Editor.

***

## Theme settings vs section settings

Os mesmos field types estáveis aplicam-se a `config/settings.schema.json` → `groups[].settings[]`.

O scaffold oficial também declara `color_schemes[]` no topo do arquivo — estrutura separada de `groups` ([Theme settings](https://docs-loja.usecorvex.com.br/themes/settings.md)).

***

## Veja também

* [Schema Contract](https://docs-loja.usecorvex.com.br/reference/contracts/schema.md)
* [Organização de schemas](https://docs-loja.usecorvex.com.br/guides/schema-organization.md)
* [Section Contract](https://docs-loja.usecorvex.com.br/reference/contracts/section.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.