Skip to main content
You can customise how your web components look and behave directly from your Marzipan dashboard, without writing any code. Navigate to Settings > Web Components to access these options.
These settings apply globally to all web components on your site. If you need more granular control over individual elements, see the Styling guide for CSS-based customisation.

Styling

The Styling tab lets you set the colours, border radius, and other visual properties that all web components use by default.

Brand Colours

SettingDescription
Primary button backgroundThe main colour for buttons like “Add to Cart” and “Checkout”
Primary button hoverThe colour buttons change to when hovered
Secondary button backgroundBackground for secondary actions like “Continue Shopping”
Secondary button hoverHover state for secondary buttons
Secondary button textText colour on secondary buttons
Button borderBorder colour for primary buttons
Button border hoverBorder colour for primary buttons on hover
Secondary button borderBorder colour for secondary buttons
Secondary button border hoverBorder colour for secondary buttons on hover

Text Colours

SettingDescription
Primary textMain text colour across all components
Secondary/muted textUsed for supporting text and descriptions
Text on dark backgroundsText colour used on dark backgrounds (e.g. buttons)

Backgrounds & Borders

SettingDescription
Page backgroundThe background colour behind components
Card & loading backgroundBackground for cards and loading placeholders
Modal overlayThe semi-transparent overlay behind modals
Primary bordersMain border colour for cards and inputs
Subtle bordersLighter borders for internal dividers
Input backgroundBackground colour for form fields
Disabled input backgroundBackground for disabled form fields

Status Colours

SettingDescription
SuccessColour for success messages and icons (e.g. “Added to cart”)
WarningColour for warnings (e.g. low stock notices)
ErrorColour for error messages (e.g. validation errors)
Each status colour has a corresponding background colour for message containers.

Badge Colours

SettingDescription
Default badgeBackground and text for standard badges
Sale badgeBackground and text for sale price badges
Subscriber badgeBackground and text for subscriber/member pricing badges

Account Accents

These accent colours are used as highlights on the customer account page sections:
SettingDescription
Rewards iconAccent colour for the rewards/loyalty section
Profile iconAccent colour for the profile section
Subscriptions iconAccent colour for the subscriptions section

Border Radius

Control how rounded corners appear across your components:
  • Buttons and inputs — Choose from Sharp, XS, SM, MD, LG, XL, 2XL, or Full (pill shape)
  • Cards and containers — Choose from Sharp, SM, MD, LG, XL, 2XL, 3XL, or Full

Checkout Background

Set separate background colours for the two panels in the checkout layout:
  • Order summary (left) — The background behind the order summary sidebar
  • Checkout form (right) — The background behind the customer details and payment form

Product

The Product tab controls how individual products are displayed in both mini and full views.

Quick Attributes

Display key product attributes (e.g. Region, Grape Variety, Vintage) directly on the product card without customers needing to open the full product page.
  • Toggle quick attributes on or off
  • Choose which attributes to display
  • Drag to reorder the attributes

Accordion Sections

Configure which content sections appear on the full product page and in what order. Drag sections to reorder them. Available section types:
SectionDescription
DescriptionThe product’s main description
AttributesA table of all product attributes
Single AttributeDisplay one specific attribute (e.g. Tasting Notes)
ReviewsCustomer reviews
AwardsProduct awards and accolades
PressPress mentions and quotes
Related ProductsA grid of related products (configurable title and count)
TextA custom text section with your own title and content
Each section can be set to open or collapsed by default.

Product Text

SettingDescription
Add to Cart textButton text (default: “Add to Cart”)
Sale Badge textLabel on sale price badges (default: “Sale”)
Subscriber Badge textLabel on subscriber price badges (default: “Subscribers”)
Subscriber Price labelText next to subscriber pricing (default: “for subscribers”)
Bundle textUnit text for bundles (default: “bundle”)
Waitlist Button textText for waitlist buttons on sold-out items
Show Subscriber PricingWhether to display subscriber/member pricing
Show Quantity SelectorWhether to show a quantity picker
Redirect to CartWhether to redirect to the cart page after adding a product

Collection

The Collection tab controls how product grids appear.

Background

Set a background colour for collection pages.

Product Cards

SettingDescription
Card StyleChoose from Minimal (clean, no border), Bordered (subtle border), Elevated (shadow effect), or Filled (solid background)
Text AlignmentLeft-align or centre-align product card text
Image CornersControl the roundness of product image corners
Show Quantity SelectorWhether to show quantity pickers on product cards

Collection Text

SettingDescription
Add to Cart textButton text for collection product cards
Sale Badge textLabel on sale badges
Subscriber Badge textLabel on subscriber badges
Subscriber Price labelText next to subscriber pricing
Bundle textUnit text for bundles
Waitlist Button textText for waitlist buttons
Show Subscriber PricingDisplay subscriber/member pricing
Show DescriptionShow product descriptions on cards
Show “More” LinkShow a link to the full product page
”More” Link textText for the “More” link
Redirect to CartRedirect to cart after adding a product

Cart

The Cart tab controls the shopping cart component.

Container Styling

Add a background colour or border to the cart component to help it stand out on your page.
  • Background — Toggle on and select a colour
  • Border — Toggle on and select a border colour

Free Shipping Notification

Show a message in the cart telling customers how much more they need to spend to qualify for free shipping.
  • Enabled — Toggle the notification on or off
  • Message — Customise the message text. Use {amount} as a placeholder for the remaining amount (e.g. “Spend more for free shipping!”)
  • Display Threshold — Set a minimum cart value per market/currency. The notification only appears when the cart value is below this threshold.
Display product recommendations in the cart to encourage additional purchases.
  • Enabled — Toggle related products on or off
  • Section Title — Customise the heading (e.g. “You might also like”)
  • Number of Products — Choose how many products to display (1–12)

Checkout

The Checkout tab controls the checkout experience.

Background Colours

The checkout uses a split-panel layout. You can set separate background colours for each side:
  • Order summary (left) — Customise the background behind the order review
  • Checkout form (right) — Customise the background behind the payment form
Control how your logo appears at the top of the checkout:
  • Position — Left, Centre, or Right
  • Height — Small, Medium, Large, or Extra Large

Phone Field

  • Require phone number — When enabled, customers must enter a phone number to complete checkout

Referral Sources

Ask customers how they heard about you during checkout. This data feeds into your Attribution insights.
  • Enable dropdown — Show or hide the “How did you hear about us?” question
  • Allow “Other” option — Let customers type a free-text answer
  • Source options — Add, remove, and reorder options. Each source can include:
    • A display label
    • An auto-tag (automatically applied to the customer record)
    • An optional follow-up question (free text or dropdown) for more detail

Account

The Account tab controls the customer account component.

Subscription Upsell

Display a product grid within the customer account encouraging customers to start a subscription.
  • Enable — Toggle the upsell section on or off
  • Product Collection — Choose which collection to display products from
  • Heading — Customise the section heading
  • Message — Add a message encouraging customers to subscribe
  • Grid Columns — Set the number of columns for mobile, tablet, and desktop views