Truly fine

Documentation.

Product page

Last update:

This template provides the default layout for each one of your store’s products. It is applied automatically to any new product created under Products from your Shopify Admin.

Template contents

The product template consists of one main section (“Product information“) and one optional (“Product recommendations“):

Product information section

The product information section pulls all the information provided during product creation and uses them to create the product’s layout.

Settings

Pre-select first available variant: Only applies when the selected product has variants. When enabled, the default Shopify behaviour of pre-selecting the first available variant is maintained. When disabled, no variant will be pre-selected, and variant-depended elements will be hidden (e.g. SKU, price, Add to cart button, etc) until the customer selects a variant. This setting may also affect other behaviour as required, for example, the “Hide single variant” setting of the Variant picker block will be ignored since the user needs to select a variant.

Hide other variants’ media after selecting a variant: If enabled, this setting will hide the media of other variants when selecting a particular variation. Enable this if you want to only show the selected variation’s image on the product media gallery, instead of all product images for all variants.

Layout: Choose the overall layout of the product: “Normal” vs “Alternative”. The “Alternative” layout will feature the title and product meta (such as SKU, rating stars, etc) inline with the product gallery.

Gallery position: Choose whether you want the gallery to be on the left or right (default “right”).

Show thumbnail navigation arrows: Applies on desktop only. Displays navigation arrows on products with a lot of thumbnails in the thumbnail carousel.

Image zoom: Choose between “Lightbox“, “Zoom on hover“, “Lightbox and Zoom on hover“, and “None“. Lightbox (the default option) will enlarge the product’s main image in its own frame. Zoom on hover will zoom the image in a dedicate preview box next to it while the customer is hovering over the product’s main image.”Lightbox and zoom on hover” enables the behavior of both at the same time. Finally, “None” will disable zooming on the product’s images in any way. Note that this setting applies only on desktop (with the exception of the “None” option that disables it everywhere). In mobile the image enlarging functionality is always the Lightbox.

Images ratio: This option allows you to select the ratio of the images that will appear on the on the product’s media gallery. “Adapt to image” (default) means that the ratio will be the inherent ratio of the first image, however this may be problematic if you have extremely tall images. Portrait, Square, and Landscape will force the images to be displayed as portrait, square, or landscape ratios respectively.

Images disclaimer: Optionally add disclaimer text under the product’s gallery.

Show custom badges (if available): Display the product’s custom badges.

Collapse other expandables: When an expandable block is expanded, collapse all other blocks.

Section spacing

The section spacing settings gives you the option to adjust the top & bottom section spacing values. Please note: If you select a color scheme with a background color, these settings will affect the spacing between the top or bottom of the section and the content of the section.

Blocks

For maximum customization you can adjust this section’s layout by configuring its blocks. Note that you can reorder blocks as you see fit.

Title: The title block by default will also display the vendor, SKU, and barcode. You can also set it to display the product’s rating (learn how to set up product ratings here), and you can choose to hide the rating if there are no reviews. Finally, you can choose to show custom badges if you’ve set them up, the product’s custom excerpt, or a custom collection image for this product.

Text: You can add extra text with an icon or set additional text lines with custom icons next to them. The text section also comes with a Color Scheme setting that can be used to make product text sections stand out.

Price: The price block displays the price (as well as discounts, group pricing, and other pricing info) and the stock status label (in stock, out of stock, etc).

Variant picker: If the selected product contains variants, they will be shown on this block. You can choose from two different layouts for their display (buttons or dropdowns). For the “button” variant, you can select the buttons’ color scheme (secondary or primary buttons). You can also opt to hide the variant picker if only one variant exists across any combination of product options (size, color, etc). Finally, there are visibility settings (Show, Hide, and Show disabled) for out of stock variants, and invalid variants (non-existing combinations of product options).

Buy buttons: Control visibility of the quantity field, add to cart button, and dynamic checkout buttons. Throhugh this block you can also enable the recipient form for gift cards where your customer can send a gift card to another person automatically after purchase (only applies on gift card products). More information about selling gift cards can be found on Shopify’s official guide.

Details: This special block will display a custom heading title with an optional icon next to it, and product details such as the product’s SKU, vendor, barcode (with a custom barcode label), product type, and any metafields in its own box.

To show your metafields, add a new line with the desired title and metafield prefix and key, separated by a colon and space “: “. For variant-level metafields, also add “variant.” before the prefix. Example:

