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 ProductsCollections.
  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 AdminProductsCollections → open a collection → Theme template dropdown.

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