> ## 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 list page (CLP)

> Customize the layout and features of your collection list pages.

Collection list pages display a grid of collections, allowing customers to browse and shop from various collection categories. You can customize the grid layout, card appearance, pagination style, and choose between automatic or curated collection displays.

<img src="https://mintcdn.com/digifist/rzBLDFQOmpu_Zuma/images/theme/release/sections/main-list-collections/list-overview.png?fit=max&auto=format&n=rzBLDFQOmpu_Zuma&q=85&s=59c680c7055749830096ddea84d0ebaf" alt="Collections list page overview" width="3280" height="2186" data-path="images/theme/release/sections/main-list-collections/list-overview.png" />

## What this section controls

This section manages:

* **Collection grid layout** - Set items per row for desktop and mobile displays
* **Collection card styling** - Control card title style, aspect ratios, and product count display
* **Collection source** - Choose between all collections (automatic) or selected collections (manual curation)
* **Pagination** - Control pagination style, load more button, and infinity scroll
* **Section layout** - Adjust section width, color scheme, and spacing
* **Individual collection blocks** - Customize per-collection images, headings, and color schemes

## Getting started

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

  <Step title="Navigate to Collection list">
    In the left sidebar, find the **Collection list** section
  </Step>

  <Step title="Choose collection source">
    Decide between **All collections** (automatic display) or **Selected collections** (manual curation)
  </Step>

  <Step title="Configure grid layout">
    Set items per row (3 or 4 columns) and card aspect ratio in the **Grid Layout** tab
  </Step>

  <Step title="Customize card appearance">
    Set title style and product count display in the **Card Design** tab
  </Step>

  <Step title="Add collection blocks (optional)">
    If using Selected mode, click **Add block** > **Collection** to manually add collections with custom styling
  </Step>
</Steps>

## Section Settings

<Tabs>
  <Tab title="Collections">
    Control which collections are displayed and how many per page.

    <img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/sections/main-list-collections/collections-mode.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=a4053b3f4774d154866fa3ab13048d82" alt="Collections display mode" width="3280" height="2186" data-path="images/theme/release/sections/main-list-collections/collections-mode.png" />

    <AccordionGroup>
      <Accordion title="Collections to show">
        **Type:** Dropdown\
        **Options:** All collections, Selected collections\
        **Default:** All collections

        Choose which collections to display:

        * **All collections** - Automatically shows all store collections
        * **Selected collections** - Only shows collections added as blocks

        <Tip>
          Use "Selected collections" to curate order, visibility, and customize individual collection cards with custom images and headings.
        </Tip>
      </Accordion>

      <Accordion title="Collections per page">
        **Type:** Range\
        **Range:** 3-50\
        **Default:** 12\
        **Availability:** Only applies when "All collections" is selected

        Number of collections loaded before pagination appears. Higher values show more collections at once but may slow page loading.

        <Note>
          This setting is ignored when "Selected collections" mode is active. In selected mode, only manually added collection blocks appear.
        </Note>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Grid Layout">
    Define the grid structure and how collection cards are arranged.

    <img src="https://mintcdn.com/digifist/rzBLDFQOmpu_Zuma/images/theme/release/sections/main-list-collections/grid-settings.png?fit=max&auto=format&n=rzBLDFQOmpu_Zuma&q=85&s=d370925cf042ab96b455f1e94a083cc1" alt="Grid layout options" width="3280" height="2186" data-path="images/theme/release/sections/main-list-collections/grid-settings.png" />

    <AccordionGroup>
      <Accordion title="Items per row">
        **Type:** Dropdown\
        **Options:** 3, 4\
        **Default:** 4

        Number of collection cards per row on desktop screens.

        * **3** - Larger cards with more prominent images
        * **4** - More collections visible at once, efficient browsing

        <Tip>Use 3 columns for premium brands where large imagery matters. Use 4 columns for stores with many collections where variety is key.</Tip>
      </Accordion>

      <Accordion title="Items per row for mobile">
        **Type:** Dropdown\
        **Options:** 1, 2\
        **Default:** 2

        Number of cards per row on mobile devices.

        * **1** - Single column layout, maximum card size
        * **2** - Two columns, balance between size and scrolling

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

  <Tab title="Card Design">
    Control the visual appearance of individual collection cards.

    <img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/sections/main-list-collections/card-design.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=9e12a805c02e9a3d344524c22a05139e" alt="Collection card design" width="3280" height="2186" data-path="images/theme/release/sections/main-list-collections/card-design.png" />

    <AccordionGroup>
      <Accordion title="Card title style">
        **Type:** Dropdown\
        **Options:** Single text, Text with arrow\
        **Default:** Single text

        Visual style for collection card titles.

        * **Single text** - Clean text-only display
        * **Text with arrow** - Text plus arrow icon for visual cue

        <Tip>Text with arrow encourages clicking and signals interactivity. Single text provides a cleaner, more minimal aesthetic.</Tip>
      </Accordion>

      <Accordion title="Collection product count">
        **Type:** Dropdown\
        **Options:** Hide, Show, With border\
        **Default:** Show

        Display product count on collection cards.

        * **Hide** - No product count visible
        * **Show** - Display count below collection title
        * **With border** - Count with decorative border accent

        <Tip>
          Product counts help customers understand collection size and make informed browsing decisions. Always show for stores with varying collection sizes.
        </Tip>
      </Accordion>

      <Accordion title="Card media aspect ratio">
        **Type:** Dropdown\
        **Options:** Auto, 1:1, 4:3, 3:2, 5:4, 16:9, 2:1, 4:1, 8:1, 3:4, 2:3, 4:5, 9:16, 1:2\
        **Default:** 3:4 (Portrait)

        Aspect ratio for collection images.

        **Landscape ratios:**

        * **1:1** - Square
        * **4:3, 3:2, 5:4, 16:9, 2:1, 4:1, 8:1** - Various landscape formats

        **Portrait ratios:**

        * **3:4, 2:3, 4:5, 9:16, 1:2** - Various portrait formats

        **Auto:** Adaptive to original image dimensions

        <Tip>3:4 portrait works well for most collection images and matches common product photography ratios.</Tip>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Pagination">
    Control how customers navigate through multiple pages of collections.

    <AccordionGroup>
      <Accordion title="Pagination style">
        **Type:** Dropdown\
        **Options:** Page numbers, Load more\
        **Default:** Page numbers

        How customers navigate through collection pages.

        * **Page numbers** - Traditional pagination with numbered links (1, 2, 3...)
        * **Load more** - Single button that loads additional collections inline

        <Note>
          Pagination only applies when "All collections" mode is selected. Selected collections mode displays all added blocks without pagination.
        </Note>
      </Accordion>

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

        Automatically loads more collections while customer scrolls down the page, eliminating the need to click "Load more" button.

        <Tip>Infinity scroll works best for stores with 20+ collections. It improves mobile browsing experience by reducing interaction requirements.</Tip>

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

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

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

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

        Maximum width of the collections section.

        * **max-w-page** - Standard container matching theme's page width
        * **max-w-fluid** - Wider container utilizing more screen space

        <Tip>Use max-w-page for visual consistency with other pages. Use max-w-fluid for large grids where maximum visibility is beneficial.</Tip>
      </Accordion>

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

        Select the color scheme for the 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 collections 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 collections section, controlling vertical space to the next section.

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

