Getting Started·4 min read·

How do I switch themes in VeloCMS?

Switch your blog's visual theme in two clicks from the admin dashboard — your content stays untouched and the change goes live instantly.

Switching themes in VeloCMS takes about two clicks and zero downtime — navigate to Admin → Themes, click the thumbnail of any theme you want, and hit Apply. Your content (posts, pages, media) is completely separate from the visual layer, so nothing gets lost or rearranged when you change themes.

Where do I find the theme gallery?

Log into your admin dashboard and click Themes in the left sidebar. You'll see a grid of every theme available on your plan. Hover over any thumbnail to get a full-screen preview that shows how your actual recent posts would look — not a generic demo with placeholder text. The preview renders a live iframe, so you're seeing your real content through the new lens before committing to anything.

What happens to my existing content when I switch?

Nothing happens to your content. Themes in VeloCMS are purely CSS and layout — they change colors, fonts, spacing, and component arrangements but never touch your post bodies, metadata, or media. Think of it as repainting a room: the furniture (your writing) stays exactly where it was. This is a deliberate architectural decision described in the theme system spec. Your SEO data, slugs, publish dates, and subscriber list all remain intact.

How long does a theme switch take to go live?

The switch itself is instant on the server side. Once you click Apply, VeloCMS updates your tenant's theme setting in PocketBase and the Next.js app picks up the new CSS preset on the next page load. If you have a CDN layer (Cloudflare, for example), the edge cache refreshes within 30–60 seconds after the change propagates. Most visitors see the new design within a minute. You don't need to trigger a redeploy or rebuild — the theme selection is a runtime configuration, not a compile-time decision.

Can I preview a theme before applying it?

Yes. The preview mode in the Themes gallery shows your real blog content through the new theme without making any live changes. You can click through to any article preview, check the homepage layout, and even inspect how your hero image looks at different breakpoints — all before committing. Only when you click Apply does the change go public. This means you can safely browse themes on a Friday afternoon without your readers noticing you're window shopping.

What if I want to go back to my old theme?

Just open the Themes gallery again and click the previous theme's thumbnail, then Apply. There's no undo button because you don't need one — every theme is always available in the gallery. VeloCMS doesn't delete or archive your old theme settings when you switch, so reverting is exactly as fast as switching forward. Some teams even cycle themes seasonally (lighter palette in summer, richer colors in autumn) and switch back without any friction.

Custom domain users: after a theme switch, your Cloudflare edge cache might serve the old theme to some visitors for up to 60 seconds. If you need it to propagate immediately, do a manual cache purge from Admin → Settings → Advanced → Purge CDN Cache.