# Product list: Tab

To add this section, please follow the below steps:

1. From your Shopify admin, go to **Online Store** **->** **Themes**.
2. Find the theme that you want to edit, and then click **Customize**.
3. Click **Add section** and choose "**Product list: Tab**".

## Section settings <a href="#section-settings-1" id="section-settings-1"></a>

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Collection</td><td>Which collection you want to display products from.</td></tr><tr><td>Type</td><td><p>Choose how your product collection is displayed:</p><ul><li>Slide: Products appear in a horizontal scrollable slider.</li><li>Grid: Products are shown in a multi-column grid layout.</li></ul></td></tr><tr><td>Maximum products to show</td><td>The number of products from the collection to display. Minimum: 2. Maximum: 25.</td></tr><tr><td>Number of columns on desktop</td><td>Determines the number of product columns on the desktop. Can be from 2 to 4, increasing arithmetically of 1.</td></tr><tr><td>Show navigation arrows below content on desktop</td><td><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Slide</strong></mark><strong>)</strong></sup><br>Displays the navigation arrows below content on desktop.</td></tr><tr><td>Pagination style</td><td><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Slide</strong></mark><strong>)</strong></sup><br>Choose layout for the pagination.</td></tr></tbody></table>

## Mobile layout

<table><thead><tr><th width="278">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Number of columns on mobile</td><td><p><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Slide</strong></mark><strong>)</strong></sup><br>Determines the number of product columns on the mobile:</p><ul><li>1 column</li><li>1.5 columns</li><li>2 columns</li></ul></td></tr><tr><td>Number of columns on mobile</td><td><p><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Grid</strong></mark><strong>)</strong></sup><br>Determines the number of product columns on the mobile:</p><ul><li>1 column</li><li>2 columns</li></ul></td></tr><tr><td>Enable swipe on mobile</td><td><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Slide</strong></mark><strong>)</strong></sup><br>Allow customers to swipe horizontally to view additional column blocks.</td></tr><tr><td>Show pagination</td><td><sup><strong>(Displayed if the </strong><mark style="color:red;"><strong>Type</strong></mark><strong> setting is set to </strong><mark style="color:red;"><strong>Slide</strong></mark><strong>)</strong></sup><br>Displays the pagination for this section.</td></tr></tbody></table>

## Layout <a href="#section-settings-1" id="section-settings-1"></a>

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Direction</td><td>The title for this section.</td></tr><tr><td>Wrap</td><td>Style of the heading.</td></tr><tr><td>Gap</td><td><p>The size of the heading text:</p><ul><li>Small</li><li>Medium</li><li>Large</li><li>Extra large</li></ul></td></tr><tr><td>Align items</td><td><p>The alignment of the heading text and description within the section container:</p><ul><li><strong>Left</strong> - Aligns the heading and description to the left.</li><li><strong>Center (default)</strong> - Aligns the heading and description in the center.</li><li><strong>Right</strong> - Aligns the heading and description to the right.</li></ul></td></tr><tr><td>Justify content</td><td>The description for this section.</td></tr></tbody></table>

### Style

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Color scheme</td><td>Set the color for the section.</td></tr></tbody></table>

### Spacing

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Desktop left padding</td><td>Determines the width of the left inner space of the section on desktop. Can be from 0px to 100px, increasing arithmetically of 2px (pixel).</td></tr><tr><td>Desktop right padding</td><td>Determines the width of the right inner space of the section on desktop. Can be from 0px to 100px, increasing arithmetically of 2px (pixel).</td></tr><tr><td>Top padding</td><td>Determines the height of the top inner space of the section. Can be from 0px to 150px, increasing arithmetically of 2px (pixel).</td></tr><tr><td>Bottom padding</td><td>Determines the height of the bottom inner space of the section. Can be from 0px to 150px, increasing arithmetically of 2px (pixel).</td></tr></tbody></table>

***

## Header block

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Heading alignment</td><td>Select the position of the content to be either to the left, right or center of its container.</td></tr></tbody></table>

***

***

## Product card block

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Product</td><td>Select a product you want to display.</td></tr><tr><td>Color scheme</td><td>Set the color for the block.</td></tr></tbody></table>

### Product media

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Product</td><td>Select a product you want to display.</td></tr><tr><td>Image ratio</td><td><p>The image ratio for the product images:</p><ul><li><strong>Adapt to image (default)</strong> - Uses the aspect ratio of the images. This prevents the images from being cropped.</li><li><strong>Square</strong> - Crops the images to use a 1:1 ratio.</li><li><strong>Portrait</strong> - Crops the images to use a 2:3 ratio.</li></ul></td></tr><tr><td>Show second image on hover</td><td>When the customer hovers their cursor over the product image, displays the second product image if the product has one.</td></tr><tr><td>Enable quick add button</td><td>Displays the quick add button that opens a popup displaying all the essential product details.</td></tr></tbody></table>

### Product vendor

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Product</td><td>Select a product you want to display.</td></tr></tbody></table>

### Product title

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Product</td><td>Select a product you want to display.</td></tr></tbody></table>

### Product price

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Product</td><td>Select a product you want to display.</td></tr></tbody></table>

***

## Product space block

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Padding</td><td>Controls the top and bottom inner spacing of the block. Adjustable from 0px to 150px in steps of 2px.</td></tr></tbody></table>

***

## Product text block

<table><thead><tr><th width="276">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Description</td><td>The description for this block.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://halosoft.gitbook.io/soul-documentation/sections/template-sections/product-list-tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.