Width: custom.width 
Profile: custom.profile 
Rim Size: custom.rim_size 
Specifications: variant.custom.specifications
Other product field: prefix.key
Other variant field: variant.prefix.key

When a product doesn’t have a value defined for the specific metafield, it will not be displayed at all. This allows you to add different metafields for different kinds of products, and only the most appropriate ones will be displayed. For example, tires have a wheel size value and batteries have a capacity value. Since tires don’t have a capacity value, the capacity metafield will not be displayed on them.

Pickup availability: This block displays pickup availability information and does not offer any customization options.

Complementary products: Use this block to display hand-picked complementary products, selected via the Shopify Search & Discovery app. You can set a custom heading, set the maximum products to show (1-10), and toggle the visibility of product’s vendor, product rating (if available) and the “Add to Cart” button.

Description: This block displays the product’s description. It offers a customizable heading, and no additional customization settings.

Custom: Add additional text blocks, to share additional product information such as usage instructions, sizing guides, etc. A custom heading and text can be set.

Reviews: This block adds a new tab next to products description. You can use this block to display any available product reviews selected via the Product Reviews app.

Product signup: This block allows your customers to sign up to your newsletter form. Anyone that subscribes to this section will be automatically added to your “accepted marketing” customer list, but you will also receive the URL of the product they signed up from, so you can take further action if needed. You can customize it by setting a heading, enabling a consent checkbox, and selecting a color scheme. You can also set it to only be displayed on out-of-stock products.

Image: This simple block allows you to display an image, optionally linked to a URL. You can further restrict the image’s width, and set its alignment when it’s smaller than its container’s width.

Product metadata: Allows you to display product metadata (vendor, SKU, and barcode) in a single line.

Stock bar: This block displays a stylized stock availability badge, along with your own additional text for when the product is in stock, out of stock, has low inventory, etc.

Info box: This block allows you to grab the attention of your customers by showing a customized message, along with the icons of the accepted payment methods (optional). You can further customize this block by setting an icon, and text and background colors.

Custom Liquid: If you are a bit code savvy, the custom liquid block allows you to add templating on your product using Shopify’s Liquid templating language. This block also offers a Position setting which will dictate whether it will be rendered on the product’s main information (selecting the “left” option) or on the right hand side area (“right” – under the gallery by default). The block is hidden when there is no output from the Custom liquid setting.

Personalization text: (since v4.0) This block allows you to collect additional personalized information for a product, such a inscription texts, custom sizes, etc. You can collect textual or numerical information. Since v4.1, you can also collect values from fields of type date, text area, dropdown list, and checkbox.

Range indicator: (since v4.0) The range indicator block is perfect for offering a visual representation of numeric values within a given range. Showcase ratings, speed, temperature, and other numeric values in a visual way that your customers can grasp with a quick glance. Ideally used with dynamic sources.

Features: Show a set of features for all your products using this block, by adding up to three sets of Heading / Icon groups. You can also optionally choose a color scheme if you want to make the feature boxes stand out.

Content drawer: This block adds a link or button that when clicked, it opens a side drawer displaying the text or page content you select. A very useful block for secondary content that shouldn’t clutter the main product area.

Product recommendations section

The product recommendations section will display products based on Shopify’s product recommendation engine, generally taking into account purchase history, product descriptions and related collections. You can select the related products of each product by hand, via the Shopify Search & Discovery app.

Section settings

Show product recommendations: Toggle the visibility of product recommendations section.

Heading: Set a title for this section. This is optional.

Heading size: Adjust the size of your heading to make your message stand out. Available options: Small, Normal, Large, Extra large, and Extra extra large.

Number of products: Set the maximum number of recommended products (3-5).

Number of columns on mobile: Select the number of columns that will be displayed on mobile (1 or 2).

Product card

Show vendor: Whether to show the vendor in each product card above the product title.

Show stock status: Whether to show the stock status of each product.

Show excerpt: To display a product excerpt, add a product metafield with the namespace and key “custom.excerpt” and the “Single line text” type. Learn more about excerpt here.

Show product rating: Whether to show the product’s rating. Please note you will need a rating app for this to work. Learn more about product ratings here.

Colors

Color scheme: Select one of the predefined color schemes as defined in Theme settings > Colors. For more information regarding the color schemes please refer to our article about creating your own color scheme.

Section spacing

The section spacing settings gives you the option to adjust the top & bottom section spacing values.

SEO

Heading tag: Select the appropriate heading level (H1, H2, or H3) based on how you want the section title to appear.

Can't find what you are looking for? Feel free to submit a request.