Docs
Page templates

Product page

The Product page of Local: the gallery and media settings, variant selection, sticky add to cart, and the blocks that build the product information.

Applies to: Local 4.2.1 and later. Added in: Local 1.0.0. Last checked: 2026-10-13 against Local 4.2.1.

The Product page section shows one product: its media gallery on one side and the product blocks (title, price, variant picker, buy buttons and the rest) on the other. It is the main section of the product template, so every product that uses the template gets the same layout.

Where to find it: in the theme editor, open the template picker and select Products → Default product, then select Product page.

Media

The Media settings choose how the product images and videos are shown.

Gallery style sets the desktop gallery. Mobile always shows a slider.

  • Slider shows one image at a time, with dots or thumbnails to move between them.
  • Scroll one column (the default) stacks the images in one column that the customer scrolls past.
  • Scroll two columns shows the images in a two-column grid. Turn on Enhance first image to show the first image at full width above the grid.

Product page gallery in the Slider style on the Caffeine demo: one large image with slider arrows and dots below.

Product page gallery in the Scroll one column style: product images stacked in a single column.

Product page gallery in the Scroll two columns style: product images side by side in two columns.

The other media settings:

  • Images aspect ratio crops every image to the same shape (4:3, 1:1, 5:6 or 2:3). Natural, the default, keeps each image uncropped.
  • Fit images inside container (cropped ratios only) shows the whole image inside the chosen shape instead of cropping it.
  • Videos and other media aspect ratio keeps videos and 3D models in their own shape, or makes them follow the images aspect ratio. Crop videos when following images aspect ratio then fills the shape with the video.
  • Show border around gallery draws a thin border around each image.
  • Inherit card design properties gives each image the card border, background and shadow from Theme settings. It replaces Show border around gallery.
  • Gallery inner spacing adds space inside each image frame, 0 to 15 %, so the product floats in the frame.
  • Enable image zoom opens the image full screen when the customer clicks it; the image moves with the mouse.
  • Disable parallax effect turns off the slight sideways movement of the images while the customer swipes the slider.

Gallery slider pagination chooses how customers move through the slider: Dots under the image, or Thumbnails of every image. The scroll gallery styles show the thumbnails only on mobile, where the gallery is a slider.

Product page gallery slider with the Gallery slider pagination set to Dots, highlighted under the image.

Product page gallery slider with the Gallery slider pagination set to Thumbnails: small image previews under the main image.

When the customer selects a variant that has its own image, the gallery moves to that image.

Videos

  • Enable video looping (on by default) replays product videos when they end.
  • Enable video autoplay starts videos on their own. Autoplaying videos are muted and have no controls.

Functionality

Select the first available variant by default (on by default) selects the first variant in stock when the page opens, so customers can add to cart right away.

When you turn it off, no variant is selected. The add to cart button says "Choose a variant first" until the customer picks one, and the SKU and the selected variant's price stay hidden until then. Products with only one variant are always selected.

Sticky add to cart

Turn on Enable sticky add to cart to show a bar with the product title, price and an add to cart button once the customer scrolls past the main add to cart button. On mobile the bar appears as soon as that button leaves the screen. Sold out products do not show the bar.

  • Enable add to cart for multiple variants makes the bar's button add the selected variant, with the quantity and options chosen on the page. When it is off, products with several variants show Choose options in the bar, which scrolls back to the variant picker. Products with one variant always get the add to cart button.
  • Style sets a Wide bar across the bottom of the screen or a smaller Floating bar.
  • Background color and Text color set the bar's colors. Blur background makes the bar semi-transparent and blurs the page behind it.

Sticky add to cart bar in the Wide style with a custom black background: the product name Nicaragua, the price $25 and an Add to cart button across the bottom of the screen.

Sticky add to cart bar in the Floating style with Blur background on: a smaller bar floating over the product page content.

The sticky bar works with the Buy buttons block: keep that block on the page.

Product page blocks

Everything next to the gallery is a block. Add blocks with Add block in the Product page section and drag them into order. The default product template starts with Vendor, Title, Price, Variant picker, Buy buttons, Description and Share, with Empty space blocks between them.

The blocks are documented by task:

Many blocks share two groups of settings:

  • Block Heading: Title, Subtitle, Tooltip text (a small info icon next to the title that shows the text on hover) and Icon (a small image before the title, 76 x 76 px PNG).
  • Block Style: Collapsible lets customers open and close the block by clicking its heading, and Opened by default shows it open when the page loads. Layout sets Boxed (a framed box) or Compact (no frame). Custom text color, and for boxed blocks Custom background color and Darken the header, change the block's colors.

A block can collapse only when it has a Title or a Subtitle: the heading is what customers click.

The Featured product section and the Quick view popup use the same blocks. The Product recommendations section sits below the Product page section in the default template; see Product recommendations section.

Can I use a different product page for some products?

Yes. Create a second product template and assign it to those products. In the theme editor, open the template picker, select Products → Create template, and base it on Default product. Then open each product in Shopify admin and choose the new template under Theme template. A separate template is how you give pre-order products their own button label, or food products their nutrition blocks.

Why must customers choose a variant first?

Because Select the first available variant by default is off. Until the customer selects a value for every option, the add to cart button says "Choose a variant first" and the price shows the lowest price ("From …") when variants have different prices. Turn the setting on in Products → Default product → Product page → Functionality to preselect the first available variant.

The thumbnails appear only with Gallery slider pagination set to Thumbnails, and only on the slider. With Scroll one column or Scroll two columns, desktop shows every image stacked, so there are no thumbnails; mobile and tablet show them under the slider.

All Product page settings

Every setting of the section and of its 35 blocks, with its type and default.

On this page