Feature docs

    Change your entire store theme in one apply action from dashboard settings

    Vareons themes are complete store design packages. Selecting a theme in /dashboard/settings?tab=themes and pressing Apply writes the theme design in a single server request: the homepage, the theme's pages, the header and footer, brand colours and settings, updates the active theme state and layout revision, and creates a backup before applying.

    Last verified: 2026-09-18

    A Vareons theme is not just a colour or a font — it is a complete store design package stored as a snapshot that contains homepage component settings, the theme's own pages, header and footer components, and site layout values such as brand colours and display settings. Applying a theme therefore changes the store's very foundations, not one page's polish.

    The path: in the dashboard open store settings at /dashboard/settings?tab=themes. You will find the theme gallery with All / Free / Paid / Owned filters, and a card per theme showing its thumbnail and status badges: Current, Default, Owned, Exclusive, Included-on-plan, Free, or price. The card also shows the current layout revision.

    To choose, click the theme card, then press Apply Theme. If applying is allowed for your account (a free, owned, plan-included or granted theme), a final confirmation explains that applying replaces the homepage and global components, and that your other pages and the components you customised stay as they are. After you confirm, the server runs the operation.

    What happens server-side, in order: first a backup of the current layout is saved with reason "pre_apply", then the theme and its published snapshot are loaded, then all the theme's pages are written into the tenant's component settings, the header and footer components in the snapshot replace the tenant's matching ones while other tenant globals are kept, static pages are updated while preserving contractual endpoints such as order creation, product fetch and the contact form submission, and the site layout is deep-merged so the theme's brand colours and settings win while the tenant's other values are preserved.

    Then the active theme state is recorded: theme id, version and applied time, the "customised after apply" flag is cleared, the layout revision is incremented (layoutRevision) to protect changes from conflicts, the tenant's caches are invalidated so the new design appears, and an audit activity event named theme_apply is written. The result is that the store switches to a completely different design identity in one action while products, prices, orders and stock stay exactly as they are, because themes are a presentation layer that contains no commerce data.

    An important safety property of apply: the server accepts no layout, page or component body from the browser. The request carries only the theme id, the layout revision and the overwrite confirmation, and the snapshot is read from the database, which prevents passing or injecting an unpublished design. Entitlement is re-checked on every request: an exclusive theme cannot be applied without a live grant, and a paid theme cannot be applied without ownership.

    On available themes: the catalog includes a set of ready vertical themes (fashion, beauty, restaurant, furniture and more) in addition to the platform default theme. Every theme is built on the same dynamic-rendering logic: sections pull products and categories from your store at runtime, and the header and footer pull the website name and contact details from your company settings, so a theme's own brand label never displaces your store's name.

    Finally, backup and restore: every apply creates a "pre-apply" backup, the last five backups are kept for up to 90 days, and a backup can be restored through the dedicated restore route, which itself takes a "pre-restore" backup. This makes a theme switch reversible at the layout level. The known limits are that apply replaces the homepage, the theme's pages, and the header and footer, and does not touch products, orders, or merchant-created pages that are not part of the theme.

    Setup steps in Vareons

    1. Open the Themes tab

      In the dashboard go to /dashboard/settings?tab=themes to see the theme gallery with All, Free, Paid and Owned filters.

    2. Pick a theme

      Click the theme card you want. Check the status badges: Current, Default, Owned, Included-on-plan or price. If the theme is not owned or included in your plan, applying is not available.

    3. Press Apply Theme and confirm

      Press Apply Theme, read the confirmation explaining that apply replaces the homepage and global components while your other pages stay, then confirm.

    4. Review the store after applying

      When apply completes, the active theme and layout revision are updated. Open your store to check the homepage, header and footer, then adjust anything from the website editor or global settings.

    5. Know the rollback path

      Every apply creates a pre-apply backup, the last five are kept for up to 90 days, and a backup can be restored from the dedicated restore route, which automatically takes a pre-restore backup.

    Frequently asked questions

    Does applying a theme really change the whole store?

    Apply installs the homepage, the theme's pages, the header and footer, brand colours and settings in one request. Products, orders, and merchant-created pages not included in the theme stay as they are.

    Will I lose my products or orders when changing the theme?

    No. Themes are a presentation layer and contain no commerce data; products, prices, orders and stock remain unchanged in the database.

    Why is Apply unavailable for some themes?

    Because entitlement is re-checked on every request: a theme must be free, owned, included in your plan, or granted to you. Exclusive themes need a live grant and paid themes need ownership.

    Can a theme apply be undone?

    Yes at the layout level: every apply creates a pre-apply backup, the last five are kept for up to 90 days, and a backup can be restored from the dedicated restore route.

    Can I edit a theme after applying it?

    Yes. After applying, any component can be edited in the live website editor, and global settings, colours and fonts can be changed. A 'customised after apply' indicator appears when the applied theme is modified.

    Troubleshooting

    1) If the new design does not show, reload the store; tenant caches are invalidated on apply but your browser may hold a copy. 2) If Apply is disabled, check that the theme is owned, included in your plan, or that an exclusive theme has a live grant. 3) If only the homepage and header changed without the theme's pages appearing, confirm the theme snapshot contains those pages; apply writes only the pages present in the snapshot. 4) If you only want to change colours or fonts without switching theme, use General Settings and Design instead of applying a new theme.

    Related links

    تواصل معنا على واتساب