Skip to content

Product Pages ​

Bocce's Bakery Product Page Hero

Overview ​

Most PDP templates are legacy .liquid templates that include a fixed list of sections. You can edit each section's settings in the customizer, but you cannot add, remove or reorder sections: that needs a code change to the template file.

TemplateFilePurpose
Defaultproduct.liquidStandard product
Bubbleproduct.bubble.liquidDefault PDP + ambient bubble animation, for spa / wash products
Build Your Bundleproduct.build-your-bundle.liquidBundle builder product
Catproduct.cat.liquidCat products (static-cat-ingredients instead of dog ingredients)
Halloweenproduct.halloween-product.liquidSeasonal
Quantity Upsellsproduct.quantity-upsells.liquidPDP with quantity upsells
No ATCproduct.no-atc.liquidProduct + recommendations only (no reviews)
Supplementproduct.supplement.liquidSupplement PDP
Basketsproduct.baskets.jsonGift baskets
ReCharge Bundleproduct.recharge-bundle.jsonReCharge bundle widget (app block only)
AJAXproduct.ajax.liquidProduct payload for quick shop

To assign: Shopify Admin > Products > [Product] > Theme template

Theme B only

Theme B also has product.limited-edition.json.

Default PDP layout ​

product.liquid renders these sections, in order:

#SectionNotes
1static-productGallery, buy box, subscription widget, reviews summary, persistent ATC bar
2static-ingredients"Our Recipe / Includes These Ingredients!"
3section-help-la-firesLA fires donation cards. Currently disabled (enable: false)
4section-blended-review-widgetScript only: blended Amazon/Chewy numbers in the Junip summary
5Junip review widgetrender 'junip-product-review'
6static-product-recommendations"Your Pet Will Also Love". See Product Recommendations

build-your-bundle, halloween-product, quantity-upsells, cat and supplement follow the same pattern. product.bubble.liquid is the default layout without the blended widget, plus section-bubble-animation.

section-ai-block.liquid ("See what AI knows about this product") is not included in any product template. The section file and its settings in settings_data.json exist, but it doesn't render anywhere.

Static Product Section ​

Section file: static-product.liquid → snippets/product.liquid (editor name Product pages)

SettingIDTypeCurrent
Product details alignmentdetails_alignmentselectleft
Variant options stylevariant_options_styleselectradio
Show variant SKUshow_variant_skucheckboxfalse
Show Flavorproduct-flavorcheckboxfalse
Show breadcrumbsshow-breadcrumbscheckboxtrue
Show quantity selectorproduct-quantity-optioncheckboxtrue
Show email linkproduct-email-linkcheckboxfalse
Show dynamic checkout buttonshow_spbcheckboxtrue
Enable cart redirectionenable_cart_redirectcheckboxfalse
Enable social sharingsocial-sharing-buttonscheckboxfalse
Enable Persistent ATCpersistent-atccheckboxtrue
Url build your bundleurl-buildurl/products/build-your-bundle
Enable image zoomimage-zoomcheckboxtrue
Product thumbnail positionthumb-orientationselectleft-right

Key features ​

  • Image gallery with zoom
  • Variant selector (radio)
  • Quantity + Add to Cart, which adds to the drawer instantly (see Instant cart updates)
  • Subscription widget (subscription-product.liquid, ReCharge)
  • Reviews summary under the title (junip-product-summary.liquid). See Reviews
  • "See Discounted Price in Bag" note for products in the sale collection. See Sale pricing
  • Persistent ATC bar: a sticky bar with image, title, price, the discount note (compact) and a Buy Now button
  • Stock handling shared with product cards: FIND STORE, SHOP ONLINE or OUT OF STOCK, driven by the custom.find_in_store_option, custom.not_in_store and custom.oss metafields. See Product card
  • Klaviyo back-in-stock form for sold-out variants (the klaviyo-bis-trigger buttons; the Klaviyo snippet itself is rendered in layout/theme.liquid)
  • No wishlist button: the Swym script loads globally, but swym-product-view.liquid isn't included anywhere

Reviews ​

Reviews come from Junip. For products that are also sold on Amazon and Chewy, the theme shows a blended rating from product metafields in the reviews namespace. The reviews.* metafields are written by an external daily sync:

MetafieldUsed for
reviews.amazon_reviews, reviews.chewy_reviewsIf either is > 0, the product "has external reviews"
reviews.blended_rating, reviews.blended_countBlended average and total shown instead of Junip's on-site figures
junip.rating_average, junip.rating_countOn-site figures (default)

Summary under the title (snippets/junip-product-summary.liquid):

  • Site-only products keep the junip-product-summary class, so the Junip SDK renders its native summary with a per-star breakdown dropdown.
  • Products with external reviews drop that class, so the SDK leaves them alone. The theme renders the blended average and count itself, and hides the breakdown chevron because there is no per-star data.
  • Counts use thousands separators (1,234).

Blended Review Widget (sections/section-blended-review-widget.liquid, on both themes):

  • It renders no visible block, only a script.
  • For products with external reviews, it waits for Junip's review widget and overwrites the average, star fill and count with the blended values.
  • The count reads, for example, "3,708 Reviews across all platforms".
  • It hides the per-star distribution bars.
  • Settings (padding_top, padding_bottom, custom_class) exist but only affect the wrapper.

Bubble Animation ​

Section file: section-bubble-animation.liquid. It is only included in product.bubble.liquid.