## Block Settings

### Collection Block

Add individual collections with custom styling. Only used in "Selected collections" mode. Maximum 50 blocks.

<Note>Collection blocks are only visible when "Selected collections" is chosen in the Collections tab.</Note>

<img src="https://mintcdn.com/digifist/j7jhcMbQQeX1DfIN/images/theme/release/sections/main-list-collections/collection-block.png?fit=max&auto=format&n=j7jhcMbQQeX1DfIN&q=85&s=a9f16427ec395300cb43a53a43243afc" alt="Collection block settings" width="2870" height="1790" data-path="images/theme/release/sections/main-list-collections/collection-block.png" />

<AccordionGroup>
  <Accordion title="Collection">
    **Type:** Collection picker\
    **Required:** Yes

    Select which collection to display in this card position. Opens the Shopify collection selector.
  </Accordion>

  <Accordion title="Image">
    **Type:** Image picker\
    **Optional:** Yes

    Custom image that overwrites the collection's default featured image. Use this to create consistent branding or highlight specific aspects of the collection.

    <Tip>Override images in blocks for consistent brand look across all collection cards, even if individual collections have varying image styles.</Tip>
  </Accordion>

  <Accordion title="Heading">
    **Type:** Text field\
    **Optional:** Yes

    Custom heading that overwrites the collection's default title. Use this for marketing-friendly names or seasonal messaging.

    <Tip>Use custom headings for "Sale Collections" or "New Arrivals" when the actual collection name is generic.</Tip>
  </Accordion>

  <Accordion title="Heading size">
    **Type:** Dropdown\
    **Options:** XS (h6), S (h5), M (h4), L (h3)\
    **Default:** M (h4)

    Size of collection title text. Larger headings draw more attention to priority collections.
  </Accordion>

  <Accordion title="Subheading">
    **Type:** Text field\
    **Optional:** Yes

    Additional text below the main heading. Perfect for descriptive content like "New", "Sale", "Limited Time", or product count.

    <Tip>Use subheadings for "New", "Sale", "Limited Time" messaging to create urgency and highlight special collections.</Tip>
  </Accordion>

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

    Per-collection color scheme. Allows individual cards to have different background and text colors for visual hierarchy.

    <Tip>Use contrasting color schemes for sale or featured collections to make them stand out in the grid.</Tip>
  </Accordion>
