Cosmero docsPre-release

Product page

12 min read

Every product in your store uses a product template. In Cosmero, its main section is Product information: the product’s media in one panel and its details in another, side by side on tablets and desktop, stacked on phones. Each part of the details, from the title to the share button, is a block you can move, edit or remove.

The default product template has three sections:

  • Product information: the gallery, the price, the buy buttons and the other product blocks. This page covers it.
  • Product details: rows of labels and values, such as Type or Ideal for, that you connect to product metafields. See Product details.
  • Related products: products that Shopify recommends from your sales and product data. See Related products.

You can add more sections below them. The Ritual section works here too, with steps you choose in the section itself. For steps that follow each product’s own complementary products, use the Ritual block instead.

Online Store → Themes → Customize

  1. From your Shopify admin, go to Online Store → Themes, then select Customize on Cosmero.
  2. Open the drop-down menu at the top of the theme editor (it starts on Home page) and choose the product template.
  3. In the sidebar, select Product information to change the section’s settings, or select one of its blocks to edit it.
  4. To add a block, select Add block under Product information, choose the block, then drag it into place.
  5. Select Save.

Product information also accepts app blocks, so blocks from apps you install, such as a reviews app, can be added the same way.

  • Show sticky add to cart: shows a bar with the add to cart button at the bottom of the screen once the buy buttons scroll out of view. It hides again when they’re back in view or the footer is reached. The bar shows the selected variant’s image, the product title, the variant and its price, and it adds the same variant and quantity as the buy buttons. It needs the Buy buttons block in the section.
  • Media position on desktop: Left or Right.
  • Media ratio: Adapt to media, Square or Portrait. Every frame in the gallery takes this shape, so images of different shapes don’t shift the page. Adapt to media uses the ratio of the first media.
  • Media fit: Contain shows each image whole inside its frame. Cover fills the frame and crops what doesn’t fit.
  • Keep media in view while scrolling: on tablets and desktop, the gallery stays in view while customers scroll through the product information.
  • Show thumbnails on desktop: shows small previews of the product’s media, in a row below the gallery on tablets and in a column beside it on desktop. Products with a single image or video show none. On phones, customers swipe through the gallery or use its arrows.
  • Show zoom: customers click or tap an image to see it full screen, then swipe or use the arrows to see the product’s other images. Videos and 3D models play in place.
  • Enable video looping: plays product videos on a loop, including YouTube and Vimeo videos.
  • Media color scheme: the colors of the gallery panel.
  • Product information color scheme: the colors of the panel with the blocks. The sticky add to cart bar uses it too.
  • Panel style: Panel or Flush. Flush panels span the full page width with square corners.
  • Enable full width on mobile: on phones, the panels span the full screen width with square corners. Shown when Panel style is Panel.
  • Top padding and Bottom padding: the space above and below the panels, from 0 to 120 px (48 px by default). Phones get a little less.

The template starts with these blocks, in this order: Title, Rating, Subtitle, Price, Divider, Variant picker, Purchase options, Quantity, Buy buttons, Pickup availability, Text, Benefits, Description, three Collapsible tab blocks, Ritual and Share. You can also add Vendor, Group and Custom Liquid.

A block with nothing to show for a product, such as Rating on a product without reviews, stays hidden on your store. Rating, Purchase options, Benefits and Ritual show a short hint in the theme editor instead, so you can still find them.

The product’s vendor, as a small label. It has no settings and is hidden when the product has no vendor.

The product title, as the page’s main heading. It’s never shortened, and it has no settings.

Shows the stars, the rating and the number of reviews that a reviews app saves to the product’s standard Product rating and Product rating count metafields. It’s hidden on products without a rating.

  • Link to reviews: the id of your reviews app’s block on the product page, such as #reviews, so the rating links to the reviews. Leave it empty to show the rating without a link.

The product’s Product subtitle metafield, as a short line under the title. It has no settings and is hidden when the product has no subtitle. Product cards show the same line when Show product subtitle is on in Theme settings.

The selected variant’s price, with the compare-at price when it’s on sale and the unit price when it has one. Under it, a short note says “Taxes included.” when your prices include tax, and “Shipping calculated at checkout.” with a link to your shipping policy when you have one.

  • Show sale badge: shows a “Sale” badge when the price is lower than the compare-at price. With a selling plan chosen, the badge shows what the plan saves.
  • Show Shop Pay Installments banner: shows Shopify’s installments message under the price, when Shop Pay Installments is turned on for your store.

A line between blocks.

  • Style: Subtle or Strong.

One control for each product option, such as Size or Shade. It’s hidden on products that have no options.

  • Style: Buttons or Dropdown.
  • Show swatches: uses the swatch colors and images from your product options.

Values that are sold out or unavailable are crossed out, but customers can still select them. Choosing a variant updates the price, the buy buttons, pickup availability and the page’s URL, and the gallery moves to the variant’s image.

Shows “One-time purchase” and the product’s selling plans, such as subscriptions or pre-orders from an app like Shopify Subscriptions, with each plan’s price and savings. It’s hidden on products without selling plans, and it has no settings.

  • “One-time purchase” is chosen when the page opens. It’s left out for products that can only be bought with a plan.
  • A plan that the selected variant doesn’t offer can’t be chosen. If customers switch to a variant without their chosen plan, they choose again before adding to cart.
  • If your app adds its own plan picker block, remove this one so the page shows one picker.

A quantity field with minus and plus buttons. When a variant has quantity rules (a minimum, a maximum or an increment), the field follows them and lists them below it. It has no settings.

