Skip to main content

​
Theme Settings

Theme settings are structured data validated against the theme’s schema. Use the Theme Builder for visual editing or the CLI/API for controlled automation. Settings can cover:
  • colors, typography, spacing, and shape tokens;
  • page and block content;
  • block visibility and variants;
  • approved custom CSS.
Fetch the current settings before updating them. An update sends the complete validated settings object, so omitting an existing key may remove that value.
Settings are presentation data. Do not store secrets or reproduce pricing, stock, payment, or checkout rules in them.