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

# Editing Themes

> Edit, preview, and publish ThemeDocument settings safely.

# Editing Themes

The Theme Builder is the source of truth for a theme draft. Each page contains
ordered blocks with stable IDs and typed settings.

## Safe editing loop

```text theme={"system"}
inspect -> edit -> preview -> save -> publish
```

* Change only the page, block, or setting you intend to update.
* Keep block IDs stable when reordering content.
* Preview product, collection, content, and system pages that use the changed
  block.
* Resolve a revision conflict by reloading the latest draft. Do not overwrite
  newer edits blindly.
* Publish only after validation succeeds.

<Info>
  A published revision is immutable. Later edits create another revision, so
  active visitors never receive a half-written document.
</Info>