> ## 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)

> Customize the layout and features of your collection pages.

Collection pages (PLP) display a group of products, allowing customers to browse and shop from a curated selection. You can customize the layout, filters, sorting options, and optional promotional text cards to enhance the shopping experience.

<img src="https://mintcdn.com/digifist/Tj70cY9UOMYie8gF/images/theme/release/collections/collection-page.png?fit=max&auto=format&n=Tj70cY9UOMYie8gF&q=85&s=3ffa59421b061aa068b0f41c6596851d" alt="Collection page overview" width="3280" height="2186" data-path="images/theme/release/collections/collection-page.png" />

## What this section controls

This section manages:

* **Product grid layout** - Set products per row for desktop and mobile
* **Filtering system** - Control how customers filter products (drawer, sidebar, or hidden)
* **Sorting capabilities** - Enable/disable sorting dropdown options
* **Pagination style** - Choose between traditional pagination, load more button, or infinite scroll
* **Promotional text cards** - Insert branded content within the product grid
* **Section spacing and colors** - Adjust layout width, color scheme, and spacing

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer
  </Step>

  <Step title="Navigate to Collections">
    In the left sidebar, click **Collections** then select **Default collection**
  </Step>

  <Step title="Configure utilities bar">
    Adjust filter display, sorting, and product count settings in the **Utilities Bar** tab
  </Step>

  <Step title="Customize product grid">
    Set products per row, pagination style, and spacing in the **Product Grid** tab
  </Step>

  <Step title="Add text cards (optional)">
    Click **Add block** > **Text card** to insert promotional cards within the product grid
  </Step>
</Steps>

## Section Settings

