Set up Ledger

1. From your Shopify admin, go to Online Store > Themes and add Ledger from the Theme Store. It is added to your theme library unpublished, so your live store is not affected.
2. Choose Customize to open the theme editor.
3. Set your logo, fonts and color schemes under Theme settings (the gear icon), then build your home page with sections.
4. Preview the store on desktop and mobile. When you are ready, choose Publish from the theme library.

Color schemes live under Theme settings > Colors. Every section has a Color scheme setting, so you can alternate light and dark bands down a page without editing any colors. Changing a scheme updates every section that uses it. Ledger ships with these schemes:

Each scheme sets Background, Text, Headings, Signature color, Primary button background, Primary button label and Borders. Every scheme in the preset meets a 4.5:1 contrast ratio.

Before you edit theme code, duplicate the theme (Actions > Duplicate) and work on the copy. Code changes are not covered by theme updates or support.

Open the theme editor and select the gear icon to find these groups.

• Header: set the Logo and Logo width, the Menu, and the Customer account menu. Under Search, turn Show search in header on or off, set Suggestions per result type, and choose a Search suggestions color scheme.
• Search suggestions match products on variant SKU and vendor as well as title, so buyers can type a code they already know.
• Footer: edit the Brand text, choose a Menu, and turn Show payment icons on or off.

Add sections from Add section in the theme editor.

The home page starts with Quick order and Trade band. The product page has Product, Trade facts and Recently viewed. Two extra page templates are included: page.quick-order (a page with the Quick order table) and page.trade-account (a page with the Trade band).

• Trade band: each Step block has a Step number, Title and Description. The preset has three steps: Apply, Order and Pay on terms. Signed-in customers see the shorter signed-in copy and no application link.
• Recently viewed remembers up to 12 products in the buyer's own browser. Nothing is stored on your store.
• Contact page: create a page under Online Store > Pages and choose the page.contact template.

Quick order: add the Quick order section, or create a page with the page.quick-order template, and choose a Collection. Every variant in the collection gets a row with a quantity field. Quantities snap to each variant's order multiple, stop at its maximum, show the next price break, and every row with a quantity is added to the cart in one step.

Trade facts: on the product page, this section shows case pack, minimum order, order multiple, volume pricing and lead time. It shows nothing when a product has none of these, so it is safe on every product.

Create these product metafield definitions under Settings > Custom data > Products, then fill them in on each product. A missing value just hides that fact.

If you use Shopify B2B (companies and catalogs), Ledger reads each buyer's quantity rules and volume pricing from their catalog. The catalog minimum, increment and maximum take priority over ledger.min_qty and ledger.qty_break, and catalog price breaks appear as Volume pricing. Case size and lead time always come from the metafields.

1. Create a page for trade applications (for example with the page.trade-account template, at /pages/trade-account) or use an external application form.
2. Set Theme settings > Trade account > Trade account application page to that page. Each Trade band and Trade facts section can override it with its own Trade account link.
3. Leave Show a wholesale pricing note to logged-out visitors on to tell guests, in the Trade facts section, that wholesale pricing and payment terms appear once their trade account is approved and they are signed in.

Ledger uses a full cart page, so buyers can review a large order before checkout. There is no slide-out cart drawer.

Gift options add a gift wrap checkbox and a gift note to the cart. In Ledger it is the Gift wrap and note block inside the Cart section. Both options are off by default: select the block on the cart template and turn them on.

Settings: Offer gift wrap, Offer a gift note, Heading, Gift wrap checkbox label, Gift note placeholder, and Gift note maximum length (200 characters by default). Choices save as the buyer types.

Choices are saved as the cart attributes Gift wrap (Yes when ticked) and Gift note. They appear on the order in your admin and on packing slips from apps that print cart attributes. Keep the names exactly as they are so those apps can read them.

Gift wrap is a free option by default. To charge for wrapping, create a gift wrap product and sell it as a separate item.

The free shipping progress bar is set under Theme settings > Cart. It shows on the cart page and tells shoppers how much more they need to spend, then confirms when free shipping is unlocked.

