BalmDocumentation

FAQ

Answers to the questions merchants ask most about Balm.

Can I use Balm on more than one store?

A theme bought from the Shopify Theme Store is licensed for one store. To use Balm on another store, buy it again from that store. Trying the theme is free on any store.

How do I update Balm without losing my settings?

When an update is available, your theme library shows a notice. Shopify adds the new version as a separate copy that keeps your theme editor settings and content. Preview it, then publish it. Changes you made in the theme code are not carried over; see Custom code.

How do I make the header transparent over my hero?

  1. In the Header section, check Transparent header over the first section, and pick a Transparent header color scheme with light text if your hero is dark.
  2. Make sure the first section of the page is a Hero, Slideshow, Video, Products showcase or Brand story hero, with Allow transparent header checked.

Upload a light version of your logo in Logo image (transparent header) if your normal logo is dark.

Why are there no filters on my collection pages?

Filters come from Shopify's free Search & Discovery app. Install it, add the filters you want (availability, price, product type, color and so on), then check that Enable filters is on in the Collection and Search sections. A filter only shows when the products of the page have values for it.

How do I set up a mega menu?

Create your main menu in your admin first. Then, in the Header section, add a Mega menu block and type the exact title of a top level menu item in Linked menu item, for example Shop. Add Link column, Image, Products, Promo or Banner blocks inside it. The panel opens when a shopper hovers that item. See Mega menu blocks.

How do I give each product its own background color?

Create a product metafield definition named Background color of type Color, connect it to the Background color setting of the Product section, then fill it on each product. The full walkthrough is on Metafields.

Why can I not connect a setting to my metafield?

Three usual causes. The definition does not exist yet: create it in Settings, Custom data first. The type does not match: a color setting only accepts a Color metafield, an image setting a File metafield. Or the definition was created for the wrong resource: product page settings need a Products definition, other sections a Shop definition. The help text of each connectable setting names the exact definition it expects.

How do I add product reviews and star ratings?

Install a reviews app that writes Shopify's standard review metafields (most do). Balm's Rating block, the ratings on product cards and quick view read them automatically once reviews come in. If the app offers an app block for its review list, add it to the product page from the block picker.

How do I add a size guide or ingredients list to product pages?

Create a page with the content in Online Store, Pages. On the product page, add a Popup block (a link that opens a dialog) or a Collapsible row, and set Content comes from to A page. For content that differs per product, connect the block's Content to a rich text metafield instead.

Can I change the color of the Shop Pay or PayPal buttons?

No theme can. The accelerated checkout buttons are drawn by Shopify with the brand colors of each payment provider. Balm matches everything Shopify allows: height, corner radius, spacing and the loading placeholder. See The accelerated checkout buttons.

How do I show a free shipping progress bar?

Open the Cart drawer section, check Show the reward progress bar and type the amount in Reward threshold. The bar only displays progress: create the matching free shipping rate or automatic discount in your admin, and keep the two amounts the same, or buyers will be promised something checkout does not apply.

How do I offer pre-orders?

Set the variant to continue selling when out of stock in the product admin. At 0 stock its buttons read Pre-order, or the label you set in Theme settings, Pre-order. To take a deposit or charge later, use a pre-order app. See Pre-order.

How do I translate my store?

Add and publish your languages in Settings, Languages. Balm's own texts are already translated into French, German, Italian and Spanish. Translate what you typed in the editor with the Translate & Adapt app. See Translations.

The newsletter popup does not appear. What should I check?

  • Enable popup is checked in the Newsletter popup section, and the section is on the template you are viewing (by default, the home page only).
  • You closed it earlier: it stays hidden for the number of days in Reappear after. Test in a private window.
  • The Open delay has not passed yet.

My speed score dropped after I turned on the page loader. Why?

A loader covers the page while it loads, which speed tools measure as a slower page. Set Page loader to First visit only, the recommended setting, or turn it off. Every page shows it on each page view and has the largest effect.