Skip to content

Collection Pages ​

Bocce's Bakery Collection Page Hero

Overview ​

Every main shopping collection (Shop All, Shop Dog, New, Cat, and the category pages) uses one JSON template per collection. Each of those templates renders the same static-collection-filters section: the "Collection Category Page" in the customizer.

The PLP has:

  • a metafield-driven headline + subcopy;
  • sort + product count;
  • device-specific filter groups;
  • a collapsible Filters panel on mobile;
  • mobile-specific sub-collection thumbnails;
  • a 4-per-row grid by default.

Page structure ​

Files: sections/static-collection-filters.liquid (schema) → snippets/collection-category-filters.liquid (markup) → snippets/product-item.liquid (cards)

Top to bottom, when the collection is on its default sort:

  1. PLP headline (snippets/plp-headline.liquid): an h1 in Value Serif plus a subcopy block, from the collection metafields custom.headline_copy and custom.subcopy. Nothing renders when both are blank.
  2. Sub-collection navigation: one thumbnail + label per Featured Sub-Collection block, linking to anchors further down the page. It scrolls horizontally on mobile.
  3. Sidebar: Sort By (title and created-date sorts are hidden) + a "N Products" count + the tag filters.
  4. Sub-collection listings: each Featured Sub-Collection block renders a hero banner (image on desktop, banner_color background on mobile) with title and description, then all products of that collection.

When the shopper picks a non-default sort, the page switches to a single flat grid of the parent collection, limited to rows × products_per_row products.

  • /collections (the list-collections template) redirects to /collections/shop-all. It outputs a meta refresh plus window.location.replace, and is marked noindex, follow.
  • The "Collections" breadcrumb on collection pages and PDPs links to /collections/shop-all (plain text on Shop All itself). The JSON-LD breadcrumb (snippets/structured-data.liquid) matches.

Section settings ​

SettingIDTypeDefaultShop All (current)
Show breadcrumbsshow-breadcrumbscheckboxtruetrue
Show top titleshow-top-titlecheckboxfalsefalse
Show collection imageshow-collection-imagecheckbox—false
Rowsrowsrange 1–1166
Number of products per rowproducts_per_rowrange 2–444
Enable sortingenable-sortingcheckboxfalsetrue
Enable sidebarcollection-sidebarcheckboxfalsetrue
Collection sidebar menucollection-sidebar-menulink_list—collections
SettingIDTypeNotes
CollectioncollectioncollectionProducts listed in this group; its handle is the anchor
Header Navigation Thumbnailheader_imageimageNav thumbnail (desktop)
Header Navigation Thumbnail: Mobileheader_image_mobileimageOptional, falls back to the desktop thumbnail
Hero BannerbannerimageDesktop only
Mobile Banner Colorbanner_colorcolorDefault #FDECE2
Featured Subcollection TitletitletextOverrides the collection title
Featured Subcollection Descriptiondescriptionrichtext
Description: Mobile Onlydescription_mobilerichtext
Navigation Titlenav_titletextShort label under the thumbnail

The legacy static-collection-category-1 … -20 sections have the same header_image_mobile setting.

Blocks: filters ​

BlockSettingIDNotes
Filter group title (filter_parent)TitletextGroup heading, e.g. "Texture"
Show ondeviceboth / desktop / mobile
Filter within group (filter_childs_group)Filter group titleparentMust match a filter_parent title exactly
Tag text to show instead of tagtag_labelCheckbox label
Tag Nametag_nameProduct tag to match

How filtering works (src/vue/components/render/filter-options.vue): filtering happens client-side on the products already rendered, using each card's data-product-tags.

  • Within a group, tags are OR. Across groups they are AND.
  • A tag is only listed if at least one product on the page has it. Each group shows the first 10 tags, then View More.
  • Sub-collection heroes with no visible products are hidden. "No products found. Please remove some filters" appears when nothing matches.
  • Mobile (below 720px): filters collapse behind a Filters toggle. device decides which groups appear on each breakpoint, and the component rebuilds the groups when the viewport crosses the breakpoint.

Current filter setup (Shop All / Shop Dog / New)

The same six groups and 26 tags are used on the main templates:

  • Texture: texture-crunchy, texture-softchewy, texture-training, texture-jerky, texture-supplement
  • Ingredient: ingredients-banana, -cheese, -peanut-butter, -bacon, -beef, -chicken, -duck, -salmon
  • Lifestage: lifestage-puppy, lifestage-senior
  • Function: function-calming, -dental, -digestion, -hipjoint, -skincoat, -immunesupport
  • Diet: low-calorie, Vegetarian, low-fat
  • Pet Type: pet-dog, pet-cat

