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

# Visão geral

> O schema de seção permite definir atributos e configurações de seção para personalização de tema.

A tag `{% schema %}` permite definir atributos e configurações de seção para habilitar opções de personalização no editor de tema. Define como as seções aparecem, se comportam e quais opções de configuração estão disponíveis para os usuários.

Cada seção pode ter apenas uma única tag `{% schema %}`, que deve conter JSON válido usando os atributos listados abaixo. A tag pode ser colocada em qualquer lugar dentro do arquivo de seção, mas não pode ser aninhada dentro de outra tag.

> **Nota:**\
> A tag `{% schema %}` é uma tag Liquid. No entanto, ela não exibe seu conteúdo nem renderiza nenhum Liquid incluído dentro dela.

## Propriedades

<ParamField path="name" type="string">
  O título da seção mostrado no editor de tema. Pode ser traduzido usando o prefixo `t:` mais uma chave válida dos arquivos de tradução de schema. Mais detalhes podem ser encontrados em [Locales](/members-area/key-concepts/theme/locales).
</ParamField>

<ParamField path="limit" type="number" default="unlimited">
  O número máximo de vezes que uma seção pode ser adicionada a um template ou grupo de seção. O padrão é ilimitado.
</ParamField>

<ParamField path="settings" type="array">
  Um array de configurações específicas da seção que permitem aos usuários personalizar a seção. Cada configuração deve ter um ID único dentro da seção. Veja [settings](/members-area/reference/schema/fields/settings) para configuração detalhada.
</ParamField>

<ParamField path="blocks" type="array">
  Um array de módulos de conteúdo reutilizáveis que podem ser adicionados, removidos e reordenados dentro de uma seção. Cada bloco deve ter um tipo e nome únicos. Veja [blocks](/members-area/reference/schema/fields/blocks) para configuração detalhada.
</ParamField>

<ParamField path="max_blocks" type="number" default="50">
  O número máximo de blocos permitidos na seção. O padrão é 50.
</ParamField>

<ParamField path="presets" type="array">
  Configurações de seção predefinidas que os usuários podem selecionar ao adicionar seções a um template. Veja [presets](/members-area/reference/schema/fields/presets) para configuração detalhada.
</ParamField>

<ParamField path="default" type="object">
  Configuração padrão para seções renderizadas estaticamente.
</ParamField>

<ParamField path="enabled_on" type="object">
  Restringe uma seção a certos tipos de página de template e tipos de grupo de seção. Veja [template restrictions](/members-area/reference/schema/fields/template-restrictions) para configuração detalhada.
</ParamField>

<ParamField path="disabled_on" type="object">
  Impede que uma seção seja usada em certos tipos de página de template e tipos de grupo de seção. Veja [template restrictions](/members-area/reference/schema/fields/template-restrictions) para configuração detalhada.
</ParamField>

<ParamField path="kiwi_extra" type="object">
  Configurações adicionais para o editor de tema

  * `icon` - Ícone a ser associado com este tipo de seção no editor de tema
  * `blocks_hidden_if` - Objeto representando uma condição que oculta blocos de seção dentro do editor de tema se satisfeita
    * `setting` - Qual configuração desta seção verificar
    * `value` - Valor esperado para que a seção de bloco seja ocultada
</ParamField>

<Panel>
  <Tabs>
    <Tab title="Exemplo">
      ```json theme={null}
      {
        "name": "Slideshow",
        "tag": "section",
        "class": "slideshow",
        "limit": 1,
        "settings": [
          {
            "type": "checkbox",
            "id": "autoplay",
            "label": "Auto-rotacionar slides",
            "default": true
          },
          {
            "type": "range",
            "id": "speed",
            "min": 3,
            "max": 9,
            "step": 1,
            "unit": "s",
            "label": "Mudar slides a cada",
            "default": 5
          }
        ],
        "blocks": [
          {
            "type": "slide",
            "name": "Slide",
            "settings": [
              {
                "type": "image_picker",
                "id": "image",
                "label": "Imagem"
              },
              {
                "type": "text",
                "id": "heading",
                "label": "Título"
              }
            ]
          }
        ],
        "max_blocks": 10,
        "presets": [
          {
            "name": "Slideshow de imagens",
            "category": "Imagem",
            "settings": {
              "autoplay": true,
              "speed": 5
            },
            "blocks": [
              {
                "type": "slide",
                "settings": {
                  "heading": "Bem-vindo à nossa área de membros"
                }
              }
            ]
          }
        ],
        "enabled_on": {
          "templates": ["index"]
        }
      }
      ```
    </Tab>
  </Tabs>
</Panel>