<Tabs>
  <Tab title="Utilities Bar">
    The utilities bar appears above the product grid, containing filters, sorting, and product count.

    <img src="https://mintcdn.com/digifist/Tj70cY9UOMYie8gF/images/theme/release/collections/utilities-bar.png?fit=max&auto=format&n=Tj70cY9UOMYie8gF&q=85&s=b521f6e0f70c4bbe5359ba8b4404412a" alt="Utilities bar settings" width="3280" height="2186" data-path="images/theme/release/collections/utilities-bar.png" />

    <AccordionGroup>
      <Accordion title="Show top border for utilities bar">
        **Type:** Toggle\
        **Default:** Disabled

        Adds a decorative border above the utilities bar to visually separate it from the content above.

        <Note>This border uses the theme's border color from your color scheme settings.</Note>
      </Accordion>

      <Accordion title="Enable products count">
        **Type:** Toggle\
        **Default:** Enabled

        Displays the total number of products in the collection (e.g., "24 products").

        <Tip>Product count helps customers understand collection size and is especially useful for large collections.</Tip>
      </Accordion>

      <Accordion title="Enable sorting">
        **Type:** Toggle\
        **Default:** Enabled

        Shows the sorting dropdown allowing customers to sort products by:

        * Featured
        * Best selling
        * Alphabetically (A-Z)
        * Alphabetically (Z-A)
        * Price (low to high)
        * Price (high to low)
        * Date (old to new)
        * Date (new to old)
      </Accordion>

      <Accordion title="Filters">
        **Type:** Dropdown\
        **Options:** Hide, Drawer, Sidebar\
        **Default:** Drawer

        Choose how filters are displayed to customers:

        * **Hide** - Removes all product filters
        * **Drawer** - Filters slide in from the side when the "Filter" button is clicked
        * **Sidebar** - Filters are always visible in a left sidebar

                  <img src="https://mintcdn.com/digifist/Tj70cY9UOMYie8gF/images/theme/release/collections/filter-styles.png?fit=max&auto=format&n=Tj70cY9UOMYie8gF&q=85&s=bbf7e7272f2569b4d63f4015ceaecac7" alt="Filter display styles" width="3280" height="2186" data-path="images/theme/release/collections/filter-styles.png" />

        <Tip>Use drawer for cleaner layouts with fewer filters, or sidebar for collections with extensive filtering needs.</Tip>
      </Accordion>

      <Accordion title="Open filter accordions by default">
        **Type:** Toggle\
        **Default:** Enabled

        Sets all filter accordions to open when the page loads, making all filter options immediately visible.

        <Note>This setting only affects desktop sidebar and drawer views. Mobile filters always start collapsed.</Note>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Filters">
    Advanced filtering options for collection pages.

    <AccordionGroup>
      <Accordion title="Display style">
        **Type:** Dropdown\
        **Options:** Hide, Drawer, Sidebar\
        **Default:** Drawer

        Controls the visual presentation of product filters:

        * **Hide** - Completely removes filtering functionality
        * **Drawer** - Filters appear in a slide-out panel, saving screen space
        * **Sidebar** - Filters are permanently visible in a left column

                  <img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/collections/filter-display.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=e7f551746fbc2d50d098f7e0556b5147" alt="Filter display options" width="3280" height="2186" data-path="images/theme/release/collections/filter-display.png" />

        <Tip>Sidebar works best for desktop collections with 5+ filter types. Drawer is ideal for mobile-first designs.</Tip>
      </Accordion>

      <Accordion title="Enable range slider for price filter">
        **Type:** Toggle\
        **Default:** Disabled

        Replaces checkbox-style price filtering with an interactive range slider allowing customers to set custom min/max price ranges.

        <Warning>Range slider requires JavaScript and may not work with all third-party filter apps. Test thoroughly before enabling on live stores.</Warning>

        <Tip>Range sliders work best for collections with wide, continuous price ranges (e.g., $10-$500). Use checkboxes for narrow or discrete price bands.</Tip>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Product Grid">
    Defines how products are displayed within the grid layout.

    <img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/collections/product-grid.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=0127c93d5700a533178c8858619c18b7" alt="Product grid settings" width="3280" height="2186" data-path="images/theme/release/collections/product-grid.png" />

    <AccordionGroup>
      <Accordion title="Products per row">
        **Type:** Range\
        **Options:** 3 or 4\
        **Default:** 4

        Number of product cards displayed in each row on desktop screens.

        * **3 products** - Larger product images, more detail visible
        * **4 products** - More products visible at once, efficient browsing

        <Tip>Use 3 columns for premium products where image quality matters. Use 4 columns for large catalogs where variety is key.</Tip>
      </Accordion>

      <Accordion title="Products per row for mobile">
        **Type:** Range\
        **Options:** 1 or 2\
        **Default:** 2

        Number of product cards displayed per row on mobile devices.

        * **1 product** - Maximum product detail on small screens
        * **2 products** - Balance between detail and variety

        <Note>Most mobile users prefer 2 columns as it allows comparison while maintaining readability.</Note>
      </Accordion>

      <Accordion title="Products per page">
        **Type:** Range\
        **Range:** 12-50 products\
        **Default:** 16

        Total number of products loaded before pagination or load more button appears.

        <Note>The actual product count may adjust slightly to maintain grid consistency when text cards are inserted.</Note>

        <Tip>For large collections (100+ products), use lower values (12-24) to improve page load speed. For curated collections, use higher values (36-50) to show the full selection.</Tip>
      </Accordion>

      <Accordion title="Pagination style">
        **Type:** Dropdown\
        **Options:** Default (page numbers), Load more\
        **Default:** Default

        Choose how customers navigate through multiple pages of products:

        * **Default** - Traditional numbered pagination (1, 2, 3...)
        * **Load more** - Single button that loads more products inline

        <Tip>Load more creates a seamless browsing experience and works well with infinite scroll.</Tip>
      </Accordion>

      <Accordion title="Enable infinity scroll">
        **Type:** Toggle\
        **Default:** Disabled\
        **Availability:** Only when "Load more" pagination is selected

        Automatically load more products as the customer scrolls down the page, eliminating the need to click "Load more".

        <img src="https://mintcdn.com/digifist/Tj70cY9UOMYie8gF/images/theme/release/collections/infinity-scroll.png?fit=max&auto=format&n=Tj70cY9UOMYie8gF&q=85&s=1bf86a58f4bfc2b96eae54754f511699" alt="Infinity scroll behavior" width="3280" height="2186" data-path="images/theme/release/collections/infinity-scroll.png" />

        <Tip>Infinity scroll works best with load more pagination for large collections (50+ products). It improves mobile browsing experience significantly.</Tip>

        <Warning>Some users prefer traditional pagination for better control. Test with your audience before enabling site-wide.</Warning>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Layout">
    Control the overall section layout, width, and spacing.

    <img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/collections/collection-layout.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=b4d96addad4b859c800372997e666698" alt="Layout settings" width="3280" height="2186" data-path="images/theme/release/collections/collection-layout.png" />

    <AccordionGroup>
      <Accordion title="Section width">
        **Type:** Dropdown\
        **Options:** max-w-page, max-w-fluid\
        **Default:** max-w-page

        Maximum width of the collection section:

        * **max-w-page** - Contained width matching your theme's standard page width
        * **max-w-fluid** - Full browser width, edge-to-edge layout

        <Tip>Use max-w-page for most collections to maintain visual consistency. Use max-w-fluid for large product grids where maximum visibility is needed.</Tip>
      </Accordion>

      <Accordion title="Color scheme">
        **Type:** Dropdown\
        **Default:** scheme-1

        Select the color scheme for the collection section. Available schemes are defined in **Theme settings > Colors**.

        <Note>Color scheme affects background, text, borders, and button colors throughout the section.</Note>
      </Accordion>

      <Accordion title="Spacing top">
        **Type:** Dropdown\
        **Options:** No (0), S (1), M (2), L (4), XL (6)\
        **Default:** M (2)

        Padding above the collection section, controlling vertical space from the previous section.
      </Accordion>

      <Accordion title="Spacing bottom">
        **Type:** Dropdown\
        **Options:** No (0), S (1), M (2), L (4), XL (6)\
        **Default:** M (2)

        Padding below the collection section, controlling vertical space to the next section.

        <Tip>Use consistent spacing (M or L) across collection pages for visual rhythm. Reduce spacing to S for tight, magazine-style layouts.</Tip>
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Block Settings

