Corvex — Temas

Referência normativa dos field types estáveis para settings[] em schemas de section, block e theme settings. Contrato base: Schema Contract. 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
`textarea`	`string`	textarea
`richtext`	`string` (HTML)	richtext
`number`	`number`	number
`range`	`number`	range
`color`	`string` (hex)	color
`checkbox`	`boolean`	checkbox
`select`	`string`	select
`radio`	`string`	radio
`image`	`string` (URL)	image
`image_picker`	`string` (URL)	alias de `image` no Editor
`url`	`string`	url
`product`	`string` (UUID do picker)	product
`product_list`	`string[]`	product_list
`collection`	`string` (UUID do picker)	collection
`collection_list`	`string[]`	collection_list
`font_picker`	`string` (família)	font_picker
`color_scheme`	`string` (scheme id)	color_scheme
`menu`	`string` (handle)	menu
`header`	— (sem valor)	header
`paragraph`	— (sem valor)	paragraph

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

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 — 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).

Veja também