Skip to content

Product Pages ​

Product page hero section

Product detail pages (PDPs) are powered by sections/main-product.liquid with three rendering variants. The variant is selected per-template through section settings checkboxes.

Main section file: sections/main-product.liquid

Shared PDP features:

  • Flavor / type selector on PDP V2 and PDP Buttons, driven by product metafields. See Flavor / Type Selector.
  • Blended review summary (site + Amazon + Chewy) under the title, falling back to the Junip summary. See Integrations → Blended Reviews.
  • Secondary name line under the title from custom.alternate_name. See Secondary Name.
  • Add to Cart is optimistic: the cart updates instantly and the "Item added" popup opens. See Cart & Checkout.

PDP Variants ​

Section Settings (main-product) ​

Setting IDTypeLabelDefault
version_pdpcheckboxPDP V2 versionfalse
version_pdp_buttonscheckboxPDP Buttonsfalse
titletextHeading"WHAT'S INSIDE?"
cost_per_daycheckboxEnable Price/Dayfalse

Rendering Logic ​

liquid
{% if pdpv2 %}
  {% render 'product-pdp-v2' %}
{% elsif section.settings.version_pdp_buttons %}
  {% render 'product-pdp-buttons' %}
{% else %}
  {# Default PDP #}
{% endif %}

Template-to-Variant Mapping ​

TemplatePDP VariantCost/DayUsage
product.jsonDefaultNoBasic products, minimal layout
product.pdpv2.jsonPDP V2NoCBD products with full features
product.pdpv2-nonhemp.jsonPDP V2NoNon-hemp products
product.pdp-buttons.jsonPDP ButtonsYesProducts with price-per-day calculator
product.pdpv3-price-day.jsonPDP V2 (version_pdp: true)YesPrice-per-day focused layout

Default PDP ​

The default PDP renders directly in main-product.liquid without delegating to a snippet. It features:

  1. Image Gallery: Vue <renderless-product-gallery> component with click-to-zoom. For single-variant products, shows up to 2 additional thumbnail images.
  2. Product Title: Styled in font-bionM at 45px, followed by the optional secondary name.
  3. Review Summary: {% render 'blended-reviews', product: product, mode: 'compact' %} -- blended rating and count (e.g. 4.5 ★★★★★ (3,600)), falling back to snippets/junip-product-summary.liquid when the product has no blended metafields.
  4. Price Display: Current price with optional compare-at price, sale badge, and wholesale price class (wsgProdPrice).
  5. Sold Out State: The .product-available / .sold-out classes toggle visibility of the form vs. sold-out message.
  6. Product Form: Standard {% form 'product' %} with snippets/product-form.liquid.
  7. Description: Scrollable container (max-height 306px) with product description HTML.

PDP V2 ​

Snippet file: snippets/product-pdp-v2.liquid

The enhanced PDP used for most CBD and supplement products.

Features ​

  1. Image Gallery: Vue <pdp-gallery> component with images serialized via helper-pdp-gallery snippet. Eager-loaded featured image with LCP placeholder.
  2. Title, secondary name and review summary: product title, the optional secondary name, and the blended review summary (blended-reviews, compact mode).
  3. Flavor / Type Selector: {% render 'product-flavor-selector', product: product %} -- round icon buttons linking sibling products. See Flavor / Type Selector.
  4. Variant Selector: Vue <product-variants> component renders variant buttons/options. Receives:
    • current -- Currently selected variant ID
    • variants -- Serialized variant data from helper-pdp-variants
    • default -- Default variant from product.metafields.custom.default_variant_loading_on_pdp
  5. Product Form: With pdpv2: true flag, which changes the add-to-cart button styling to purple (!bg-pastelPinkL !text-white).
  6. Sold Out State: Shows "In-Store Only" badge.
  7. Accordion Tabs: Three collapsible sections via Vue <Accordion> component:
    • Description: Product description HTML
    • Ingredients: From product.metafields.custom.nutrition_ingredients
    • Recommended Use: From product.metafields.custom.recommended_use
  8. COA Testing Link: If product.metafields.custom.coa_testing_url exists, displays a link to the Certificate of Analysis.

Product Metafields Used ​

MetafieldPurpose
custom.default_variant_loading_on_pdpDefault variant to display on page load
custom.nutrition_ingredientsIngredients content for accordion
custom.recommended_useRecommended use content for accordion
custom.coa_testing_urlLink to Certificate of Analysis
custom.disable_subscriptionHides subscription widget
custom.calming_badgeBadge text on product cards
custom.show_ingredients_sectionControls ingredients section visibility
custom.ingredient_orderCustom ingredient display order
custom.barsBars per pack (for calculator)
custom.pounds_per_bar_dailyPounds per bar daily (for calculator)
custom.type_frequencySubscription frequency type
custom.enter_weightWeight entry title text
custom.alternate_nameSecondary name shown under the title (PDP + cards)
custom.selector_skusList of sibling products for the flavor/type selector
custom.selector_type"Heading: Label", e.g. "Flavor: Chicken"
custom.selector_iconIcon shown on this product's selector button
custom.selector_colorBackground color of the selected button
reviews.blended_rating, reviews.blended_count, ...Blended review data, see Integrations

Flavor / Type Selector ​

Snippet: snippets/product-flavor-selector.liquidComponent: src/vue/components/FlavorSelector/index.vue

Links separate Shopify products that are "the same product in another flavor/type" (e.g. chews in chicken vs. peanut butter). It renders only when the product has custom.selector_skus.

MetafieldUsed for
custom.selector_skus (product list)The products shown as options, in order. Include the current product too.
custom.selector_typeText before the colon is the heading (taken from the current product), text after the colon is each option's label (taken from each referenced product). Example: Flavor: Chicken → heading "Flavor", label "Chicken".
custom.selector_iconIcon on each option (rendered at 48px on the PDP)
custom.selector_colorBackground of the active option (its icon turns white)

Behavior:

  • PDP (mode="icon", navigate: true) -- 70px round icon buttons with the heading and the current label ("FLAVOR: Chicken"). Clicking another option fetches /products/HANDLE?section_id=..., swaps the product section HTML in place, re-mounts the Vue islands and updates the URL with history.pushState (falls back to a normal page load on error).
  • Quick Add popup (mode="text") -- full-width text buttons; see Collection Pages → Quick Add popup.
  • Needs at least 2 options to render.

Rendered in snippets/product-pdp-v2.liquid and snippets/product-pdp-buttons.liquid (not on the default PDP).

Secondary Name (Alternate Name) ​

Snippet: snippets/product-alternate-name.liquid

A second title line showing the product's former name, from the custom.alternate_name product metafield. Renders nothing when empty.

  • PDP (default, V2, Buttons): under the H1, text-[41px] (26px on mobile), font-bionR.
  • Product cards (PLP, carousels, search, snippets/layout-product.liquid, snippets/layout-plp-default.liquid, Vue cards via alternateName in helper-featured / helper-best-sellers): under the title; the flex-auto spacing sits on the secondary line instead of the title, so card heights stay aligned.

PDP Buttons ​

Snippet file: snippets/product-pdp-buttons.liquid

Nearly identical to PDP V2 (including the flavor/type selector, secondary name and blended review summary) but with two differences:

  1. Cost Per Day Calculator: Passes pdpbuttons: true to the product form, enabling the price-per-day calculation feature.
  2. Find Store / OSS Buttons: Instead of "In-Store Only" text, renders <find-store-oss-btns /> Vue component for the sold-out state, providing store locator and alternative purchase options.

Product Form ​

Snippet file: snippets/product-form.liquid

The shared product form component used across all PDP variants.

Parameters ​

ParameterPurpose
idCurrent variant ID
productProduct object
pdpv2Boolean for V2 styling
pdpbuttonsBoolean for buttons variant
calculatorBoolean for cost-per-day

Components ​

  1. Results Component (<results>): Handles subscription options and price-per-day calculator. Receives product price, bars/pack, pounds/bar, shipping cost, frequency type, subscribe text (settings.subscribe_text), and product configuration.
  2. Quantity Selector (<product-quantity>): Increment/decrement buttons with a text input.
  3. Add to Cart (<add-to-cart>): Receives :product-data (from snippets/helper-product-config.liquid) so it can build an optimistic cart line (title, variant, image, price) and show it in the cart immediately while /cart/add.js runs. V2 variant uses full-width purple button.

The PDP renders no Shopify dynamic / accelerated checkout buttons (Shop Pay, Apple Pay, ...). Keep it that way -- see Cart & Checkout → Checkout Savings.

Subscription Integration ​

The <results> container is hidden (via .disable-subscription .results-container { display: none }) when the product has disable_subscription set to true. Additionally, the .disable-rc class is applied when cost_per_day is enabled.

PDP Template Sections ​

PDP V2 Template (product.pdpv2.json) ​

OrderSectionPurpose
1main-product (V2)Core product display
2section-whyBrand value props (Broad Spectrum, Non-Detectable THC, Grain Free, Water-Soluble)
3section-ingredientsIngredient slider driven by product tags
4Junip app blockFull review widget (sortOrder: mostRecent)
--section-collection-title-text"You May Also Like" (bestsellers) -- disabled
5section-products"You May Also Like" carousel (calming-anxiousness collection)

PDP V2 Non-Hemp Template (product.pdpv2-nonhemp.json) ​

Same section order as PDP V2 but with the section-why block disabled. This removes the hemp-specific value props (Broad Spectrum, Non-Detectable THC, Water-Soluble Hemp) that are irrelevant for non-hemp products. The ingredients section and Junip reviews remain active.

PDP V3 Price/Day Template (product.pdpv3-price-day.json) ​

Same section order as PDP V2 but with cost_per_day: true enabled. This activates the price-per-day calculator in the product form, allowing customers to see the daily cost based on their pet's weight.

PDP Buttons Template (product.pdp-buttons.json) ​

Same section order as PDP V2 but with cost_per_day: true and version_pdp_buttons: true, plus the Blended Review Widget section (section-blended-review-widget) placed between section-ingredients and the Junip app block. It rewrites Junip's review summary with the blended totals ("N Reviews across all platforms") -- see Integrations → Blended Review Widget section.

Default Template (product.json) ​

OrderSectionPurpose
1main-product (Default)Basic product display
2Junip app blockFull review widget
3section-collection-title-text"You May Also Like" (bestsellers)

sections/section-ai-block.liquid ("AI Product Insight -- See what AI knows about this product") exists in the theme but is not placed on any product template; it can be added in the theme editor.

Antelope Themes Documentation

Enter the password to access this site.