### Text Card Block

Insert promotional or informational cards within the product grid. Text cards are perfect for highlighting sales, cross-selling, or telling your brand story.

<Note>Maximum 5 text cards per collection page.</Note>

<img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/collections/text-card-block.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=9da6b29372d596ad3e425be68bff9d37" alt="Text card block example" width="3280" height="2186" data-path="images/theme/release/collections/text-card-block.png" />

<AccordionGroup>
  <Accordion title="Content">
    **Text**\
    **Type:** Rich text editor\
    **Default:** `<h3>Heading goes here</h3>`

    Rich text content for the card. Supports headings, paragraphs, bold, italic, and basic formatting.

    ***

    **Button link**\
    **Type:** URL field

    Destination URL for the card button or click action.

    ***

    **Link type**\
    **Type:** Dropdown\
    **Options:** Button, Card\
    **Default:** Button

    How the link functions:

    * **Button** - Traditional button element below content
    * **Card** - Entire card surface is clickable

    ***

    **Button label**\
    **Type:** Text field

    Text displayed on the button. Leave empty to hide button entirely.

    ***

    **Button style**\
    **Type:** Dropdown\
    **Options:** Filled, Outlined, Text\
    **Default:** Text

    Visual style of the button:

    * **Filled** - Solid background color, high contrast
    * **Outlined** - Border with transparent background
    * **Text** - Text-only link style, minimal
  </Accordion>

  <Accordion title="Layout">
    **Position**\
    **Type:** Number\
    **Range:** 1-50\
    **Default:** 8

    Where the text card appears in the product grid. Position 1 means after the first product, position 8 means after the 7th product, etc.

    <Note>If position exceeds products per page setting, the card appears at the end of the grid.</Note>

    ***

    **Column factor**\
    **Type:** Range\
    **Range:** 1-4\
    **Default:** 1

    How many columns the card spans horizontally. 1 = single column width, 2 = double width, etc.

    <Tip>Column factor automatically adjusts based on "Products per row" setting. A factor of 2 on a 4-column grid creates a half-width card.</Tip>

    ***

    **Row factor**\
    **Type:** Range\
    **Range:** 1-4\
    **Default:** 1

    How many rows the card spans vertically. 1 = single row height, 2 = double height, etc.

    <Tip>Use column\_factor: 2 and row\_factor: 2 to create a large featured card that stands out in the grid.</Tip>
  </Accordion>

  <Accordion title="Position & Alignment">
    **Content position**\
    **Type:** Dropdown\
    **Options:** Start, Center, End\
    **Default:** Center

    Vertical positioning of content within the card:

    * **Start** - Top aligned
    * **Center** - Vertically centered
    * **End** - Bottom aligned

    ***

    **Content alignment**\
    **Type:** Dropdown\
    **Options:** Start, Center, End\
    **Default:** Center

    Horizontal alignment of text:

    * **Start** - Left aligned
    * **Center** - Center aligned
    * **End** - Right aligned

    ***

    **Content position for mobile**\
    **Type:** Dropdown\
    **Options:** Start, Center, End\
    **Default:** Center

    Vertical positioning on mobile devices. Same options as desktop.

    ***

    **Content alignment for mobile**\
    **Type:** Dropdown\
    **Options:** Start, Center, End\
    **Default:** Center

    Horizontal alignment on mobile. Same options as desktop.

    <Note>Mobile alignment settings override desktop settings on screens smaller than 768px.</Note>
  </Accordion>

  <Accordion title="Visual Settings">
    **Color scheme**\
    **Type:** Dropdown\
    **Default:** scheme-1

    Color scheme for the text card. Available schemes match your theme's color settings.

    ***

    **Card image**\
    **Type:** Image picker

    Background image for the text card. When set, text content overlays the image.

    <Tip>Use high-contrast images and adjust content position/alignment for optimal text readability.</Tip>
  </Accordion>
