Skip to main content

Collection Page

The TabletopForge collection page (main-collection.liquid) provides a full-featured product browsing experience with filtering, sorting, and a grid layout optimized for miniature and gaming product photography.


Collection Layout Overview​

The collection page is divided into two primary areas:

AreaDescription
Collection BannerFull-width header showing the collection title and description
Product GridResponsive grid of product cards

Collection Banner​

The Collection Banner section (collection-banner.liquid) renders at the top of every collection page. It displays:

  • Collection title
  • Collection description
  • Optional background image (set via the collection's featured image in Shopify Admin)

To set a collection banner image:

  1. In Shopify Admin, go to Products → Collections.
  2. Open the target collection and upload a Collection image in the Collection image field.
  3. The image will appear as the banner background on the collection page.

Product Grid Configuration​

The product grid is controlled by the Main Collection section settings. Configure it in the theme editor by clicking Main Collection in the sidebar.

SettingDescriptionDefault
Products per pageNumber of products shown per paginated page12
Grid columns (desktop)Number of columns in the product grid on large screens4
Grid columns (mobile)Number of columns on mobile2
Show product vendorDisplay the brand/vendor name on product cardsfalse

Sorting & Filtering​

The collection page includes a native Sort dropdown in the collection toolbar. Available sort options:

  • Featured
  • Best Selling
  • A–Z / Z–A
  • Price: Low to High / High to Low
  • Date: Newest / Oldest

Filtering by tags or price ranges requires the Shopify Search & Discovery app (free from the Shopify App Store), which provides native faceted filtering support.


Product Status Badges​

TabletopForge product cards display availability badges automatically:

BadgeCondition
In StockProduct is available for purchase
LimitedProduct has the tag Limited or limited
Sold OutProduct is unavailable

Badges are rendered on the card thumbnail overlay and require no manual configuration.


Collection Page Template Variants​

You can create additional collection templates for different visual layouts:

  1. In the theme editor, click ⋯ next to the collection template name.
  2. Select Create template.
  3. Name the template (e.g., collection.stl-files).
  4. Assign it to a specific collection by going to Shopify Admin → Products → Collections → open a collection → Theme template dropdown.

This allows you to have separate layouts for physical products, STL files, or paint/tools collections.