To add a filter, tag the products, then add a Filter within group block with the exact tag.

Collection templates ​

TemplateSub-collections (nav labels)
collection.shop-all.jsonSoft & Chewy, Jerkies, Training Treats, Freeze Dried, Halloween, Biscuits, Food Toppers, Wellness & Dental, Supplements
collection.shop-dog.jsonSoft & Chewy, Biscuits, Freeze Dried, Food Toppers, Training Treats, Jerkies, Wellness & Dental, Supplements
collection.new.jsonSprinkled Froyo, NFLPA, Protein Jerky, Bocce's Spa, Wellness, Freeze Dried, Training, Post Workout Smoothie, Valentine's Recipes, Soft & Chewy
collection.cat.json, biscuits, soft-chewy, jerky, training-treats, wellness, special-edition, halloween-treats, dynamic-filtersCategory pages on the same section
collection.collection-page-no-banner.jsonSame section, currently disabled

Legacy .liquid templates (not editable as JSON):

TemplateSection
collection.liquid (default)dynamic-image-with-text + static-collection
collection.category-1 … category-20static-collection-category-1 … -20
collection.cats.liquidstatic-collection-cats
collection.filters.liquidstatic-collection-filters
collection.subcollection-list.liquidstatic-subcollection

static-collection, static-collection-basic and static-collection-cats also render the PLP headline (plp-headline-wrapper).

To assign: Shopify Admin > Products > Collections > [Collection] > Theme template.

Product card ​

Snippet: snippets/product-item.liquid. It is shared by the PLP, sub-collection lists, dynamic-collection, the NFLPA PLP grid and B's search grid.

ElementSource / logic
Brand lineproduct.pet_flag metafield, else vendor (show-brand-names)
TitleProduct title
One-linerProduct metafield custom.one_liner, up to 2 lines. See Product one-liner
Rating"4.8 ★★★★★ (1.2k)", with counts of 1,000 and up abbreviated. It comes from the metafields junip.rating_average / junip.rating_count, not a live API call. If the product has Amazon or Chewy reviews (reviews.amazon_reviews / reviews.chewy_reviews > 0), the blended reviews.blended_rating / reviews.blended_count are used instead
Write a reviewWhen the count is 0, the rating slot shows a Write a review link that opens the Junip on-site review form in a new tab
Price & saleSee below
Add to cartStatic ATC button with instant add to the drawer. Out-of-stock products show FIND STORE (find-store setting); custom.find_in_store_option = "Buy Online" shows SHOP ONLINE (link from custom.not_in_store); custom.oss = true forces OUT OF STOCK. Bundles (bundles.items_in_bundle) count as out of stock when any item has fewer than 5 in inventory
HiddenProducts tagged internal_only are never rendered

The rating widget is hydrated by window.__theme.junip.junipRating() (snippets/helper-theme-global-js.liquid). layout/theme.liquid re-runs it every 2 s so cards injected by AJAX also get stars. A MutationObserver keeps the Junip SDK from wiping them.

Sale pricing & "See Discounted Price in Bag" ​

  • "On sale" means the product is in the sale collection (snippets/on-sale-check.liquid). Compare-at price alone doesn't count.
  • On-sale products get the sale price style. The compare-at price shows struck through only when it is higher than the price.
  • On-sale products also show "See Discounted Price in Bag" (snippets/discount-note.liquid, locale key products.product.discounted_price_in_bag). The SALE30 automatic discount only applies in the cart, so the storefront price is the full price. It appears on product cards, search results and the PDP.

Theme B difference

Theme B also strikes through the compare-at price on any product whose compare-at is above its price, whether or not it is in sale. This covers the PLP, the search page and the live search. Theme A uses the sale-collection rule only.

Other collection sections ​

SectionFileNotes
Collection Basicstatic-collection-basic.liquidSimplified layout with the PLP headline
Subcollectionstatic-subcollection.liquidNested subcollection display
Collection Liststatic-collection-list.liquid / dynamic-collection-list.liquid/collections itself redirects to Shop All
Tradeshowstatic-tradeshow-2-collection.liquid, static-tradeshow-2-collection-list.liquidTradeshow page

Antelope Themes Documentation

Enter the password to access this site.