FAQ

How do I make my store light (or dark)?

Colors come from four color schemes in Theme settings > Colors. The header, the footer and most sections have a Color scheme setting that picks one of them.

Each preset comes with its own four schemes. The editor lists them by number. The names below describe them:

To change one section, select it and choose another Color scheme.

To change the whole store, change the colors of the scheme itself. Scheme 1 also sets the page background, the cart drawer and other panels that open over the page. For example, to make the Loco preset light:

1. Open Theme settings > Colors.
2. Note the colors of Scheme 3.
3. Enter them in Scheme 1, then make Scheme 2 a slightly different light shade for the footer.
4. Check the header, footer and each section, and look for contrast notes in the editor.

See Color schemes.

Why doesn't my countdown show?

Check these in order:

1. End date is empty. The Countdown section needs an end date to appear.
2. The date can't be read. Use the format 2026-11-30 23:59, with the time. The theme editor shows a note when the format is wrong.
3. The date has passed and After the end date is set to Hide section. Set a new date, or choose Show “This sale has ended.”
4. The time is off by a few hours. Dates use your store's time zone, set in Settings > General.

The same applies to the countdown in the Promo banner section. There, an empty End date shows the banner without a timer. See Honest promotions.

Why don't I see “Only N left”?

The message shows real stock only. It appears when:

• the product page has the Inventory block
• the variant tracks quantity in Shopify
• Continue selling when out of stock is off for that variant
• the quantity is above 0 and at or below Low stock threshold in Theme settings > Product page (default 10)

Otherwise, while the variant is in stock, customers see “In stock, ready to ship”. For a variant on pre-order, the block shows the name of its purchase option instead.

Where do product ratings come from?

From a product reviews app. Loco reads the standard product rating that review apps save in Shopify. Install a reviews app that fills Shopify's product rating metafields, then add the Rating block to the Product section. Without such an app, the block stays empty and takes no space.

How do I add sub-collections to a collection page?

1. In Content > Menus, create a menu with links to the sub-collections, for example “Headphones” and “Speakers”.
2. In the theme editor, open a collection page and select the Collection page section.
3. Under Sub-collections, choose your menu in Sub-collection menu.
4. Optionally, change the Heading and turn on Show images to show each collection's image as a tile.

The menu appears on every collection that uses this template. To show different sub-collections on different collections, create another collection template in the theme editor, choose its menu, and assign the template to those collections in Products > Collections.

How do I show color swatches as images?

Loco shows whatever swatch Shopify has for each option value: a color or an image.

1. In Products, open the product and connect its color option to the Color category metafield.
2. Open each color value and add an image to its swatch, such as a fabric or finish photo.
3. Save. Swatches with an image show the image on the product page and on product cards.

Product cards show swatches while Show color swatches is on in Theme settings > Product cards. In collection filters, colors show as swatches when the color filter is set to swatches in the Search and Discovery app. To show them as dots without names, turn on Show the color filter as dots only in the Collection page section.

Why is the Recently viewed section empty in the theme editor?

The list lives in each customer's own browser, so there is nothing to show until that browser has visited products. Products you open inside the theme editor aren't added.

To see it, open your online store in a separate tab, view three or more products, then go back to the theme editor. The product a customer is looking at never appears in its own list.

In your store, the section stays hidden until it has at least two products to show, not counting the product on the page. Where your store asks for cookie consent, it records history only for customers who allow preferences.

How do I change the Background text behind a section?

Background text is the large word behind some sections. Select the section and edit Background text:

The word is decoration. Screen readers skip it, so don't put information in it.

How do I add an app block to the product page?

1. Install the app and turn on its block if the app asks you to.
2. In the theme editor, open a product page and select the Product section.
3. Click Add block and choose the app's block under Apps.
4. Drag the block to where you want it.

App blocks also work in the Featured product, Cart and Article sections. If an app has no block, look for it in App embeds in the theme editor.

How do I set up a gift wrap product?

