> ## 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.

# product_list

> Field type product_list — lista de UUIDs de produtos.

# `product_list`

| | |
| - | - |
| **type** | `product_list` |
| **Valor salvo** | `string[]` — UUIDs |

O lojista escolhe vários produtos. O tema recebe uma lista de ids.

## Propriedades

O validador exige `id` e `type`. `label` é recomendado. `max` limita o picker. Se omitir `max`, o editor usa 10 (`FieldProductListPicker`). Limpar a seleção grava `[]`.

Cada id se resolve com `storefront.products.get`. O setting não traz título nem preço.

## Exemplo

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "products",
  "type": "product_list",
  "label": "Produtos",
  "max": 8
}
```

## Runtime

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
const refs = settings.products ?? [];
// Resolver cada ref via storefront.products.get(ref)
```

Cookbook canônico: [Product Card](https://docs-loja.usecorvex.com.br/cookbook/product-card.md) (`defineSectionData` + grid).

Para listagens dinâmicas sem picker, preferir `schema.data: ['products']` ou `storefront.products.list()`.


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