Documentation

Ledger is an Online Store 2.0 theme, distributed as a .zip. In your Shopify admin, go to Online Store → Themes → Add theme → Upload zip file, then Publish when you're ready to go live. Everything in this theme is configured through the theme editor — no code editing is required for normal use.

First three things worth doing before you publish:

1. Set your main menu under Online Store → Navigation — the header's category index and mega menu build themselves from it, including live product counts per collection.
2. Upload a favicon under Theme settings → Layout → Favicon.
3. Set your default color scheme and check contrast if you build a custom scheme — Ledger's shipped schemes are all WCAG AA checked, but a custom accent color isn't verified for you.

Ledger ships with one carefully tuned preset — bone paper, ink text, a signal-orange accent, and a two-font system (a confident sans for headings and UI, a monospace face reserved for numbers, SKUs, and the ledger table). Everything derives from one token system, so building your own look means adjusting colors and type in the editor, not fighting hardcoded styles.

Four color schemes are included out of the box (including a dark scheme), every one checked for WCAG AA contrast, and any section can use any scheme. More presets — apparel, food & drink, and a dark-first beauty look — are planned as free theme updates.

Every section below is Online Store 2.0 native — add, remove, and reorder blocks from the theme editor without touching code.

• Product page — the buy box is fully block-based: vendor, title, price, variant picker, buy buttons, description, pickup availability, and complementary products are each their own block, so you can reorder or remove them. Variant swatches render inline; a sold-out variant shows a "notify me" email capture automatically. App blocks and a Custom Liquid block are supported alongside the built-ins.
• Collection page — one toggle switches between a standard image grid and the "ledger" dense table view; shoppers can switch too. Filters (availability, price, and any merchant-defined filter) render with live counts in the rail on desktop and a filter sheet on mobile.
• Cart — page and drawer both support accelerated checkout buttons (Shop Pay etc.), discount codes, selling plans, and unit pricing where applicable. The drawer shows a factual free-shipping progress meter — no invented urgency.
• Lookbook — a shoppable image with tap-to-shop hotspots that open a small product popover. Add as many hotspot blocks as you have products to tag.
• Featured product — a standalone mini product page you can drop anywhere (home page, a custom page, etc.), sharing the same buy-box logic as the main product template.
• Also included: custom collection/featured collection, catalog ledger (home-page table view), collection index, editorial split, slideshow, video, multicolumn, FAQ (collapsible), testi monials, newsletter, recently viewed, and a Custom Liquid section for anything bespoke.

• Grid ⇄ ledger view — every collection can be browsed as an image grid or a dense, numbered table. The choice persists in the URL (?view=ledger) so it's shareable and works with pagination.
• Quick view — opens a real product form (variant picker, quantity, add to cart) in a modal without leaving the grid, for any multi-variant product.
• Predictive search — products, collections, and search-term suggestions, keyboard-navigable, announced to screen readers as results load.
• Back-in-stock — a sold-out variant shows an email capture that uses Shopify's own contact/customer form, no app required.
• Gift cards — the gift-card page renders a scannable QR code for the code itself, plus Apple Wallet support where Shopify provides it.
• Accessibility — skip-to-content link, a single consistent focus ring throughout, semantic landmarks, and every shipped color scheme checked for WCAG AA contrast. RTL languages are supported (layout mirrors correctly for Arabic, Hebrew, Persian, Urdu, and other right-to-left locales).
• Performance — no render-blocking scripts (everything after the critical path is deferred and scoped to the page types that actually need it), responsive images with explicit dimensions, and view-transition page changes.

Color schemes live under Theme settings → Colors. Every section lets you assign any scheme, independent of the others, so you can, for example, alternate a dark scheme on the home page between light sections for rhythm.

Typography is two fonts throughout: one for headings/UI and one monospace face used specifically for numbers, SKUs, and the ledger table — this is a deliberate part of the theme's identity, not a default we'd suggest changing, but both are swappable under Theme settings → Typography if you want a fully custom look.

Spacing follows a fixed 4px-based scale used consistently across every section — this isn't a setting, it's a structural choice that keeps the theme's rhythm consistent even as you rearrange blocks and sections.

We reply to support requests within two business days. In scope: fixing theme bugs, answering how-to questions about built-in settings, sections, and blocks. Out of scope (but we're happy to point you to a Shopify Partner who can help): custom coding, bespoke sections, and third-party app integration work. If you do have a developer make direct code changes, duplicate your theme first so you always have an unedited copy to fall back to.

Contact support →