Skip to content

Collection Pages ​

Collection page hero preview

Collection pages (PLP) use the custom isotope filter layout. Every product is loaded into one big grid and filtered client-side by collection tab and diet/ingredient tags. The grid is flanked by two decorative images and can include an optional featured Best Sellers card. Theme A and Theme B have the same PLP.

Collection templates ​

Assigned in Shopify Admin → Products → Collections → (collection) → Theme template.

TemplateDefault behaviour
collection.jsonCanonical layout — used by most collections.
collection.cats.jsonSame main-collection setup as collection.json — reserved for cat collections.
collection.variety-packs.jsonTwo main-collection instances. The active one uses standard mode (isotope off) with one tab. The second (isotope, full tab set) is disabled so the two setups can be swapped quickly.

All three templates render through main-collection.liquid — what differs is the per-template content (images, Best Sellers Block, filter list, tabs).

collection.json and collection.cats.json also stack section-hero-video.liquid under the grid as a prefooter band ("Nutrition that looks good, and tastes even better."):

TemplatePrefooter button
collection.jsonTake Our Quiz → /pages/recipe-recommendation
collection.cats.json"Shop Now" with an empty link, so no button renders (the Hero Video button needs both text and link)

Main Collection section ​

Section file: main-collection.liquidEditor name: Collection

The section that builds the PLP: collection tabs, description, diet filter pills, sort + count row, product grid, optional Best Sellers card.

Page structure (isotope mode) ​

Top to bottom:

  1. Header block (with a soft bottom shadow), rendered by snippets/layout-sort-bar-isotope.liquid:
    • Collection tabs, a full-width row (one button per block that has a URL), uppercase, centered, bottom border.
    • Collection description, centered in Quincy (28px desktop / 18px mobile). It swaps when a tab is clicked, using that tab's description, and is hidden when empty.
    • Diet filter pills (filters Vue component) from the Ingredients filter setting. On mobile they scroll horizontally edge to edge.
  2. Sort + count row (snippets/layout-sort-count-isotope.liquid): the sort dropdown on the left, "N Products" on the right, aligned with the grid.
  3. Skeleton placeholders (6 grey cards) while isotope initialises; the grid fades in afterwards.
  4. Product grid (3 columns desktop, 2 below 1024px), with the optional Best Sellers card.
  5. "No products" message when the filters match nothing.

