> For the complete documentation index, see [llms.txt](https://halosoft.gitbook.io/soul-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://halosoft.gitbook.io/soul-documentation/sections/template-sections/product-list-tab.md).

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