> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection Page (PLP)

> Configure your collection page product grid with flexible layouts, filtering, and sorting options

The Product grid template (main-collection-product-grid) controls how products display on collection pages. It provides customization for grid layout, filtering options, and sorting controls to help customers browse and find products efficiently.

<Frame>
  <img src="https://mintcdn.com/digifist/4YbeBo-eaBhTI1Dy/images/theme/mojave/sections/main-collection-product-grid-overview.png?fit=max&auto=format&n=4YbeBo-eaBhTI1Dy&q=85&s=1bb440453e3e2748937bf54b6509d69e" alt="Collection page product grid overview" width="3280" height="2186" data-path="images/theme/mojave/sections/main-collection-product-grid-overview.png" />
</Frame>

## What this section controls

* Products per row on mobile and desktop
* Products per page before pagination
* Product filtering controls
* Sorting dropdown options
* Filter layout (horizontal bar vs. sidebar)
* Filter button styling

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    In your Shopify admin, go to **Online Store > Themes** and click **Customize** on your active theme.
  </Step>

  <Step title="Navigate to a collection page">
    Use the page selector dropdown at the top center to select **Collections** and choose any collection to preview.
  </Step>

  <Step title="Locate the template">
    The "Product grid" section controls the main collection template. Additional sections (like collection banner) can be added above it.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/digifist/4YbeBo-eaBhTI1Dy/images/theme/mojave/sections/main-collection-product-grid-location.png?fit=max&auto=format&n=4YbeBo-eaBhTI1Dy&q=85&s=715cbd42f539c5dd234b3c789523c276" alt="Product grid section location" width="3280" height="2186" data-path="images/theme/mojave/sections/main-collection-product-grid-location.png" />
</Frame>

## Filter layout options

Choose how filtering controls display on desktop:

<AccordionGroup>
  <Accordion title="Horizontal filter bar (Default)">
    Filters appear in a horizontal bar above the product grid, with full-width products below.

    **Characteristics**:

    * Compact filtering interface
    * Maximizes product grid width
    * Filter style setting (square/round) applies to buttons
    * Modern, streamlined appearance

    **Best for**: Stores with fewer filter options, clean minimal designs, or when product visibility is priority.
  </Accordion>

  <Accordion title="Sidebar">
    Filters display in a left sidebar with products to the right.

    **Characteristics**:

    * Traditional e-commerce layout
    * Dedicated space for extensive filters
    * Filter style setting doesn't apply (sidebar has fixed styling)
    * Always visible filtering options

    **Best for**: Stores with many filter options, detailed categorization needs, or customers who expect traditional layouts.
  </Accordion>
</AccordionGroup>

**Note**: On mobile devices, filters always use a vertical layout regardless of desktop setting.

## Template settings

<Tabs>
  <Tab title="Grid Layout">
    <AccordionGroup>
      <Accordion title="Products per row - Mobile">
        Control how many products display side-by-side on mobile devices:

        * **1 product**: Single column, vertical scrolling - Emphasizes each product with large images
        * **2 products** (default): Two columns - Balances product size with browsing efficiency

        **Recommendation**: Keep default 2-column layout for most stores. Use 1-column only for products requiring detailed image viewing (art, complex items).
      </Accordion>

      <Accordion title="Products per row - Desktop">
        Control desktop grid columns:

        * **2 products**: Large product cards, maximum image size
        * **3 products**: Balanced layout with good visibility
        * **4 products** (default): Standard e-commerce grid, efficient browsing

        **Selection guidance**:

        * **2 columns**: Image-focused stores (art, photography, luxury goods)
        * **3 columns**: Balanced approach for most product types
        * **4 columns**: Efficient browsing, standard for apparel/accessories
        * Consider 5-column option if you have many SKUs (requires custom CSS)
      </Accordion>

      <Accordion title="Products per page">
        Set how many products display before pagination loads more (2-50 products, default: 12).

        **Sizing recommendations**:

        * **8-16 products**: Standard range, balances page load with browsing
        * **24-36 products**: Power users, reduces pagination clicks
        * **50 products**: Maximum, may slow page load on slower connections

        **Tips**:

        * Keep default 12 for most stores
        * Increase for collections with extensive filtering (reduces filter re-application)
        * Consider page load speed - more products = slower initial load
        * Popular numbers: 12, 16, 20, 24 (divisible by common column counts)
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Filtering & Sorting">
    <AccordionGroup>
      <Accordion title="Enable filtering">
        Show/hide product filtering controls. Enabled by default.

        **When enabled**: Customers can filter by availability, price, product type, vendor, tags, and custom metafields configured in the Search & Discovery app.

        **When to disable**:

        * Small collections where filtering isn't needed
        * Curated collections where you want to control product order
        * Landing pages with specific product selections

        **Configure filters**: Manage filter options in **Shopify Admin → Search & Discovery app → Filters**. You can customize which filters appear, their order, and filter types (checkboxes, price range, etc.).
      </Accordion>

      <Accordion title="Enable sorting">
        Show/hide the sorting dropdown. Enabled by default.

        **Available sort options** (standard Shopify):

        * Featured (manual collection order)
        * Best Selling
        * Alphabetical: A-Z
        * Alphabetical: Z-A
        * Price: Low to High
        * Price: High to Low
        * Date: Newest to Oldest
        * Date: Oldest to Newest

        **When to disable**:

        * You want complete control over product order (featured only)
        * Small curated collections where sorting doesn't add value
        * Product order is part of your storytelling/merchandising
      </Accordion>

      <Accordion title="Show in sidebar on desktop">
        Control filter layout on desktop devices. Disabled by default (uses horizontal bar).

        **Disabled (horizontal bar)**:

        * Filters in compact horizontal bar above products
        * Full-width product grid
        * Modern, clean appearance
        * Filter style (square/round) setting applies

        **Enabled (sidebar)**:

        * Filters in dedicated left sidebar
        * Product grid uses remaining width
        * Traditional e-commerce layout
        * More space for extensive filter options
        * Filter style setting doesn't apply

        Choose based on number of filters and store aesthetic preferences.
      </Accordion>

      <Accordion title="Filters style">
        Choose visual style for filter buttons when horizontal bar is active. Doesn't apply to sidebar layout.

        * **Square** (default): Clean, modern rectangular buttons
        * **Round**: Softer, rounded button edges

        **Effect**: Only visible when "Show in sidebar on desktop" is disabled (horizontal bar mode).

        Match filter style to your overall design system - square for modern/minimalist themes, round for softer/friendly aesthetics.
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Configuring filters

