Documentation

Structure a product page that converts

The blocks of the Story Theme product page, the recommended order in the buy column and the key settings of the photo gallery.

Your product page is the page that makes or breaks the sale. In the Story Theme, it's built entirely from blocks: the gallery, the title, the price, the buy button… You can move them, duplicate them, hide them or add others, without touching the code.

The Lumyx demo store's product page: gallery with thumbnails on the left, buy column on the right with the rating, title, price, swatches and offers as cards
The Lumyx demo store's product page: gallery with thumbnails on the left, buy column on the right with the rating, title, price, swatches and offers as cards

Open the product page template

  1. In your Shopify admin, open Online Store > Themes.
  2. Click Edit theme next to the Story Theme.
  3. In the dropdown at the top of the editor, choose Products > Default product.
  4. In the sidebar, expand the Product page section, then the Group block: this is the buy column, to the right of the gallery on desktop.
Screenshot to take — Theme editor > Products > Default product template > left sidebar: "Product page" section expanded, "Group" block expanded showing Breadcrumb, Product rating, Product title, Price, Variant picker, Stock, Quantity, Buy buttons, Checklist, Delivery date, Product description, Group; product page preview on the right

Remember to check how it looks on a phone too, by switching the editor preview to mobile view: most of your customers shop from their phone.

The same Lumyx product page on mobile: full-width gallery with its thumbnails, then the rating and title, and the sticky buy bar at the bottom of the screen
The same Lumyx product page on mobile: full-width gallery with its thumbnails, then the rating and title, and the sticky buy bar at the bottom of the screen

The included blocks, in order

The Default product template comes with a gallery and a buy column already organized. This order follows the path of a customer who discovers the product and then makes up their mind:

The top of the buy column: star rating, product title, subtitle and compare-at price with its discount badge
The top of the buy column: star rating, product title, subtitle and compare-at price with its discount badge
OrderBlockWhat it does
1BreadcrumbPlaces the product within your store.
2Product ratingStars and review count (see Show customer reviews).
3Product titleThe product name.
4PriceThe price, the compare-at price and the tax note.
5Variant pickerSizes, colors… (see Variants and swatches).
6StockThe availability of the selected variant.
7QuantityThe quantity selector.
8Buy buttonsThe add to cart button.
9ChecklistThree or four short selling points.
10Delivery dateThe estimated shipping and delivery dates.
11Product descriptionThe description entered in Shopify.
12Group with two Accordion / FAQCollapsible details: care, shipping, returns…

The section also contains the Sticky add to cart block, which ships hidden (see Sticky add to cart button). Below the product page, the template continues with other sections: selling point columns, image with text, FAQ, testimonials, customer photos and related products.

A Story Theme product page: gallery on the left, buy column on the right with title, price, quantity, buy button and delivery dates
A Story Theme product page: gallery on the left, buy column on the right with title, price, quantity, buy button and delivery dates

On mobile, the same blocks stack under the gallery, in the same order:

The Sylys demo store's product page on mobile: gallery, thumbnails and title, with the sticky buy bar (price and button) at the bottom of the screen
The Sylys demo store's product page on mobile: gallery, thumbnails and title, with the sticky buy bar (price and button) at the bottom of the screen

For details on each block and its settings, see Product page blocks: buying and Product page blocks: content, as well as the Product page section.

Add, move or hide a block

  1. To add a block to the buy column, click Add block under the last block of the Group. Product-specific blocks are grouped in the Product page and Offers categories.
  2. To move a block, drag it by the handle to the left of its name.
  3. To hide a block without deleting it, click the eye icon next to its name.
  4. Click Save at the top right.

Useful blocks to add depending on your business:

  • Offers: quantity discounts, bundles, "buy X, get Y" (see Quantity discounts and bundles).
  • Trust badges, Tabs and Collapsible row (see Trust badges, tabs and accordions).
  • Rotating messages: a few short messages (returns, warranty) that rotate below the button, without shifting the page.
  • Size guide, Personalisation field (engraving, gift wrap), Free shipping progress.
  • Add-ons: accessories to check, added along with the product.
Below the buy button, add-ons to check shown as cards (extra bar, clips, remote, warranty), each with its price
Below the buy button, add-ons to check shown as cards (extra bar, clips, remote, warranty), each with its price
The buy column with trust badges as cards and Dimensions, Materials and care, Shipping and returns accordions
The buy column with trust badges as cards and Dimensions, Materials and care, Shipping and returns accordions

Click the Product gallery block to open its settings.

  • Desktop layout: Carousel (default), Stacked, Grid or Mosaic. A stacked or grid layout shows several photos at once; the carousel keeps the page shorter.
  • Mobile layout: keep Carousel unless you have very few photos.
  • Image ratio: Portrait (4:5) by default. Choose the format of your photos, or Adapt to image if they have different formats.
  • Show thumbnails and Thumbnails position: below the photo, on the left or on the right.
  • Enable zoom: lets customers open photos full size. Off by default.
  • Hide variant images (on by default): photos linked to a variant only show when the customer picks that variant. For this to work, assign an image to each variant in the product in Shopify.
  • Keep visible while scrolling: on desktop, the gallery stays on screen while the customer scrolls through the buy column.
A carousel gallery with thumbnails on the left, staying visible while the customer scrolls through the buy column's features and accordions
A carousel gallery with thumbnails on the left, staying visible while the customer scrolls through the buy column's features and accordions
Another layout on the Pulse demo store: photos shown in two columns, several visible at once
Another layout on the Pulse demo store: photos shown in two columns, several visible at once
Screenshot to take — Theme editor > Products > Default product > Product page section > "Product gallery" block selected: settings panel open, Layout and Ratio groups visible (Desktop layout, Mobile layout, Image ratio)

The gallery also plays Shopify and YouTube videos added to the product, and 3D models, with a button to view the item in your own space with augmented reality.

Learn more