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

# Theme Settings

> How ThemeDocument settings flow from the Builder into rendering.

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

<Warning>
  Settings are presentation data. Do not store secrets or reproduce pricing,
  stock, payment, or checkout rules in them.
</Warning>