Product filters are managed through Shopify's **Search & Discovery** app, not in the Theme Customizer.

<Steps>
  <Step title="Open Search & Discovery">
    In Shopify admin, go to **Apps → Search & Discovery** (or install if not present).
  </Step>

  <Step title="Navigate to Filters">
    Click on **Filters** in the left sidebar.
  </Step>

  <Step title="Customize filter options">
    * Add/remove filter options (price, availability, product type, vendor, tags, metafields)
    * Reorder filters by dragging
    * Configure filter types (checkbox, swatch, price range)
    * Set filter labels and display names
  </Step>

  <Step title="Save and test">
    Save changes and test on your storefront collection pages.
  </Step>
</Steps>

Available filter types:

* **Availability**: In stock / Out of stock
* **Price**: Range slider or preset ranges
* **Product type**: Automatically from product types
* **Vendor**: Filter by brand/manufacturer
* **Tags**: Product tags as filters
* **Metafields**: Custom product properties (color swatches, materials, etc.)

## Best practices

<CardGroup cols={2}>
  <Card title="Balance grid density" icon="grid">
    Use 4 columns on desktop for standard browsing efficiency. Consider 3 columns for products requiring larger images (jewelry, art) or 2 columns for luxury/high-detail items.
  </Card>

  <Card title="Optimize products per page" icon="hashtag">
    Keep at 12-24 products for best performance. Higher values reduce clicks but slow page load. Test with your target audience's connection speed.
  </Card>

  <Card title="Enable both filtering and sorting" icon="filter">
    Most customers expect both options. Only disable when you have strong merchandising reasons to control the exact product order.
  </Card>

  <Card title="Choose filter layout strategically" icon="sidebar">
    Use horizontal bar for smaller stores (5-10 filter options). Use sidebar for extensive filtering needs (15+ options) or traditional customer expectations.
  </Card>

  <Card title="Configure filters thoughtfully" icon="sliders">
    In Search & Discovery, enable only relevant filters. Too many filters overwhelm customers. Focus on filters that genuinely help narrow choices (size, color, price).
  </Card>

  <Card title="Mobile-first grid" icon="mobile">
    Test 2-column mobile layout across devices. Single column rarely adds value unless products require extremely detailed views.
  </Card>

  <Card title="Consider pagination numbers" icon="calculator">
    Use numbers divisible by your column count (12 for 3-4 columns, 16 for 4 columns, 18 for 3 columns) for balanced final rows.
  </Card>

  <Card title="Match filter style to theme" icon="palette">
    Square filters suit modern/minimalist themes, round filters suit friendly/approachable brands. Maintain consistency with button styles elsewhere.
  </Card>

  <Card title="Featured sort for merchandising" icon="star">
    Use "Featured" sort (manual collection order) to highlight seasonal items, bestsellers, or high-margin products at the top of collections.
  </Card>

  <Card title="Monitor filter usage" icon="chart-line">
    Track which filters customers use most (via analytics). Remove unused filters to reduce interface complexity and improve experience.
  </Card>
</CardGroup>
