Software Development
VTEX IO Storefront Theme Versioning
Apply when installing, publishing, upgrading, or rolling back a VTEX IO storefront theme app (`vendor.store-theme` or any app that owns `store/blocks.json`, `store/routes.json`, and `store/contentSchemas.json`). Covers how Site Editor and theme content are scoped by the app's MAJOR version, why a major version bump leaves the new major with no merchant content and silently falls back to default theme content, the safe install-in-workspace, migrate- content with the `updateThemeIds` mutation, smoke-test, then promote workflow, the 3-way mine-wins merge that `vtex workspace promote` performs against `vtex.pages-graphql` VBase (with automatic per-minute `userData_backup` snapshots when conflicts are resolved), and the support-led recovery path. Use for any operation that changes which version of a content-holding app is installed in `master`.
- Publisher / source
- vtex/skills (found on skills.sh)
- Upstream record
- vtex/skills
- Version
- Version 1
- Published
- Publication review
- Approved for publication · recorded passed scan 2026-11-02
- Content fingerprint
357b9f4223a572ce95f3628aa54ca22f46949aeab1c7400d1722911d662780a7