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

# Overview

> The section schema allows you to define section attributes and settings for theme customization.

The `{% schema %}` tag allows you to define section attributes and settings to enable customization options in the theme editor. It defines how sections appear, behave, and what configuration options are available to users.

Each section can have only a single `{% schema %}` tag, which must contain valid JSON using the attributes listed below. The tag can be placed anywhere within the section file, but cannot be nested inside another tag.

> **Note:**\
> The `{% schema %}` tag is a Liquid tag. However, it doesn't output its contents or render any Liquid included inside it.

## Properties

<ParamField path="name" type="string">
  The section title shown in the theme editor. It may be translated using `t:` prefix plus a valid key from schema translation files. More details can be found in [Locales](/en/members-area/key-concepts/theme/locales).
</ParamField>

<ParamField path="limit" type="number" default="unlimited">
  The maximum number of times a section can be added to a template or section group. Default is unlimited.
</ParamField>

<ParamField path="settings" type="array">
  An array of section-specific settings that allow users to customize the section. Each setting must have a unique ID within the section. See [settings](/en/members-area/reference/schema/fields/settings) for detailed configuration.
</ParamField>

<ParamField path="blocks" type="array">
  An array of reusable content modules that can be added, removed, and reordered within a section. Each block must have a unique type and name. See [blocks](/en/members-area/reference/schema/fields/blocks) for detailed configuration.
</ParamField>

<ParamField path="max_blocks" type="number" default="50">
  The maximum number of blocks allowed in the section. Default is 50.
</ParamField>

<ParamField path="presets" type="array">
  Predefined section configurations that users can select when adding sections to a template. See [presets](/en/members-area/reference/schema/fields/presets) for detailed configuration.
</ParamField>

<ParamField path="default" type="object">
  Default configuration for statically rendered sections.
</ParamField>

<ParamField path="enabled_on" type="object">
  Restricts a section to certain template page types and section group types. See [template restrictions](/en/members-area/reference/schema/fields/template-restrictions) for detailed configuration.
</ParamField>

<ParamField path="disabled_on" type="object">
  Prevents a section from being used on certain template page types and section group types. See [template restrictions](/en/members-area/reference/schema/fields/template-restrictions) for detailed configuration.
</ParamField>

<ParamField path="kiwi_extra" type="object">
  Additional settings for the theme editor

  * `icon` - Icon to be associated with this section type in the theme editor
  * `blocks_hidden_if` - Object representing a condition that hides section blocks inside the theme editor if satisfied
    * `setting` - Which setting of this section to check
    * `value` - Expected value for the block section to be hidden
</ParamField>

<Panel>
  <Tabs>
    <Tab title="Example">
      ```json theme={null}
      {
        "name": "Slideshow",
        "tag": "section",
        "class": "slideshow",
        "limit": 1,
        "settings": [
          {
            "type": "checkbox",
            "id": "autoplay",
            "label": "Auto-rotate slides",
            "default": true
          },
          {
            "type": "range",
            "id": "speed",
            "min": 3,
            "max": 9,
            "step": 1,
            "unit": "sec",
            "label": "Change slides every",
            "default": 5
          }
        ],
        "blocks": [
          {
            "type": "slide",
            "name": "Slide",
            "settings": [
              {
                "type": "image_picker",
                "id": "image",
                "label": "Image"
              },
              {
                "type": "text",
                "id": "heading",
                "label": "Heading"
              }
            ]
          }
        ],
        "max_blocks": 10,
        "presets": [
          {
            "name": "Image slideshow",
            "category": "Image",
            "settings": {
              "autoplay": true,
              "speed": 5
            },
            "blocks": [
              {
                "type": "slide",
                "settings": {
                  "heading": "Welcome to our members area"
                }
              }
            ]
          }
        ],
        "enabled_on": {
          "templates": ["index"]
        }
      }
      ```
    </Tab>
  </Tabs>
</Panel>