Bloomly 1.0.0

Bloomly documentation

Bloomly is a Shopify theme for beauty and skincare brands. This guide explains every setting, section and block, so you can set up your store without touching code.

Getting started

Add Bloomly to your store

  1. Open Bloomly in the Shopify Theme Store and choose Try theme or buy it.
  2. In your Shopify admin, go to Online Store > Themes. Bloomly appears in your theme library.
  3. Select Customize to open the theme editor. Publish Bloomly when you are happy with it.

Images from the Bloomly demo store are not copied to your store. Until you add your own images, sections show neutral grey illustrations, so you can see where each image goes.

Recommended first steps

  1. Add your favicon under Theme settings > Logo and favicon and your logo in the Header section.
  2. Choose your fonts and colors under Theme settings.
  3. Create your menus in Content > Menus (older admins: Online Store > Navigation). Bloomly uses the menus with the handles main-menu and footer by default.
  4. Add your social media links under Theme settings > Social media.
  5. Build your home page with the sections described below.
  6. Install the free Shopify Search & Discovery app for product filters and complementary products.

Theme settings

Open the theme editor and select the gear icon to reach the theme settings.

GroupWhat you can change
Logo and faviconThe small icon shown in browser tabs. Use a square image of at least 48 × 48 px.
TypographyThe heading font and the body font.
LayoutPage width and the minimum side margin.
ColorsFour color schemes. Each scheme sets background, text, accent, text on accent, highlight, card background and borders. Every section has a Color scheme setting, so you can switch a section between schemes.
Product cardsShow or hide the Sale, New and Low stock badges, how many days a product counts as new, and from which stock level the Low stock badge appears.
CartThe order value for free shipping. The cart shows a progress bar towards it. Enter 0 to hide the bar. Use the same value as in your shipping settings.
Shape and feelCorner radius of fields, cards and buttons.
Social mediaLinks to your Instagram, TikTok, Facebook, Pinterest, YouTube and X profiles. Only filled-in links appear in the footer.

The four color schemes in the Bloomly preset are: Scheme 1 (warm bone, the default), Scheme 2 (dark), Scheme 3 (soft blush) and Scheme 4 (white).

Announcement bar

Add one Message block per announcement. With several messages, Bloomly rotates them automatically. You can turn rotation off or change the seconds per message.

Header

  • Logo mark: upload a square logo. Without one, Bloomly shows a built-in monogram. You can hide the mark completely.
  • Menu: the main navigation. Menu items with child links open a dropdown, also with the keyboard.
  • Customer account menu: the menu shown in the account dropdown.
  • Mega menu: add a Mega menu column block. In Match top-level menu item, enter the exact title of a top-level menu item, for example Shop. Add an optional image, a heading and a menu with the column links. Add one block per column.

On small screens, the menu opens from a menu button. The header stays at the top while visitors scroll.

Footer

  • Menu: the footer links.
  • Show social media icons: shows the profiles from the theme settings.
  • Show Follow on Shop: shows the Follow on Shop button when the Shop channel is set up.
  • Show oversized store name and Show payment icons.
  • Country and language selectors appear automatically when your store sells in more than one country or language (Settings > Markets and Settings > Languages).

Sections

In the theme editor, select Add section to add any of these sections to a page. Sections that show images display a grey illustration until you choose an image.