The page title (h1 #collection-title) is in the markup, and clicking a tab updates its text, but it is hidden (hidden class) — the tab row and description do its job. theme.liquid also drops the usual top padding on collection pages.

Filter modes ​

The section has two filter modes controlled by the Isotope filter checkbox.

Isotope mode (default, on) ​

When isotope_filter is true:

  • Products are loaded from the all collection (up to 2000 items via pagination), whatever collection URL is open.
  • Filtering happens on the client. A tab filters by its filter_class, and pills add diet tags on top. Several pills can be active at once, and pills with no matching products for the current tab are hidden.
  • On page load, the tab whose URL matches the current path is activated.
  • Products with custom._hide_product_in_plp = true or the tag internal_only are hidden entirely.
  • "No products" is shown when the filters return nothing.

Standard mode ​

When isotope_filter is false:

  • Native Shopify pagination is used (up to 1000 per page) on the collection itself.
  • The standard sort bar (layout-sort-bar) is shown, and the description sits above the grid.
  • Only custom._hide_product_in_plp is respected — internal_only tags don't apply here.

Which mode is live?

collection.json and collection.cats.json use isotope mode. collection.variety-packs.json uses standard mode. Standard mode is for collections with too many products to render at once, or where SEO requires real pagination URLs.

Sorting ​

OptionValueSorts by
Sort By (initial)original-trueOrder the products came in
Price, low to high / high to lowprice-true / price-falsePrice in the card's price element
Alphabetically, A-Z / Z-Aname-true / name-falseTitle

On first load, the grid is sorted by stock, highest first (data-inventory = first variant's inventory) until the shopper picks an option. Choosing a sort hides the Best Sellers card.

The sort control is a native select (#sort-select in layout-sort-count-isotope.liquid); the sorting logic is in shopify/assets/script.static.js. Because the option list is drawn by the browser, an open list stays where it was drawn if the page scrolls underneath it (mostly noticeable on mobile).

Section settings: Filter & hero ​

SettingIDTypeDefaultWhat it does
Isotope filterisotope_filterCheckboxtrueSwitch between isotope (client-side) and standard (paginated) modes.
Image Leftimage_leftImage picker—Decorative image on the left of the grid (hidden below 1024px).
Image Rightimage_rightImage picker—Decorative image on the right of the grid (hidden below 1024px).
Ingredients filterisotope_gradientsTextareaComplete & Balanced, Low Fat, Low Carb, Low Phosphorus, Single Protein, Grain FreeComma-separated list of diet/ingredient filter pills. Each entry becomes a pill that matches a product tag (see the tip below).

How a pill matches products

Each pill label is turned into a tag slug: lowercased, symbols removed, spaces replaced by hyphens. "Complete & Balanced" → complete-balanced, "Low Phosphorus" → low-phosphorus. A product appears under the pill when it has exactly that tag. Product tags become CSS classes on the card, so the match is case-sensitive.

Section settings: Best Sellers Block ​

A standalone product card placed in the grid when enabled. Useful for highlighting a variety pack or trial bundle. It has its own quick-shop popup and Add button.

SettingIDTypeDefaultWhat it does
Enable Best Sellers Blockbs_block_enableCheckboxfalseMaster on/off. Currently off on all templates.
Productbs_block_productProduct—The product the card sells (currently sampler-pack).
Labelbs_block_labelTextWant a mix?Small eyebrow above the title.
Titlebs_block_titleTextBest Sellers Variety PackCard heading.
Descriptionbs_block_descriptionTextareaA variety of some of our favorite recipes…Body copy under the title.
Features labelbs_block_features_labelTextContains 4 of our Best Selling Recipes:Caption above the feature list.
Features (comma separated)bs_block_featuresTextBeef, Chicken, Turkey & Wild Salmon, Beef & ChickenRecipe names rendered as a bullet list.
Block image (right side)bs_block_imageImage picker—Photo on the card (falls back to the product image).

Blocks: Collection (tabs, max 8) ​

Each block is one tab in the header row.

SettingIDTypeDefault
HeadlineheadlineTextAdult Dogs
URLurlURL—
DescriptiondescriptionTextareaGently cooked, complete and balanced meals…
Class Filter for Product Collectionfilter_classTextadult-dog-collection

In isotope mode a block with a URL becomes a tab button that filters the grid by filter_class. Blocks without a URL are not shown. In standard mode the block's URL decides which tab is active.

Current tabs on collection.json / collection.cats.json:

TabURLfilter_class
Shop All/collections/shop-all*
Dogs/collections/adult-dogs.bleands-adult-dog-collection
Cats/collections/cats.bleands-cats-collection
Puppies/collections/puppies-moms.bleands-puppies-moms-collection
Specialty Diets/collections/specialty-diet-blends.speciality-diet-collection
Variety Packs/collections/variety-packs.variety-packs-collection

Class names must match

filter_class is a CSS selector that has to match a class on the product cards. Cards get one class per product tag, so .bleands-cats-collection matches products tagged bleands-cats-collection (spelling included). If no card has the class, the tab shows zero results.


Product card on PLP ​

Cards render through the layout-product snippet (v2 card layout, because version_plp is on). The same card is used on the search results page.

Top row

  • Product title and, under it, custom.ops_subname (when ops_subname is on) or the SKU.
  • Junip stars. Products with fewer than 3 reviews show five greyed-out stars that open the Junip review form. See Product Pages → Reviews.
  • Badge on the right:
ConditionBadge
custom.gran_free_banners is setNavy BEST SELLER pill
custom.feeding_formula = catCat icon + light-navy FOR CATS pill

Image

  • If custom.plp_image_static, custom.plp_image_hover and custom.plp_image_background are all set: layered background + static image, crossfading to the hover image.
  • Otherwise the featured image with the second image on hover, on the custom.background_color background.

Price row

CaseShows
custom._subscribe_and_save_price_for_plp set"starts at" + that price
No PLP price but custom.bars set (e.g. the fish blends, which have no small SKU)"starts at" + product.price (the Standard Subscription price)
OtherwiseProduct price (red with compare-at price when on sale)
Sold out, custom.show_find_in_store_cta not false"In-Store Only" + Find Store button → /pages/store-locator
Sold out, show_find_in_store_cta = false"Out Of Stock"

The Add button opens the quick-shop popup (below).

Ingredients — pills from the comma-separated custom.ingredients_plp.

Other rules:

  • Products with custom._hide_product_in_plp = true are never rendered.
  • Title rows and ingredient areas are equalised to the tallest card so rows line up. The heights are measured only while the whole grid is visible, so cards keep their size when a filter is applied.

Quick-shop popup ​

Component: product-popup (src/vue/components/ProductPopup/)

Clicking Add on a card opens a popup with the product accordion (description, ingredients, nutrition, feeding) and the full purchase form: pet-weight input, purchase options (resulttrialperiodv4 or resulttrialperiodv5 depending on custom.feeding_formula — see Product Pages → Purchase options), quantity and Add To Cart. On mobile the quantity + button row is fixed to the bottom of the screen.

  • The popup resets the shared product store each time it opens, so it never inherits the variant, plan or quantity of the previous card.
  • After Add To Cart ("Adding..." while it runs), the popup closes and the cart drawer opens with the new line already drawn (instant cart updates).

Section Collection (embed) ​

Section file: section-collection.liquid

Embeds a collection's products inside any page template — used on landing pages.

Collection Slider ​

Section file: section-collection-slider.liquid

Carousel/slider variant of a collection list — used for "Shop the collection" strips inside content pages.

List Collections ​

Section file: main-list-collections.liquidTemplate: templates/list-collections.json

The /collections index page that lists every collection as a card.


PLP global settings ​

These live in Theme Settings → PLP Settings and affect every collection page. See Theme Settings for the full reference.

SettingEffect
build_subscription_buttonPassed to cards and to the header search ("build" mode).
version_plpSwitches between PLP card layouts (v2 is on).
ops_subnameShows the operational/SKU subname on each card.

Page templates that embed collections ​

Several non-collection templates feature embedded product grids — handled by section-collection.liquid / section-collection-slider.liquid, not by main-collection:

TemplatePurpose
page.subscribe-now.jsonSubscription landing page with featured products
page.landing-page.jsonMarketing landing page with product showcase
page.landing-page-conversion.jsonConversion-optimized landing
page.landing-page-trial-bars.jsonTrial bar products landing page
page.landing-page-sales.jsonSale / promotion landing
page.landing-page-promo.jsonGeneral promotion page

Common content manager tasks ​

Add or rename an ingredient filter pill ​

Main Collection → Ingredients filter. Edit the comma-separated list — order is the display order. Then tag every product that should match with the pill's slug (e.g. pill "Grain Free" → tag grain-free, all lowercase). See How a pill matches products.

Add a new tab above the grid ​

Main Collection → Add block → Collection link. Set a URL (tabs without a URL are hidden), a headline, an optional description, and the filter_class selector that matches a product tag.

Show the Best Sellers Block on collection.json ​

Main Collection → Best Sellers Block → Enable Best Sellers Block. Pick the variety-pack product, set the copy, and upload a product photo.

Mark a product as a cat food on the PLP ​

Set custom.feeding_formula to cat. The card shows the FOR CATS badge and the quick-shop popup uses the cat feeding calculator.

Hide a product from all collections ​

Set its custom._hide_product_in_plp metafield to true. The product keeps its live URL but doesn't appear in any PLP or search results.

Switch a collection to native pagination (for SEO) ​

Main Collection → Isotope filter → uncheck. The page then uses native Shopify pagination — useful for large collections where the 2000-item isotope load would be slow.

Antelope Themes Documentation

Enter the password to access this site.