Skip to main content
Design settings page with live preview of checkout, customer portal, and storefront
The Design page is your central hub for branding every customer-facing surface: checkout, storefront, and customer portal. Changes apply instantly across all three and are previewed in real time before you save.

Key Highlights

  1. Unified Design Hub - Configure checkout, storefront, and customer portal appearance from a single page.
  2. Pre-Built Themes - Start with a curated theme and customize from there.
  3. Light & Dark Mode - Define separate color palettes for each mode.
  4. Live Preview - See how your changes look across checkout, customer portal, and storefront before saving.
  5. Per-Section Overrides - Fine-tune individual sections (checkout, storefront, customer portal) without affecting the others.
  6. Programmatic Control - Override themes at checkout time via the API or Checkout SDK.

Getting Started

Navigate to Design in the main sidebar of your Merchant Dashboard. The Design page has four tabs:
TabPurpose
GeneralBusiness name, logo, theme selection, and global advanced settings
CheckoutOverride theme settings specifically for the checkout page
StorefrontOverride theme settings and configure storefront layout
Customer PortalOverride theme settings for the customer portal

General Settings

The General tab controls your baseline brand identity and global theme.
General tab showing advanced settings with typography, colors, and border configuration

Basic Configuration

SettingDescription
Business NameThe name displayed on checkout, storefront, and customer portal
Business LogoYour brand logo shown across all customer-facing pages
ThemeSelect a pre-built theme as your starting point

Advanced Settings

Expand Advanced Settings to access granular controls:
Advanced settings expanded showing full color configuration for light and dark modes

Typography

SettingOptionsDescription
Primary FontAny Google FontMain font for headings and body text
Secondary FontAny Google FontAccent font for labels and secondary text
Font Sizexs, sm, md, lg, xl, 2xlGlobal base font size
Font Weightnormal, medium, bold, extraBoldDefault font weight

Color Configuration

Define separate color palettes for Light Mode and Dark Mode. Each mode supports the following properties:
PropertyDescription
Background PrimaryMain background color
Background SecondarySecondary background (tabs, cards)
Text PrimaryMain text color
Text SecondaryMuted text color
Button PrimaryPrimary button background
Button Primary TextText color on primary buttons
Button SecondarySecondary button background
Button Secondary TextText color on secondary buttons
Border PrimaryMain border color
Border SecondaryAccent border color

Border

SettingDescription
Border RadiusControls the roundness of inputs, buttons, tabs, and cards (e.g., 0 for sharp corners, 8px for rounded, 16px for pill-shaped)

Pre-Built Themes

Dodo Payments ships with four curated themes. Select one from the Theme dropdown on the General tab to instantly apply a cohesive design across checkout, storefront, and customer portal.

Dodo Pulses

The default Dodo Payments theme. Lime green accents give it an energetic, fresh feel. Clean sans-serif typography with generous spacing.
Dodo Pulses theme in light mode showing checkout, customer portal, and storefront

Terminal

A developer-oriented theme with monospaced typography and royal blue accents. Sharp corners and a technical aesthetic that pairs well with dev-tool and API-first products.
Terminal theme in light mode showing checkout with blue accents and monospaced font

Bumblebee

Warm amber and gold accents with rounded, modern styling. Bold and high-contrast, well-suited for consumer-facing products that want to feel premium.
Bumblebee theme in light mode showing checkout with amber accents

Bubblegum

Playful pink and magenta accents with fully rounded corners. A modern, approachable look that works great for creative tools, design products, and lifestyle brands.
Bubblegum theme in light mode showing checkout, customer portal, and storefront with pink accents
After selecting a pre-built theme, you can further customize individual properties in the Advanced Settings. Any unspecified properties fall back to the theme defaults.

Per-Section Overrides

Each section tab (Checkout, Storefront, Customer Portal) includes an Override Theme toggle. When enabled, you can customize that section’s appearance independently from the global theme.

Checkout Tab

Checkout tab showing full checkout preview with product details and payment form
Override typography, colors, and border settings specifically for the checkout experience. The live preview shows:
  • Product information and pricing
  • Express checkout options (Apple Pay, Google Pay)
  • Payment method selection and card form
  • Discount code input and price breakdown

Storefront Tab

Storefront tab showing store URL, branding controls, and storefront preview
Configure storefront-specific settings:
SettingDescription
Store URLYour storefront address (e.g., store.dodopayments.com/your-store)
Store NameToggle and set the name displayed on your storefront
Store LogoToggle and upload a logo for the storefront header
Store BannerToggle and upload a banner image
Product DescriptionToggle to show or hide product descriptions on cards
Override ThemeEnable to customize typography, colors, and borders for the storefront only

Customer Portal Tab

Customer portal tab showing subscription management, billing history, and payment methods preview
Override the theme for the customer portal, which includes:
  • Subscription management
  • Billing history
  • Payment methods
  • Wallet and credits