• Turn on Show free-shipping progress in the cart.
• Set the Free shipping threshold in your store's default currency (500 by default). For shoppers paying in another currency it is converted automatically.
• Optionally change the Progress message (use [amount] where the remaining amount should appear) and the Unlocked message. Leave them blank to use the default wording, which is translated.

The bar only displays a message. Free shipping itself comes from your shipping rates or an automatic discount, so set the same threshold under Settings > Shipping and delivery.

Ledger uses Shopify's customer accounts. Sign-in, order history, order status, addresses, profile and the Buy again action are hosted by Shopify, so they keep working through theme updates. The theme has no legacy account templates to set up or maintain.

1. In your Shopify admin, go to Settings > Customer accounts and turn on customer accounts.
2. In the theme editor, select the Header section and choose the Customer account menu. It uses the customer-account-main-menu menu by default; edit it under Content > Menus.
3. The account icon appears in the header on desktop and mobile. Shoppers sign in with a one-time code sent to their email, so there are no passwords to manage.

The account icon only shows while customer accounts are turned on. If it is missing, check Settings > Customer accounts first.

Ledger includes the storefront features every Shopify Theme Store theme provides. They use Shopify's own data and apps, so there is nothing extra to install. Where a feature has options, you find them in the theme editor on the section or block that shows it.

• Product page: the product section is built from blocks. Open the product template in the theme editor to add, reorder or remove blocks such as title, price, variant picker, quantity, buy buttons and description. Buy buttons include dynamic checkout buttons, such as Shop Pay, when they are turned on in your payment settings.
• Filtering and sorting: collection and search pages use Shopify storefront filters. Choose which filters appear, such as availability, price, product type, vendor, variant options or metafields, in the free Shopify Search & Discovery app.
• Product recommendations: related and complementary products come from Shopify's product recommendations. Adjust them per product in the Search & Discovery app.
• Country and language selectors: they appear when your store sells in more than one country or language. Set these up under Settings > Markets and Settings > Languages.
• Newsletter signup: email signups are saved as customers in your admin with email marketing consent, ready for Shopify Email or your email app.
• Follow on Shop: when Shop Pay is turned on, shoppers can follow your store in the Shop app from your storefront. Manage this from the Shop channel in your admin.
• Search suggestions: the header search shows suggestions as shoppers type. Set how many appear for each result type in the Header section.

If your copy of Ledger is missing one of these, check your theme library for an update. Updates add a new copy with your settings carried over, so you can review it before publishing.

Ledger is built to be used with a keyboard and screen readers, and animations stop for visitors who prefer reduced motion. Images load at the size the screen needs, and images below the fold load as the shopper scrolls.

• Add alt text to every product and section image in your admin.
• Keep text and background colors in each color scheme at a contrast ratio of at least 4.5:1.
• Compress large images before uploading. Shopify serves them in modern formats automatically.

1.0.0: Theme Store storefront features. Block-based product page with volume pricing, quantity rules, unit prices, pickup availability, Shop Pay Installments, selling plans and accelerated checkout; rich media gallery with video and 3D models; related and complementary products; collection and search filtering; country and language selectors; three-level menus; newsletter; Follow on Shop; Custom Liquid and Apps sections.

0.1.0: first version built on Shopify's Skeleton theme for Theme Store submission. Ledger preset with five color schemes; quick-order table; trade facts from metafields and B2B quantity rules and price breaks; trade band and trade account page; gift options; free-shipping progress bar; recently viewed products; SKU-aware predictive search; Shopify customer accounts.

Send a request from the Ledger support page at happifyapps.com/themes/ledger/support. Include your store URL, what you expected and what happened, and a screenshot if you can. You get an email confirmation straight away and a reply within 2 business days.

• Covered: questions about theme settings, sections and blocks; bugs in the theme; installing and updating the theme.
• Not covered: changes to theme code or problems caused by edited code; third-party apps; custom design or new features. For these we recommend hiring a Shopify Partner.