</AccordionGroup>

## Common use cases

<Tabs>
  <Tab title="All collections page">
    Display all store collections automatically in a standard grid.

    **Configuration:**

    * Collections: All collections
    * Items per row: 4
    * Product count: Show
    * Collections per page: 12
    * Pagination: Page numbers
  </Tab>

  <Tab title="Curated navigation">
    Hand-pick specific collections in priority order for featured landing pages.

    **Configuration:**

    * Collections: Selected collections
    * Add blocks: Priority collections first
    * Custom images: Yes, for brand consistency
    * Heading sizes: Vary (L for hero, M for others)
  </Tab>

  <Tab title="Category pages">
    Visual merchandising with custom images and headings per collection.

    **Configuration:**

    * Collections: Selected collections
    * Custom images: All collections
    * Custom headings: Marketing-friendly names
    * Subheadings: Descriptive text
  </Tab>

  <Tab title="Sale section">
    Highlight sale collections with distinctive styling.

    **Configuration:**

    * Collections: Selected collections
    * Color schemes: scheme-2 (contrast color) for sale items
    * Subheadings: "Up to 50% off", "Limited time"
    * Card title style: Text with arrow
  </Tab>

  <Tab title="Seasonal display">
    Create seasonal collection pages with timely messaging.

    **Configuration:**

    * Collections: Selected collections
    * Subheadings: "New", "Sale", "Limited Time"
    * Custom images: Seasonal photography
    * Heading sizes: L for featured seasonal collection
  </Tab>

  <Tab title="Large catalogs">
    Efficiently display stores with 50+ collections.

    **Configuration:**

    * Collections: All collections
    * Pagination style: Load more
    * Enable infinity scroll: Yes
    * Collections per page: 16-24
  </Tab>

  <Tab title="Brand storytelling">
    Use custom content to tell brand narrative through collections.

    **Configuration:**

    * Collections: Selected collections
    * Custom images: Brand lifestyle photography
    * Subheadings: Descriptive brand messaging
    * Items per row: 3 (larger cards)
  </Tab>

  <Tab title="Department store">
    Display major collection categories like a traditional department store.

    **Configuration:**

    * Collections: All collections mode
    * Items per row: 3 (larger card display)
    * Card ratio: 4:3 landscape
    * Product count: With border
  </Tab>
</Tabs>

## Best practices

<CardGroup cols={2}>
  <Card title="Grid layout optimization" icon="grid">
    Use 4 columns on desktop for optimal visibility and efficient browsing. This balances card size with variety, letting customers see many options at once.
  </Card>

  <Card title="Aspect ratio consistency" icon="image">
    3:4 portrait works well for most collection images and matches common product photography ratios. Maintain consistency across all cards for professional appearance.
  </Card>

  <Card title="Product count display" icon="hashtag">
    Always show product counts to help customers understand collection size and make informed browsing decisions. This is especially valuable when collection sizes vary significantly.
  </Card>

  <Card title="Selected mode strategy" icon="hand-pointer">
    Use "Selected collections" when you want to control order, visibility, or customize per-collection. Perfect for curated landing pages and seasonal campaigns.
  </Card>

  <Card title="All mode efficiency" icon="layer-group">
    Use "All collections" for stores with many collections that change frequently. This automates display and reduces manual maintenance.
  </Card>

  <Card title="Card style choice" icon="arrow-pointer">
    Text with arrow encourages clicking and signals interactivity. Single text provides cleaner, more minimal aesthetic. Choose based on brand style.
  </Card>

  <Card title="Image consistency" icon="images">
    Override images in blocks for consistent brand look across all collection cards, even when individual collections have varying image styles.
  </Card>

  <Card title="Mobile optimization" icon="mobile">
    2 columns on mobile provides good balance between card size and scrolling length. Single column makes cards too large for quick browsing.
  </Card>

  <Card title="Pagination strategy" icon="arrows-rotate">
    Enable infinity scroll for stores with 20+ collections to improve mobile experience. Traditional pagination works better for smaller collection counts where users want page-level control.
  </Card>
</CardGroup>

## Related guides

<CardGroup cols={2}>
  <Card title="Collection Pages" icon="layer-group" href="/themes/release/collections/collection-page">
    Configure individual collection page layouts and filtering
  </Card>

  <Card title="Featured Collections" icon="star" href="/themes/release/sections/highlighted-collections">
    Display featured collections on homepage sections
  </Card>
</CardGroup>