The “Add to cart” button and, below it, Shopify’s dynamic checkout buttons. The button reads “Sold out” when the selected variant is sold out.

  • Show dynamic checkout buttons: shows the payment methods available in your store, such as Shop Pay or PayPal. Shopify sets the button colors.
  • Show recipient form for gift cards: on gift card products, adds a “Send as a gift” checkbox with fields for the recipient’s email and name, a message and a send date, so customers can send the gift card to someone else by email.

What happens after an add depends on Cart type in theme settings: the cart drawer opens, or a message with a link to the cart shows under the button. See Cart.

Shows whether the selected variant can be picked up, with the usual pickup time, and a link to a panel that lists each pickup location with its availability, address and phone number. It shows only when local pickup is set up for your store, and it has no settings.

A short line of text, such as the reassurance line in the template.

  • Text: the line itself.
  • Text style: Heading, Subheading, Normal text or Small text.
  • Alignment: left, center or right.

A grid of short claims, such as vegan or refillable, each with an icon or your own image above its text. Each claim is a Benefit block inside it.

A benefit without text is hidden, and the whole block is hidden when no benefit has text. So you can connect a benefit’s text to a product metafield to show it only on the products that have it. The template’s three benefits have no text, so they show nothing until you write or connect one.

  • Icon: Vegan, Cruelty-free, Fragrance-free, Dermatologist tested, Sensitive skin, Hydrating, Recyclable, Refillable, Natural origin, Paraben-free, Clinically tested, Made in (location pin) or None.
  • Custom image: replaces the icon. A square .png or .svg with a transparent background works best.
  • Text: keep it to two or three words. Connect a product metafield to show this benefit only on products that have it.

The product description you write in the Shopify admin. It’s hidden when the product has no description.

  • Display: Collapsible row or Inline.
  • Heading: the row’s heading. Shown when Display is Collapsible row.
  • Open by default: shows the description open when the page loads. Shown when Display is Collapsible row.

A row that opens to show more text. The template has three, for key ingredients, how to use, and shipping and returns.

  • Heading: the row’s heading.
  • Content: the text inside. Connect it to a product metafield to show different content on each product.
  • Page content: shows a page’s content below the text, such as your returns page.
  • Open by default: shows the row open when the page loads.

A row without a heading, or with neither content nor a page, is hidden.

Shows this product as step 1, then its complementary products as the next steps, with their total price and one “Add all to cart” button. The block is hidden on products without complementary products. To set them, see Complementary products.

  • Heading: the title above the steps.
  • Text: a short line under the heading.
  • Maximum products to show: the number of steps after this product, from 1 to 4 (2 by default).
  • Show total price: shows the total of the steps that “Add all to cart” adds.

How the steps work:

  • Step 1 is the product being viewed, marked “This product”, without a price.
  • “Add all to cart” adds one of each of the next steps, using each product’s first available variant. The total adds up their prices.
  • Products that are sold out, or sold only with a selling plan, are marked “Sold out” and left out of the button and the total.

A share button. Where the browser supports it, it opens the device’s share options. Elsewhere it copies the product’s link. It has no settings.

Holds other blocks together. When you add it, choose Column (blocks stacked) or Row (blocks side by side).

  • Layout direction: Horizontal or Vertical.
  • Alignment: Left, Center or Right. Shown when Layout direction is Vertical.
  • Padding: space inside the group, from 0 to 200 px. A horizontal group gets it at the sides, a vertical one at the top and bottom.

A group can hold Text, Divider, Collapsible tab, Custom Liquid and other Group blocks, but not the product blocks.

  • Liquid code: add app snippets or other Liquid code for advanced customizations.

The product page shows what you enter for each product in the Shopify admin.

  • Add an image to each variant. When customers choose a variant, the gallery moves to its image, and the sticky add to cart bar shows it too.
  • Swatches show for options that have swatch colors or images in the Shopify admin, such as a color option, while Show swatches is on.
  • A product with no options shows no variant picker.

The Ritual block, and “Complete your ritual” in the cart, use each product’s complementary products. Set them for each product in either place:

  • the Search & Discovery app;
  • the product’s Complementary products metafield in the Shopify admin.

Cosmero reads them through Shopify’s product recommendations, in the order you set them. Shopify leaves out products that are sold out.

Cosmero reads these standard Shopify metafields without any setup in the theme:

  • Product subtitle: the Subtitle block, and the line under the title on product cards.
  • Product rating and Product rating count: the Rating block, the rating on product cards, and the rating that search engines can read on the product page (see Product ratings in Theme settings). A reviews app fills them in.
  • Complementary products: the Ritual block and “Complete your ritual” in the cart.

For anything else that differs from product to product, such as ingredients or directions, create your own metafield and connect it to a block setting.

Settings → Metafields and metaobjects → Products

  1. In your Shopify admin, go to Settings → Metafields and metaobjects → Products, then select Add definition and create the metafield, such as Key ingredients.
  2. Fill in the metafield on each product.
  3. In the theme editor, open the product template and select the block, such as a Collapsible tab.
  4. Next to the setting, such as Content, select Connect dynamic source, then choose the metafield.
  5. Select Save.

You can connect a collapsible tab’s Content, a benefit’s Text, a text block’s Text and the values in Product details this way. The theme editor lists only the metafields whose type fits the setting.

  • Benefits are claims about your products. Add only the ones that are true for every product that shows them, or connect the text to a metafield so each product shows its own.
  • If your reviews app adds its own reviews block, set Link to reviews in the Rating block to that block’s id, so the stars take customers to the reviews.
  • For products that need a different layout, such as accessories without benefits, make a second product template: in the drop-down menu at the top of the theme editor, choose the product template type, then select Create template. To use it, open each of those products in the Shopify admin and choose the new template under Theme template.

Still stuck? We answer.

Contact support