> ## Documentation Index
> Fetch the complete documentation index at: https://help.cartble.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme Editor: customize your Cartble storefront design

> Use the Spark theme editor to customize colors, fonts, and layout sections — and build page-specific designs with a live preview before publishing.

Cartble's default storefront theme is called **Spark**. It's a modern, conversion-optimized theme built around a section-based layout system — every page is assembled from modular sections that you can add, remove, reorder, and configure without touching any code. The Theme Editor in your admin gives you a live canvas where every change previews in real time before you publish.

## How sections work

A section is a self-contained content block: a hero banner, a product grid, a newsletter form, a map — each one is independent and configurable. You stack sections vertically to build a page. Because sections are modular, you can mix and match them freely across different page types, and the same section type can appear multiple times on one page with different settings each time.

## Available sections

Spark ships with the following sections, each configurable from the Theme Editor:

> [card] Hero
>
> A full-width banner with headline, subheadline, background image or video, and a call-to-action button. The primary attention-grabber for your homepage or landing pages.

> [card] Featured Collection
>
> Displays a product grid from a chosen collection. Ideal for showcasing best-sellers, new arrivals, or any curated group on your homepage.

> [card] FAQ
>
> An expandable accordion of frequently asked questions. Configure question-answer pairs directly in the section settings.

> [card] Image Slider
>
> A carousel of images with optional captions and links. Use for brand campaigns, lookbooks, or multi-image promotions.

> [card] Marquee
>
> A horizontally scrolling text or logo strip — great for announcing promotions, featuring brand logos, or adding kinetic energy to a page.

> [card] Newsletter
>
> An email sign-up form with a headline and call-to-action. Captures subscriber emails for your marketing list.

> [card] Rich Text
>
> A freeform content block supporting headings, body text, lists, and inline formatting. Use for mission statements, editorial copy, or informational sections.

> [card] Stats Counter
>
> Animated number counters that highlight key business metrics — years in business, customers served, products sold, and similar.

> [card] Team Grid
>
> A staff or team member grid with photos, names, and roles. Ideal for About Us pages.

> [card] Video Banner
>
> A full-width video background section with optional overlay text and a CTA button.

> [card] Image With Text
>
> A side-by-side layout with an image on one side and text content on the other. Good for feature callouts and brand storytelling.

> [card] Features Grid
>
> A grid of feature cards with icons, titles, and short descriptions. Use to highlight your store's selling points or service benefits.

> [card] Google Maps
>
> Embeds an interactive Google Map. Useful for brick-and-mortar locations or pickup address pages.

> [card] Contact Form
>
> A customer-facing contact form with name, email, and message fields. Submissions are forwarded to your store's support email.

> [card] Platform Address
>
> Displays your store's address and contact details from your Platform Profile. Keeps contact information consistent across pages.

## Page-specific layouts

Sections are organized by **page type**. Each page type has its own section stack that you configure independently:

| Page type | Description |
| - | - |
| `index` | Your storefront homepage |
| `resource` | Individual product/service/dish detail pages |
| `collection` | Collection listing pages |
| `search` | Search results page |
| `contact` | Your Contact page |
| `about_us` | Your About Us page |

Navigate between page types in the Theme Editor using the page selector at the top of the editor panel. Sections you add to `index` don't affect `collection` pages, and vice versa.

## Reordering and configuring sections

**To add a section:**

1. Open the Theme Editor from **Online Store → Theme Editor**.
2. Select the page type you want to edit.
3. Click **Add Section** and choose a section type from the list.
4. The new section appears at the bottom of the stack — drag it to the desired position.

**To configure a section:**

1. Click on any section in the editor sidebar to expand its settings panel.
2. Update the fields — text, images, links, colors, and layout options — in the panel.
3. The preview canvas updates in real time as you type.

**To reorder sections:**
Drag the section handle (⋮⋮) up or down in the sidebar list to change the order. The preview updates immediately.

**To remove a section:**
Click the trash icon on any section in the sidebar. The section is removed from the page layout.

## Global theme configuration

Beyond individual sections, Spark exposes global settings that apply across your entire storefront:

> [accordion] Colors
>
> Set your store's **primary color** and **secondary color**. These are used for buttons, links, accents, and highlights throughout the theme. Changes here propagate everywhere the theme references these color tokens.

> [accordion] Typography
>
> Choose a **heading font** and a **body font** from the available font library. Font choices apply globally to all text elements rendered by the theme.

> [accordion] General style
>
> Configure the **button style** (`rounded`, `square`, or `pill`) and a global **border radius** value (0–40 px). These settings shape the visual language of interactive elements and cards across the storefront.

> [!NOTE]
>
> All theme changes — section edits and global settings — are previewed live in the editor canvas before they reach your shoppers. Click **Publish** to push your changes to the live storefront when you're satisfied with the result.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.