Skip to main content

Changelog

1.0.0

First release.

Collection page

  • Full-page filter sidebar, sticky, with a hide/show control
  • Collection hero with full-bleed or contained image, fluid heading, and Read more on long descriptions
  • Shop by category — a horizontal scroller driven by a navigation menu
  • Toolbar with live product count, active filter chips, clear all, sort and grid/list view
  • Mobile filter drawer as a bottom sheet, with focus trap, escape to close and a sticky result count
  • Dual-handle price slider
  • Load more over standard pagination, with back/forward support
  • Product cards with badges, swatches, ratings, hover image, Quick Add and a variant drawer
  • Benefit cards, SEO content, FAQ accordions and related collections below the grid
  • Per-collection content via custom.about, custom.faqs and custom.benefits metafields
  • Per-collection section opt-out via custom.hide_sections
  • [collection] token in headings
  • Review app support: Judge.me, Loox, Yotpo, Stamped, Okendo

Known setup pitfalls

  • The custom.faqs collection metafield must be created as List of entries. Shopify cannot convert a saved One-type definition to a list, so it has to be deleted and recreated.
  • FAQ item blocks should not have dynamic sources connected to their Question and Answer fields. The theme reads metafields directly.
  • Put the Heading or Question field first in a metaobject definition. Shopify labels every entry by its first field, so an Icon field at the top makes the picker unreadable.
  • Metaobject definitions describe a single item. One FAQ definition holds one question and one answer; one Benefit definition holds one card. Repeating the fields does not create more entries.
  • Section headings only render when there is content beneath them, so a collection with no metafield entries shows no empty section.

Cart

  • Gift wrapping: optional checkbox and message field on both the cart page and cart drawer, stored as cart attributes so it reaches the order and confirmation email
  • Pre-order: template-driven detection, an updated button label, a cart badge, and a line item property that carries the status through to checkout and the order
  • Fixed: line item properties (used by gift wrapping, pre-order, and gift card recipient fields) were being silently dropped on Add to cart specifically — Buy it now worked because it submits the form natively, Add to cart goes through the cart API and wasn't forwarding them. All three now work through either path.

Blog

  • New "All blogs combined" and "Grouped by blog" modes for stores running more than one blog, with per-page scope control so aggregating doesn't take over every individual blog's own listing

Collection filters

  • Fixed: several of the collection page's scripts and styles lived in snippet files, where Shopify silently discards {% javascript %} and {% stylesheet %} — so filtering, sorting, Quick Add, and swatches had never actually run. Moved into section-level and global assets where Shopify does process them.
  • Fixed: the price slider's recalculated bounds could get submitted as an active filter on the next action, silently narrowing results after any filter change. Price is now only sent when a shopper has genuinely touched it.
  • Fixed: an active price filter had no way to display or clear — it now shows as a chip like any other active filter.
  • Fixed: the sort dropdown's default value was being added to every filter URL, which could return a partial result set when clearing the last filter. Only an explicit choice is sent now.

Product & collection FAQs

  • Product-level FAQ schema, parsed from a Q: ... / A: ... formatted metafield rather than requiring structured fields
  • Fixed: collection FAQ answers sourced from a metaobject's rich text field were rendering as raw structured data in the schema output instead of the answer text

Images

  • Focal point support: product, collection, and article images now respect the focal point set in Shopify's image picker or Files, rather than always cropping to center
  • Fixed: images could flash their alt text visibly while loading, most noticeable on lazy-loaded images scrolling into view

Compliance

  • Added the missing app block to the featured product section (main product already had one)
  • Corrected three navigation settings that lacked the required default menu
  • Explicit alt text added where several images had none