</AccordionGroup>

## Common use cases

<Tabs>
  <Tab title="Sale collections">
    Insert text cards promoting "Extra 20% off" or free shipping thresholds at strategic positions (e.g., position 5 or 12) to maintain engagement throughout scrolling.
  </Tab>

  <Tab title="Category collections">
    Use sidebar filters for extensive categorization (size, color, material, brand). Enable sorting and product count to help customers navigate large selections efficiently.
  </Tab>

  <Tab title="New arrivals">
    Enable sorting by date with default sort set to "Date (new to old)". Use 4-column grid to showcase variety. Disable filters if the collection is curated.
  </Tab>

  <Tab title="Seasonal campaigns">
    Large text cards (column\_factor: 2, row\_factor: 2) at position 5 featuring campaign messaging, countdown timers, or exclusive offers.
  </Tab>

  <Tab title="Price-sensitive">
    Enable range slider for price filtering on electronics, furniture, or luxury goods where customers have specific budget ranges in mind.
  </Tab>

  <Tab title="Large inventories">
    Use infinite scroll + load more for collections with 100+ products. Set lower products per page (16-24) to maintain fast initial load times while enabling endless browsing.
  </Tab>

  <Tab title="Curated collections">
    Disable filters entirely, use 3-column grid for premium product presentation. Higher products per page (36-50) to show complete curated selection without pagination.
  </Tab>

  <Tab title="Flash sales">
    Text card at position 1 (immediately visible) with countdown timer and "Card" link type so entire card is clickable. Use filled button style for urgency.
  </Tab>

  <Tab title="Brand storytelling">
    Multiple text cards throughout grid (positions 5, 12, 20) telling brand narrative. Use card images with overlay text, centered content alignment.
  </Tab>

  <Tab title="Cross-sell">
    Text cards linking to complementary product collections. Position 8 or 12 after customers have seen initial products. Use "Shop accessories" or "Complete the look" messaging.
  </Tab>
</Tabs>

## Best practices

<CardGroup cols={2}>
  <Card title="Grid layout optimization" icon="grid">
    Use 4 products per row on desktop for balanced visibility and detail. This provides the best compromise between seeing multiple products and maintaining adequate product card size.
  </Card>

  <Card title="Mobile optimization" icon="mobile">
    Use 2 columns on mobile for better product card readability. Single column makes cards too large, while 2 columns allows comparison without sacrificing detail.
  </Card>

  <Card title="Filter placement strategy" icon="filter">
    Choose drawer for minimal filter collections (1-3 filters), sidebar for extensive filtering needs (5+ filters). Drawer keeps the layout clean while sidebar provides constant filter visibility.
  </Card>

  <Card title="Text card strategy" icon="square">
    Place cards every 8-12 products to maintain engagement without disrupting browsing flow. Too frequent placement becomes annoying, too infrequent loses impact.
  </Card>

  <Card title="Pagination performance" icon="arrows-rotate">
    Enable infinite scroll or load more for collections over 50 products to improve performance. Traditional pagination works better for smaller collections where customers want page-level control.
  </Card>

  <Card title="Price filtering" icon="dollar-sign">
    Use range slider only for collections with wide, continuous price ranges (e.g., $10-$500). For narrow or discrete price bands, checkbox filters are more intuitive.
  </Card>

  <Card title="Product count visibility" icon="hashtag">
    Always enable product count to set customer expectations about collection size. This is especially important for filtered results where count changes dynamically.
  </Card>

  <Card title="Text card sizing" icon="maximize">
    Use column\_factor 2 and row\_factor 2 for promotional cards to make them stand out against standard product cards. Single-cell cards blend in too much.
  </Card>

  <Card title="Filter defaults" icon="check">
    Keep accordions open by default for collections with 3-5 key filters. For 10+ filters, collapsed is better to prevent overwhelming customers.
  </Card>

  <Card title="Spacing consistency" icon="ruler">
    Use M (2) spacing for standard collections to maintain rhythm. Reduce to S (1) for featured/minimal layouts, increase to L (4) for luxury brands.
  </Card>
</CardGroup>

## Related guides

<CardGroup cols={3}>
  <Card title="Product Cards" icon="rectangle-wide" href="/themes/release/theme-settings/products">
    Configure product card display settings including image ratios, badges, and quick view
  </Card>

  <Card title="Filtering & Search" icon="magnifying-glass" href="/themes/release/collections/search">
    Advanced filtering and search configuration for collection pages
  </Card>

  <Card title="Collection List Page" icon="list" href="/themes/release/page-vendors">
    Display multiple collections on a list page for easier navigation
  </Card>
</CardGroup>
