Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cartble.com/llms.txt

Use this file to discover all available pages before exploring further.

The Cartble section editor lets you build and customize every page in your storefront without writing code. Each page type has its own section stack, and you can add, reorder, and configure sections through the Design panel in your admin dashboard. Some sections are locked to specific page types, and a few are restricted by industry.

Page types and the section editor

Your storefront has six page types, each with its own independent list of sections:
Page typeDescription
indexYour homepage
resourceIndividual product pages
collectionCollection listing pages
contactContact page
about_usAbout us page
searchSearch results page
Each section definition declares which page types it is availableOn. You can only add a section to a page type it supports.

Locked sections

Two sections are locked and cannot be removed from their page:
  • Resource information (resource_main) — always present on product pages
  • Collection resources (collection_main) — always present on collection pages
Locked sections can still be configured; you just cannot delete them.
Removing a locked section is not possible through the section editor. They are required for the page to function correctly.

All section types

A full-width banner with a background image or video, overlay controls, and up to two CTA buttons.Available on: homepage, product, collection, contact
SettingTypeDescription
TitleTextMain heading text
SubtitleTextareaSupporting copy below the title
Background imageImageDesktop background image
Background video URLTextURL to an MP4 file or AI-generated cinematic video
Section heightSelectsmall, medium, large, or full (full screen)
Content alignmentSelectleft, center, or right
Overlay typeSelectsolid color or gradient vignette
Overlay colorColorOverlay fill color (default #000000)
Overlay opacityRange0–100 (default 40)
Text colorColorHeading and body text color (default #ffffff)
Button textTextPrimary CTA label
Button linkURLPrimary CTA destination
Secondary button textTextOptional second CTA label
Secondary button linkURLOptional second CTA destination
A multi-slide banner with separate desktop and mobile images per slide, transition effects, and autoplay.Available on: homepage, product, collectionSection settings:
SettingTypeDescription
Slider heightSelectsmall, medium, large, or full
Transition effectSelectslide or fade
Pagination styleSelectdots or progress bars
Enable autoplayCheckboxAuto-advances slides (default on)
Autoplay speedRangeSeconds between slides (default 5)
Show navigation arrowsCheckboxShow previous/next arrows (default on)
Blocks (up to 6 slides):Each slide block has its own title, subtitle, desktop image, mobile image, content alignment, overlay color and opacity, text color, and a single CTA button with label and link.
A block of formatted text content with an optional heading, useful for brand storytelling or policy text.Available on: homepage, product, collection, contact
SettingTypeDescription
TitleTextSection heading (default “Our Story”)
ContentRich textFull rich-text body content
AlignmentSelectleft, center, or right
An email signup form with flexible layout and background options, including an LGPD consent checkbox.Available on: homepage, product, contact
SettingTypeDescription
TitleTextHeading (default “Subscribe to our emails”)
SubtitleTextareaSupporting copy
Button textTextSubmit button label (default “Sign up”)
LayoutSelectcentered or split (image alongside form)
Split layout imageImageImage shown in split layout
Background styleSelectsolid, gradient, or image
Background colorColorUsed when style is solid
Gradient from / toColorStart and end colors for gradient
Background imageImageUsed when style is image
Overlay opacityRangeOpacity over background image (default 50)
Text color schemeSelectlight (white) or dark (black)
Require LGPD consentCheckboxAdds a consent checkbox (default on)
Consent textTextareaCustom consent copy
The LGPD consent checkbox is enabled by default to help stores operating in Brazil comply with the Lei Geral de Proteção de Dados.
The main product information block on a product page. This section is locked and cannot be removed.Available on: product only
SettingTypeDescription
Layout styleSelectstacked (image above info) or columns (side by side)
Blocks:You configure which information blocks appear and in what order:
BlockDescription
Title & PriceDisplays the product name and price
Variants & OptionsRenders variant selectors (size, color, etc.)
Add to Cart ButtonThe primary purchase action
Structured AccordionUp to four collapsible sections for description, materials, shipping, or custom metafield content
The Structured Accordion supports up to four items. Item 1 always renders the product description. Items 2–4 each have a title, optional rich-text content, and an optional metafield connection that overrides the manual content when set.
The main product grid on a collection page. This section is locked and cannot be removed.Available on: collection only
SettingTypeDescription
Resources per pageNumberNumber of products per page (default 12)
A customer contact form with optional phone field and configurable alignment.Available on: contact, homepage
SettingTypeDescription
TitleTextForm heading (default “Get in Touch”)
SubtitleTextareaSupporting copy
Button textTextSubmit label (default “Send Message”)
AlignmentSelectleft or center
Show phone fieldCheckboxAdds a phone number input (default off)
Email placeholderTextPlaceholder for the email input
An accordion-style FAQ section. Each FAQ item is a separate block with a question and rich-text answer.Available on: homepage, product, collection, contact
SettingTypeDescription
TitleTextSection heading (default “Frequently Asked Questions”)
AlignmentSelectleft or center
Blocks: Each FAQ item block has a Question (text) and an Answer (rich text).
Embeds a Google Maps location at a configurable zoom level and height.Available on: contact, homepage
SettingTypeDescription
AddressTextThe address to pin on the map
Zoom levelNumberMap zoom (default 15)
Map heightNumberHeight in pixels (default 450)
Displays your store’s contact details — address, phone, email, and opening hours — with a configurable background.Available on: contact, homepage, about us
SettingTypeDescription
TitleTextSection heading (default “Where to find us”)
AddressTextareaStreet address
PhoneTextPhone number
EmailTextContact email address
Opening hoursTextareaFree-form hours text
AlignmentSelectleft or center
Background colorColorSection background (default #ffffff)
Places a side-by-side image and text block with an optional CTA button. Image position is configurable.Available on: homepage, about us, product
SettingTypeDescription
ImageImageThe featured image
TitleTextBlock heading (default “Our Mission”)
TextRich textBody content
Image positionSelectleft or right
Button textTextOptional CTA label
Button linkURLOptional CTA destination
A grid of feature highlights, each with a Lucide icon, title, and description.Available on: homepage, about us, product
SettingTypeDescription
TitleTextSection heading (default “Why choose us”)
ColumnsSelect3 or 4 columns
Blocks: Each feature block has an Icon (Lucide icon name, e.g. Star), a Title, and a Description.
A full-width video background banner that accepts an MP4 file URL or a YouTube URL, with an overlay and optional CTA.Available on: homepage, about us
SettingTypeDescription
Video URLTextDirect MP4 link or YouTube URL
Overlay opacityRangeDarkness of the overlay (default 50)
TitleTextOptional heading over the video
Button textTextOptional CTA label
Button linkURLOptional CTA destination
An animated counter block displaying key numbers with labels and suffixes (e.g., “1,000+ happy customers”).Available on: homepage, about us
SettingTypeDescription
Background colorColorSection background (default #f9fafb)
Blocks: Each stat block has a Number (text), a Label, and a Suffix (e.g. +).
A grid of team member cards or general image tiles with names and captions.Available on: homepage, about us
SettingTypeDescription
TitleTextSection heading (default “Our Team”)
ColumnsSelect3 or 4 columns
Blocks: Each member block has a Photo (image), a Name, and a Role/Caption.
A menu-style product grid linked to a specific collection. This section is only available for stores operating in the on-demand industry type.Available on: homepage, about us
SettingTypeDescription
TitleTextSection heading (default “Check our specials”)
Menu collectionCollection pickerThe collection to display as a menu
Items per rowSelect1 or 2 columns
The Daily Menu section only appears in the section picker for on-demand stores (food delivery, ready-made meals, etc.). It will not be visible if your store uses a different industry type.
A continuously scrolling ticker with repeating text items and Lucide icons. Useful for announcements, brand values, or promotional messaging.Available on: homepage, product, collection, about us
SettingTypeDescription
SpeedRangeSeconds per full scroll cycle (default 20)
DirectionSelectleft or right
Pause on hoverCheckboxPauses the animation on hover (default on)
Gap between itemsSelectSmall (gap-6), Medium (gap-12), Large (gap-24)
Background typeSelectsolid or gradient
Background colorColorUsed for solid background
Gradient from / toColorStart and end colors for gradient background
Text colorColorItem text color (default #ffffff)
Font sizeSelectExtra small, Small, Medium, or Large
Vertical paddingSelectTight, Normal, or Spacious
Fade edgesCheckboxFades left and right edges (default on)
Font weightSelectNormal, Medium, Bold, or Black
Blocks: Each marquee item has Text and an optional Icon (Lucide icon name, e.g. Star).