Skip to content

Product pages

This guide describes setting up your store's Product pages section. Use the section to set what's displayed when a visitor selects a product from your store.

In the following image, a product pages section is displayed on a store's product page. The section's settings menu is on the left side. In the menu, the section's default blocks are displayed.

An example product pages section in Theme editor

For general guidance with modifying sections, refer to Sections overview.

Set up a product pages section

To set up a product pages section:

  1. Go to Customize theme. At the top of the page, use the dropdown to select a template that contains a product pages section. For example, select the Products > Default product template.

    Note

    The product pages section is available only on Default product, Fashion, Preorder, and Music product pages.

  2. From the side menu, select Product pages.

    The product pages section selected in Theme editor

  3. Select a section setting described in the following table.

Section setting nameDescription
LayoutFor products with multiple images, select the Layout dropdown to set a position for thumbnail product images inside the section. The options are Full width with thumbnails bottom, Full width with thumbnails left, and Narrow width with thumbnails bottom.
Horizontal thumbnail layoutFor products with horizontal thumbnail images, select the dropdown Horizontal thumbnail layout to set a size for thumbnail images inside the section. The options are Fixed size (uniform size) or Fit to image (thumbnails are sized based on the image's size).
Show thumbnails on mobileSelect the checkbox Show thumbnails on mobile to show/ hide thumbnail images inside the section on smaller (mobile) displays.
Mobile image layoutSelect the dropdown Mobile image layout to set a width for images inside the section on smaller (mobile) displays. The options are Content width (displays a border around images) and Full width (no border around images).
Media > Media typesFollow the Media types link to open the webpage Shopify help: Product media.
Media > Hide first videoIf your store uses a Product - feature video section, for products that have video media, the first product video is displayed automatically. Select the Hide first video checkbox to show/ hide the first product video inside the section. Refer to Shopify help: Product media.
Media > Enable image zoomSelect the checkbox Enable image zoom to show/ hide a panel that contains product images, inside the section. The panel opens when a product's image is selected inside the section. The panel provides zoom in/out for images, arrow icons for navigating between images, and an X icon to close the panel.
Media > Enable video loopingSelect the checkbox Enable video looping to turn on/ off continuous replay for videos inside the section. If this setting is set to off, videos play once. Refer to Shopify help: Product media.
Media > Autoplay videos on desktopSelect the checkbox Autoplay videos on desktop to turn on/ off playing videos automatically, inside the section. This setting applies to desktop displays.
Theme settingsSelect Theme settings to access additional settings for the section. Refer to Section theme settings menu.

Configure a block within a product pages section

A default product pages section contains six blocks. To configure a block inside the section:

  1. Go to Customize theme. At the top of the page, use the dropdown to select a template that contains a product pages section. For example, select the Products > Default product template.

  2. From the side menu, expand the Product pages section menu.

  3. To configure an existing block, select the block from the side menu.

    To add a new block, select Add block, choose a block to add, and then select the block you added.

    The add block options for the product pages section in Theme editor.

    Note

    Inside a product pages section, you can add, remove, show/ hide, or move blocks. Refer to Configure blocks inside a section, or Shopify help: Sections and blocks..

  4. Apply the corresponding block settings described in the Table: Product pages blocks.

Table: Product pages blocks

The following table describes the blocks inside the product pages section, and their corresponding settings.

Some blocks have No customizable settings available. The blocks indicated with an asterisk * are contained in a default product pages section. To configure a block, refer to Configure a block within a product pages section.

Block nameBlock descriptionBlock setting(s)
Title*Displays a product's title inside the section.No customizable settings available.
Price*Displays a product's price inside the section.No customizable settings available.
Variant picker*Displays a variant picker for choosing variations of a product, inside the section.
  • Select the Options style dropdown to set a style for the variant picker to Drop down or Button.

  • Select the Hide option labels checkbox to show/ hide the name of the currently selected product variant inside the block.
Quantity selector*Displays a quantity selector, inside the section, for choosing the number of products to purchase.No customizable settings available.
Buy buttons*Displays the Add to cart and Buy it now buttons inside the section.
Description*Displays a text area to contain additional product information, inside the section.
  • Select the Truncate description checkbox to show/ hide a Read more button, inside the block. Selecting the button opens an expanded text area that contains additional product information. Enable this setting for products with variant images and longer descriptions. To use this setting, set collapsible tabs to off.
VendorDisplays the name of a product's vendor inside the section.No customizable settings available.
Share buttonsDisplays an area, inside the section, with buttons for sharing links to your store's products via social media. Refer to Social media.No customizable settings available.
TextDisplays a text area to contain additional product information, inside the section.
  • In the Text box, enter text to display inside the block. To display text from a dynamic source, like product Title or Vendor, select the Insert dynamic source icon, beside the Text box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Select the Font dropdown to set the text, inside the block, to use the same font as Heading or Body text.

  • Select the Text size dropdown to set a size for the text, inside the block. The options are: S = small, M = medium, M/ desktop L = medium on smaller displays and large on desktop displays, M/ desktop XL = medium on smaller displays and extra large on desktop displays, and M/ desktop 2XL = medium on smaller displays and extra large x 2 on desktop displays.

  • Select the Icon dropdown to choose a graphical icon to display beside the text, inside the block. There are 26 icons, including: Box, Check mark, Map pin, Price tag, and Star. For no icon, select None (default).
Rich textDisplays a formatted text area to contain additional product information, inside the section.
  • In the Text box, enter text to display inside the block. Format the text using the text editor pane. To display text from a dynamic source, select the Insert dynamic source icon, beside the Text box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Audio playerDisplays an audio player inside the section for playing the audio tracks and tracklists associated with a product.
  • In the Tracklist box, enter a song title for each track to be add to a tracklist. Place each song title on a separate line. Format the text using the text editor pane. To add fields from a dynamic source, like product media files, select the Insert dynamic source icon, beside the Tracklist box, and then choose a metafield to add. Refer to Shopify help: Metafields and Show an audio player with tracklist on products.
Audio player - tracklistDisplays a (playable) list of audio tracks associated with a product, inside the section.
Ordered listDisplays a numbered/ ordered list of items inside the section
  • In the List box, enter text for each item to add to the list. Place each list item on a separate line. Format the text using the text editor pane. To add fields from a dynamic source, select the Insert dynamic source icon, beside the List box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Collapsible tabDisplays a text area with expandable tabs, to contain additional product information, inside the section.
  • In the Heading box, enter text to display as the block's title text. To display text from a dynamic source, select the Insert dynamic source icon, beside the Heading box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Select the dropdown Heading text style to set the style for the block's title text. Set titles to use the same font as Heading or Body text.

  • In the Tab content box, enter text to display inside the block. Format the text using the text editor pane. To display content from a dynamic source, select the Insert dynamic source icon, beside the Tab content box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Use the selector Tab content from page > Select page to add content from another store page into the block. To display content from a dynamic source, select the Connect dynamic source icon, beside the selector, and then choose a dynamic source to add. You must define sources of dynamic content. Refer to Shopify help: Metafields

  • Select the Icon dropdown to choose a graphical icon to display beside the block's title text. There are 26 icons, including: Box, Check mark, Map pin, Price tag, and Star. For no icon, select None (default).
Icon listDisplays a list of items with icons, inside the section.
  • In the Heading box, enter text to display as the block's title. To display content from a dynamic source, select the Insert dynamic source icon, beside the Heading box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Select the Text color dropdown to set a color for text inside the block to Text or Secondary.

  • For list items 1 to 5, use the Item # > Text box to enter text to display beside the item, inside the block. To display content from a dynamic source, select the Insert dynamic source icon, beside the Text box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • For list items 1 to 5, select the dropdown Item # > Icon to choose a graphical icon to display beside the item's text, inside the block. There are 26 icons, including: Box, Check mark, Map pin, Price tag, and Star. For no icon, select None (default).
Pop-upDisplays a pop-up overlay to contain additional product information, inside the section.
  • Select the Icon dropdown to choose a graphical icon to display beside the text, inside the block. There are 26 icons, including: Box, Check mark, Map pin, Price tag, and Star. For no icon, select None (default).

  • In the Link label box, enter label text for the link to use inside the block. When the link is selected, a pop-up overlay is displayed. To use text from a dynamic source, select the Insert dynamic source icon, beside the Link label box, and then choose a metafield to add. Refer to Shopify help: Metafields

  • Use the selector Page > Select page to add content from another store page into the block. To display content from a dynamic source, select the Connect dynamic source icon, beside the Page selector, and then choose a dynamic source to add. You must define sources of dynamic content. Refer to Shopify help: Metafields.

  • Select the Text color dropdown to set the color for text inside block to Text or Secondary.
Location inventory statusDisplays the quantity of a product that's available in each inventory location, inside the section.
Specification listDisplays a "glossary of terms" style list inside the section.
  • In the Heading box, enter text to display as the block's title. To display content from a dynamic source, select the Insert dynamic source icon, beside the Heading box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Select the Label text color dropdown to set a color for text inside the block to Text or Secondary.

  • For items 1 to 5, use the Item # > Label box to enter text to display as the item's label text (prefix), inside the block. To display content from a dynamic source, select the Insert dynamic source icon, beside the Label box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • For items 1 to 5, use the Item # > Text box to enter (suffix) text to display beside the label, inside the block. To display content from a dynamic source, select the Insert dynamic source icon, beside the Text box, and then choose a metafield to add. Refer to Shopify help: Metafields.
QuoteDisplays a text area inside the section to contain a comment/ quote about a product from a customer, client or staff member.
  • Select the dropdown Text style to set the block's text to use the same font style as Heading or Body text.

  • Select the Text size dropdown to set a size for text inside the block. The options are: S = small, M = medium, M/ desktop L = medium on smaller displays and large on desktop displays, M/ desktop XL = medium on smaller displays and extra large on desktop displays, and M/ desktop 2XL = medium on smaller displays and extra large x 2 on desktop displays.

  • In the Quote box, enter text to display as a quote inside the block. Format the text using the text editor pane. To display text from a dynamic source, select the Insert dynamic source icon, beside the Quote box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • In the Source box, enter a name to display inside the block as the source of the quote. To display text from a dynamic source, select the Insert dynamic source icon, beside the Quote box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Inventory statusDisplays a text indicator of a product's availability, inside the section.
  • Adjust the Low inventory threshold slider to set a value between 0 and 20. When the in-stock quantity of a product is greater than the slider value, the text Ready to ship is displayed inside the block. Otherwise, the text Only n in stock is displayed inside the block. n is the in-stock quantity of the product.
Buy it withDisplays recommendations for products related to the current product, inside the section.
  • In the Heading box, enter text to display as the block's title. To display text from a dynamic source, select the Insert dynamic source icon, beside the Heading box, and then choose a metafield to add. Refer to Shopify help: Metafields.

  • Select the dropdown Heading text style to set the style for the block's title text. Set the title to use the same font as Heading or Body text.

  • For Product 1 and Product 2, use the following menu selector options to set up products to display inside the block.

    • To add a product, choose Select product, enter the name of a product into the Search box and/ or select a product from the list. Then, choose Select.
    • To create a new product, select Create product to open the Create product page in Shopify admin. Refer to Shopify help: Products.
    • To replace a product, choose Change > Change product. Enter the name of a product into the Search box and/ or select a product from the list. Then, choose Select.
    • To remove a product, select Change > Remove product.

  • For Product 1 and Product 2, to display products from a dynamic source, select the Insert dynamic source icon, beside the Product 1/ 2 box, and then choose a metafield to add. Refer to Shopify help: Metafields.
HTMLDisplays custom HTML inside the section.In the HTML box, enter custom HTML to display inside the block.
Star ratingDisplays customer submitted product ratings represented as star icons inside the section.
  • Select the dropdown Star rating type to set the type of ratings to display inside the block. The options are Theme or Shopify product reviews. Refer to Product reviews.
  • Select the dropdown Star color to set a color for the star (rating) icons inside the block to Text or Accent.