SectionUse it for
Cinematic heroA full-screen opening image with a large heading, two links and an optional floating product card.
Beauty heroA hero with image, heading, button and short benefit lines (Perk blocks).
Hero lineupA product lineup on a calm background, with products that appear one after another.
SlideshowSlides with image, heading, text and button. Optional autoplay.
Image bannerA wide image with text and a button.
Image with textAn image next to a heading, text and button.
Rich textA short text with heading and button.
Manifesto quoteA large statement. Words light up while visitors scroll.
MarqueeMoving text. The Editorial style shows large words with small images.
Featured collectionProducts from one collection. Shows example cards until you choose a collection.
Featured collectionsTiles that link to collections.
Featured productOne product with media, price, options and buy buttons on any page.
Featured blogThe latest articles from a blog.
Multicolumn and Brand principlesShort benefits in columns or rows.
Ingredient spotlightKey ingredients with a percentage, a short explanation and skin concern tags. Layout as a grid or as a list.
Ritual stepsA routine in steps, each with an icon and a time of day.
Scroll storyA pinned image that changes with each step while visitors scroll.
Timeline and Story heroYour brand story, used on the Our story page.
Beauty quizA short quiz that recommends products. See the FAQ for setup.
Shoppable galleryPhotos with hotspots. Add a Gallery image block, then add Shoppable hotspot blocks inside it and place them with the position sliders.
Compare productsA comparison table. Add Product column and Row blocks. Write Yes or No in a row to show a check mark or a dash.
Press coverageLogos of publications that featured you.
TestimonialsCustomer quotes. Only use real reviews from real customers.
NewsletterAn email sign-up. Subscribers appear in Customers with email marketing consent.
VideoAn uploaded video or a YouTube or Vimeo link with an optional cover image.
Custom sectionA free area for theme blocks such as Promo tile, Countdown timer, Text and Group.
Custom LiquidYour own Liquid or HTML code.

Popup and age check

Promo popup and Age verifier are off by default. Turn them on in the theme editor. The popup collects newsletter sign-ups and appears once per visitor after the delay you set. The age verifier is a simple confirmation screen. It does not check identity documents.

Product page

Every element of the main product section is a block. Drag blocks to change their order, hide them, or add new ones. App blocks from your apps can be added in the same place.

BlockWhat it shows
Product titleThe title, optionally with the product type above it. Use the custom.card_word metafield to show a short word instead of the type.
Product vendorThe vendor, linked to all of their products.
Product pricePrice, sale price, unit price, the tax note and the Shop Pay Installments message. Optionally the star rating.
Inventory status"In stock" or "Only 3 left", based on your real inventory. The limit comes from Product cards > Low stock badge threshold.
Product descriptionThe description from the product admin.
Variant pickerButtons for each option. Swatches appear when you set colors or images for option values in the Shopify admin. Options called Color, Colour or Shade also show a color dot when the value is a color name.
Quantity selectorPlus and minus buttons. The price in the add-to-cart button updates with the quantity.
Buy buttonsAdd to cart, accelerated checkout buttons, subscription options, the gift card recipient form and the back-in-stock request.
Complementary productsProducts that pair well with this one, from the Search & Discovery app.
Key activesA list of active ingredients from the custom.key_actives metafield.
Ingredient listThe full ingredient list from the custom.ingredients metafield, with optional skin concern tags.
Trust badgeAn icon with a short text, for example "30-day returns". Only promise what you actually offer.
Product tabA collapsible row with a heading and text, for example "How to use".
Size chartA link that opens a chart image or text.
Delivery estimateAn estimated delivery window based on a cut-off hour and business days you set.
Before and afterA slider that compares two images.
Share links, Text, Custom LiquidSharing links, free text and your own code.
  • Media: the gallery supports images, videos and 3D models. Selecting a variant shows its image. Visitors can zoom images.
  • Sticky bar: when the buy button scrolls out of view, a slim bar with price and add-to-cart appears.
  • Pickup: when local pickup is set up, the page shows where the product can be picked up.
  • Gift cards: customers can send a gift card to someone else, with a message and a send date.
  • Back in stock: when a variant is sold out, customers can leave their email. Requests arrive as contact form emails in your store inbox. You notify customers yourself.

Sections below the product

  • Bought together: related products that customers can add with one click.
  • Ritual steps, Product recommendations and Recently viewed.
  • Shade finder: shade swatches that select the matching variant. Add it to a product template for products with shades.

Product cards offer a quick add button for products without options. Cards in recommendations and quiz results also offer a quick view.

