Skip to main content

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.

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:

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.

Featured Collection

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

FAQ

An expandable accordion of frequently asked questions. Configure question-answer pairs directly in the section settings.

Image Slider

A carousel of images with optional captions and links. Use for brand campaigns, lookbooks, or multi-image promotions.

Marquee

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

Newsletter

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

Rich Text

A freeform content block supporting headings, body text, lists, and inline formatting. Use for mission statements, editorial copy, or informational sections.

Stats Counter

Animated number counters that highlight key business metrics — years in business, customers served, products sold, and similar.

Team Grid

A staff or team member grid with photos, names, and roles. Ideal for About Us pages.

Video Banner

A full-width video background section with optional overlay text and a CTA button.

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.

Features Grid

A grid of feature cards with icons, titles, and short descriptions. Use to highlight your store’s selling points or service benefits.

Google Maps

Embeds an interactive Google Map. Useful for brick-and-mortar locations or pickup address pages.

Contact Form

A customer-facing contact form with name, email, and message fields. Submissions are forwarded to your store’s support email.

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 typeDescription
indexYour storefront homepage
resourceIndividual product/service/dish detail pages
collectionCollection listing pages
searchSearch results page
contactYour Contact page
about_usYour 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:
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.
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.
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.
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.