The section draws a decorative canvas of soap bubbles that rise up the page. The canvas doesn't respond to clicks, and it is not shown to visitors who prefer reduced motion. To edit it, open a product that uses the bubble template in the customizer; the section appears as Bubble animation.

SettingIDTypeDefault
Enable bubble animationbubble_enabledcheckboxtrue
Number of bubblesbubble_countrange 0–8026
Max bubble sizebubble_max_sizerange 8–6026
Rise speedbubble_rise_speedrange 20–300 (%)100
Opacitybubble_opacityrange 10–150 (%)100
Bubble colorbubble_colorcolor#ffffff
Bubble rim colorbubble_rim_colorcolor#e7feff
Layerbubble_layerselectfront (or behind content)

Product Recommendations ​

Section file: static-product-recommendations.liquid (editor name Recommended products). Same on Theme A and Theme B.

SettingIDCurrent
Show dynamic recommendationsshow_product_recommendationstrue
Headingproduct_recommendations_heading"Your Pet Will Also Love"

The section is a static {% section %} in every .liquid PDP template, so its settings are shared by all product pages.

The toggle only shows or hides the row

"Show dynamic recommendations" doesn't switch between dynamic and manual products. Turning it off removes the "Your Pet Will Also Love" row from every PDP.

How the products are picked ​

The theme doesn't choose the products. Shopify's built-in recommendation engine does:

  1. On page load, StaticProductRecommendations (in src/atlantic.js) requests /recommendations/products?section_id=static-product-recommendations&limit=4&product_id=<id>.
  2. Shopify returns the section rendered with its recommendations object, and the JS puts that HTML into [data-product-recommendations].
  3. No intent is passed, so Shopify uses the default related intent. The limit of 4 is hard-coded in the section (the API allows 1–10).

Shopify keeps a ranked list of up to 10 related products per product, and the row shows the top 4. The ranking uses:

SignalWhat it means
Purchase historyProducts bought together in the same orders. Orders imported from another platform aren't counted.
Product descriptionProducts with similar descriptions. Shopify's help center says this only works on English storefronts.
Related collectionsProducts from the same collections, excluding all and frontpage. Used only as a fallback when the two signals above have nothing, which is typical for new products with no sales.

Shopify recalculates often and doesn't publish a schedule, so the row can differ between visits. A product is never recommended if it is:

  • sold out (unless Continue selling when out of stock is on)
  • priced at $0, or a gift card
  • draft, unlisted, or not published to the Online Store
  • already in the visitor's cart, or the product being viewed

We can't change the weighting or exclude specific products from the automatic list.

Merchandising: pinning products to slots ​

Use the free Shopify Search & Discovery app. Its picks come back from the same /recommendations/products endpoint, so no theme change is needed.

  1. Shopify Admin > Apps > Search & Discovery > Product recommendations, then open the product.
  2. Under Related products, add up to 10 products. The list order is the slot order on the PDP.
  3. Keep auto-generated recommendations on. Manual picks then fill the first slots and Shopify fills the rest. Choosing to show only manual picks makes the whole row manual.
  4. To change many products at once, select them on the Recommendations page and click Bulk edit. This writes the Related products metafields and replaces each product's existing list.

Example: to push The Whole Holiday Bundle in slot #1 on Holiday Menu PDPs, add it as the first related product on each Holiday Menu product. Slots 2–4 stay dynamic.

  • Picks are set per product. Products added later don't get them automatically.
  • Picks don't expire. Remove them when the campaign ends.
  • A pick follows the same rules as the dynamic list. If it's sold out or already in the cart, it's skipped and the next product moves up.
  • The app's preview often differs from the storefront because the dynamic part changes.

Pinning one product across all PDPs

The admin has no setting that pins a product on every PDP at once. Doing that from one place would need a theme change. The plan would be optional pinned product pickers for slots 1–4 in this section, optionally limited to one collection, with dynamic results filling the empty slots and duplicates removed. This isn't built yet.

Shopify references: Search & Discovery: product recommendations · How related products are generated · Product Recommendations API

Ingredients ​

Section file: static-ingredients.liquid (Dog Ingredients list). The cat template uses static-cat-ingredients.liquid.

SettingIDCurrent
Headingtitle"Our Recipe"
Subheadingsubheading"Includes These Ingredients!"
Ingredients List Referenceingredients_listingredients menu
Ingredients Tag Referenceingredients_tag_refingredients-
Backgroundbg_color#fae0ce

Product tags starting with ingredients- are matched against the links in the ingredients navigation menu. These are the same tags the PLP Ingredient filter uses.

Supplement Product Template ​

Template: product.supplement.liquid

SectionFileDescription
Supplement Productstatic-supplement-product.liquidMain supplement PDP
Ingredientsstatic-supplement-ingredients.liquidIngredient breakdown
Image + Icon Rowsstatic-supplement-image-with-icon-rows.liquidFeature grid
Image + Bullet Liststatic-supplement-image-with-bullet-list.liquidBenefits with icons
Testimonialsstatic-supplement-testimonial-list.liquidProduct testimonials
Collapsible Contentstatic-supplement-collapsible-content.liquidAccordion for details
Blended Review Widget + JunipSame as default PDP

Baskets Template ​

Template: product.baskets.json. Sections: dynamic-baskets-hero → baskets (Vue render-baskets-options) → dynamic-whats-inside → static-supplement-image-with-icon-rows → static-supplement-collapsible-content → static-supplement-testimonial-list.

ReCharge Bundle Template ​

Template: product.recharge-bundle.json. It contains a single apps section with the ReCharge bundles widget.

Antelope Themes Documentation

Enter the password to access this site.