Collections and search

  • Filters: set them up in the Search & Discovery app under Filters. Bloomly shows them in a filter panel on collection and search pages, with sorting.
  • Collection tabs: collections with products appear as tabs below the heading.
  • Promo tiles: up to two large tiles inside the product grid. Leave a heading empty to hide a tile.
  • Collection navigation menu: choose a menu with your collections in order to show previous and next links.
  • Visitors can switch between three and four columns, and load more products without leaving the page.
  • The search page shows products first, then articles and pages. Predictive search in the header suggests products while visitors type.

Cart

  • Adding a product opens the cart drawer. Visitors can change quantities, add an order note and see related products.
  • The free shipping bar uses the value from Theme settings > Cart.
  • The cart page shows discounts, unit prices, subscription details and accelerated checkout buttons.

Blog and page templates

  • Blog: a large heading, tabs for article tags, one lead article and a list of the others.
  • Article: reading time, table of contents for articles with at least three headings, reading progress and related articles. Products from the custom.featured_products article metafield appear below the text.
  • Page templates: assign them to a page in Online Store > Pages under Theme template.
    • page.about: story hero, statement, timeline, ingredients and banner.
    • page.faq: numbered questions. Add one Question block per question.
    • page.contact: a contact form with topics, details and help links.

Metafields

Create these definitions in Settings > Custom data. They are all optional.

OwnerNamespace and keyTypeUsed for
Productcustom.card_wordSingle line textShort word above the product title
Productcustom.key_activesMulti-line textKey actives block and the line under product cards. One active per line: Niacinamide | Refines the look of pores
Productcustom.ingredientsMulti-line textIngredient list block
Articlecustom.featured_productsList of productsProducts shown below an article
Productreviews.rating, reviews.rating_countSet by review appsStar ratings

Languages

Bloomly includes English and German. Texts that you type into the theme editor stay as you write them. To translate them, use the free Shopify Translate & Adapt app. Many settings have a note "Leave empty to use the translated default". Leave those empty to get the built-in translation in every language.

FAQ

How do I update Bloomly to a new version?

When an update is available, Shopify shows a notice next to Bloomly in Online Store > Themes. Shopify adds the new version to your theme library and keeps your settings and content. Preview it, then publish it. Changes made directly in the theme code are not carried over. See the release notes for what changed.

Why don't I see star ratings?

Bloomly reads the standard review metafields reviews.rating and reviews.rating_count. Install a review app that writes them, such as Shopify Product Reviews or most other review apps. Stars appear as soon as a product has reviews.

Why is the Complementary products block empty?

Choose complementary products in the Shopify Search & Discovery app under Product recommendations. The block stays hidden for products without complementary products.

Why don't I see the Shop Pay Installments message?

The message appears only when Shop Pay Installments is available for your store, your country and the product price. It is part of the Product price block and can be turned off there.

How do I add product filters?

Install the Shopify Search & Discovery app and add filters under Filters, for example availability, price, product type or shade. They appear on collection and search pages.

How do I set up the beauty quiz?

Add Question blocks for the steps of the quiz. The last block must be a Result question: choose a collection for each answer. The quiz then shows products from that collection.

How does the shade finder choose the right variant?

Each Shade block has a field Matching variant option value. Enter the option value exactly as it appears on the product, for example Medium. Clicking the swatch then selects that variant.

Where do back-in-stock requests go?

They are sent as contact form messages to your store email address. The message contains the product and variant. Write to the customer when the product is available again.

How do I change the delivery estimate?

Select the Delivery estimate block on the product page. Set the cut-off hour and the minimum and maximum business days so they match your real shipping times.

Why do some sections show grey illustrations?

These are placeholders that show where an image or a collection is missing. They disappear as soon as you choose an image or a collection in the section settings.

Does Bloomly work with apps?

Yes. Apps that offer app blocks can be added to the product page and the Featured product section. App embeds can be turned on in the theme editor under App embeds.

Can you customize Bloomly for me?

Support covers questions about Bloomly's settings and features and fixes for problems in the theme. Custom code changes and design work are not included. See the support page for details.

Getting help

If this guide does not answer your question, contact Bloomly support. We reply within two business days.