1. In Products, create a product such as “Gift wrap” with its price and a photo. Keep it available in the Online Store sales channel, otherwise it can't be added to the cart. Leave it out of your collections.
2. In the theme editor, open Theme settings > Cart and choose it in Gift wrap product.
3. To show gift wrap on the cart page too, select the Cart section and turn on Show gift wrap. The cart drawer shows it as soon as you choose the product.

Customers check “Add gift wrapping” and can write a message. The message reaches you with the order as “Gift message”. When the gift wrap product is sold out, customers can't add it.

How do I show the country and language selectors?

They appear in the footer by themselves once there is a choice:

• the country/region selector when your store sells in two or more countries or regions, in Settings > Markets
• the language selector when your store is published in two or more languages, in Settings > Languages

Check that Show country/region selector and Show language selector are on in the Footer section. See Languages and currencies.

Can I use my own fonts?

No. Loco uses fonts from the Shopify font library only, chosen in Theme settings > Typography. It's a Shopify Theme Store rule, and the library fonts are hosted by Shopify, so they load quickly and work with every language the font supports. See Typography.

How do I update to a new version of Loco?

Shopify applies small bug and security fixes for you, without changing your settings. For other new versions, Online Store > Themes shows a notice in place of the theme's version number:

1. Click the notice, then click Add to draft themes. The new version arrives unpublished as “Updated copy of Loco”, with your theme editor settings.
2. Preview it and check your pages, especially the ones mentioned in the Release notes.
3. If you edited code before and Shopify says the code edits could not be included, make those changes again on the new copy.
4. Publish it. Your old version stays in your themes.

See Code customizations.

What is the Contents button in the header?

Contents opens your whole main menu at once: each level opens as a column next to the one before, and the Menu promo blocks of the open menu item follow in a column of their own. On phones, it opens as a sheet that shows one level at a time.

On a computer, Loco hides the button when it would only repeat the header: when your main menu has a single level, has no menu promos, and all items fit in the header. The button comes back as soon as one item no longer fits. On phones, and in the bar that slides in as customers scroll when Sticky header is set to Contextual bar, it's always there, because those have no room for the menu items.

Why is part of my image cut off?

Sections that fill a fixed shape crop the image around its focal point: Image banner, photo slides in Slideshow, and the banner above a collection's products.

• Follow the ratio or size shown under the image setting, such as “16:9 aspect ratio recommended”.
• To choose what stays in view, open the image in the image picker and set its focal point.
• On a collection page, Image layout controls the collection image. Banner above products crops to 3:1, while an image narrower than 2:1, such as a product photo, shows whole in the margin column.

Product images are never cropped. They sit whole inside a frame. On product cards, Image ratio in Theme settings > Product cards sets the frame's shape. On the product page, it follows the Design style: square, or 4:5 with Paper and rules.

How do I show a badge on a product card?

Add a product tag such as badge:Limited. The text after the colon becomes the badge, 14 characters max, on product cards and above the product name on the product page. Each card shows one badge, and a product on pre-order shows “Pre-order” instead. Loco has no Sale or New badge: a sale shows as the old price struck through next to the new one, and tags such as badge:Sale are ignored.

Why don't I see the popup or the age question?

• Check that Show popup or Show age verification is on in Theme settings.
• The popup appears after the Delay and then stays away for the days in Show again after. To see it again in your store, open the store in a private browser window.
• The popup never shows on the cart page, or to someone who has signed up.
• After a customer answers yes, the age question stays away for the days in Remember answer for.

In the theme editor, both open when the preview loads and close when you select a section or block.

What does the line above a section in the theme editor mean?

“Text in this color scheme may be hard to read” means a text color in that section's color scheme has less than 4.5:1 contrast with its background. Only you see it, in the theme editor. Change the colors in Theme settings > Colors until it goes away. See Accessibility and performance.

Can I change the words on buttons and messages?

Yes. Text you typed in the theme editor, such as headings and button labels, is changed there. For the theme's own text, such as “Add to cart” or the empty cart message, go to Online Store > Themes, open the ... menu next to Loco and click Edit default theme content.