Theme Customizer

A visual, real-time editor for customizing your theme's pages, sections, and global settings — without writing code.

Accessing the Customizer

Navigate to Themes > [Theme Name] > Customize from the admin panel. The customizer opens in a full-screen editor with a live preview.

Layout Overview

The customizer has four main areas:

  • Activity Bar (left) — Switch between Pages, Sections, and Settings views
  • Left Panel — Section tree showing the page structure
  • Live Preview (center) — Real-time preview of your page
  • Right Panel — Settings editor for the selected section

Managing Pages

Adding a Page

  1. Click the + Add Page button
  2. Enter a Page Title — the URL path auto-generates from the title
  3. The URL path is shown with a / prefix (you don't need to type it)
  4. Select a Layout
  5. Optionally select a Collection to link this page to CMS content

Collection Pages

When you select a collection, the CMS auto-generates:

  • A controller that fetches data using collection() or entry()
  • A template with a ready-made layout for listing or detail views

You can also check "Also create detail page" to create both listing and detail pages at once. The detail page URL auto-suggests as /collection/{slug}.

Switching Pages

Use the page dropdown at the top of the left panel, or click on pages in the Pages list. The URL updates with ?page=templateName so refreshing returns to the same page.

Working with Sections

Adding Sections

  1. Click Add Section below the section tree
  2. Browse the section gallery — search by name or category
  3. Click a section to add it to the page
  4. The section appears in the tree and the preview updates immediately

Editing Section Settings

Click any section in the tree to open its settings in the right panel. Settings are grouped (e.g. Data Source, Layout, Colors, Typography) and update the preview in real-time as you change them.

Section Actions

  • Drag to reorder — Drag the handle to move sections up/down
  • Duplicate — Right-click menu to copy a section with its settings
  • Rename — Give a custom name to a section instance
  • Show/Hide — Toggle section visibility without deleting
  • Remove — Delete a section from the page

Blocks

Some sections support blocks — repeatable sub-items like FAQ questions, team members, or feature columns. Click the + Add block link under a section to add one.

Built-in Section Types

SectionDescription
Hero BannerFull-width headline with CTA button
Feature Columns2-4 column feature grid with icons
Rich TextWYSIWYG content block
Image with TextSide-by-side image and text
Blog ListDynamic blog/article listing from a collection
GalleryImage gallery grid
TestimonialsCustomer testimonial carousel
FAQAccordion-style questions and answers
CTA BannerCall-to-action with button
Pricing TablePricing tiers comparison
TeamTeam member grid
StatsStatistics/metrics counter
Contact FormForm that submits to a collection
NewsletterEmail signup form
Logo CloudClient/partner logos
SpacerVertical spacing between sections
Custom CodeRaw HTML/CSS/JS insertion
Dynamic ContentDisplay entries from any collection

Global Theme Settings

Click Settings in the activity bar to edit theme-wide settings:

  • Colors — Primary color, background, text colors
  • Typography — Heading and body font families
  • Custom CSS — Add custom styles that apply to all pages

Saving & Publishing

  • Click Save to save all changes
  • Click Discard to revert unsaved changes
  • Changes are applied to the live site immediately after saving
URL Persistence

The customizer URL updates with ?page=templateName as you switch pages. Refreshing returns you to the same page instead of the default.