Section schema and settings

One {% schema %} block defines how a section or reusable block appears in Founder Mode.

{% schema %}
{
  "name": "Feature",
  "settings": [
    { "type": "text", "id": "heading", "label": "Heading", "default": "Welcome" }
  ],
  "block_types": [],
  "allowed_blocks": [],
  "presets": [{ "name": "Feature" }]
}
{% endschema %}

Supported setting types

Text and content: text, textarea, richtext, inline_richtext, paragraph

Links and media: url, link, image, image_picker, media, video, video_url

Store resources: blog, collection, collection_picker, collection_list, link_list, page, product, product_picker

Choices: checkbox, boolean, select, radio, color_scheme, text_alignment

Design: font_picker, font_preset, range, number, color, color_scheme_group

Use header to begin a visible group of following controls. It is not itself a stored setting.

Common fields

Every stored setting needs a unique safe id, a type, a visible label and a valid default for its type. Use info for a short explanation. Numeric ranges need min, max and a positive step. Select-like controls need unique value/label options and a matching default.

Use visible_if to show a setting only when another setting makes it relevant. Visibility does not delete the saved value.

Limits

  • One complete schema block per file.
  • At most 100 settings in one list.
  • At most two nested definition levels.
  • At most 100 options for a setting.
  • Setting IDs begin with a letter and contain at most 64 letters, numbers, underscores or hyphens.
  • Reserved or unsafe IDs are rejected.

Use control packs for a genuinely repeated setting group. The visible design remains in the Liquid owner.