> For the complete documentation index, see [llms.txt](https://halosoft.gitbook.io/ella-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/ella-documentation/sections/all-sections-in-theme/custom-product-widget.md).

# Custom Product Widget

<figure><img src="/files/pQBeLCJowhzrsZJG66J7" alt=""><figcaption></figcaption></figure>

To add this section, please follow 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 "**Custom product widget**".

## Section settings

### General

<table><thead><tr><th width="325">Settings</th><th>Meaning</th><th data-hidden></th></tr></thead><tbody><tr><td>Section width</td><td>Select the layout width of the whole section. The options are: <br><br><mark style="color:orange;"><strong>Width (1170px)</strong></mark><br><mark style="color:orange;"><strong>Width (1370px)</strong></mark><br><mark style="color:orange;"><strong>Width (1470px)</strong></mark><br><mark style="color:orange;"><strong>Width (1570px)</strong></mark><br><mark style="color:orange;"><strong>Width (1770px)</strong></mark><br><mark style="color:orange;"><strong>Width (1920px)</strong></mark><br><mark style="color:orange;"><strong>Full Width (100% of the viewport width).</strong></mark></td><td></td></tr><tr><td>Padding for 'full width' option on desktop</td><td>Determine the left and right spacing of the full width layout.</td><td></td></tr><tr><td>Background color</td><td>Set color for the section background.</td><td></td></tr><tr><td>Background gradient</td><td>Set color gradient for the section background.</td><td></td></tr><tr><td>Background image</td><td>Upload/Select an image as the section background.</td><td></td></tr><tr><td>Enable sticky heading on desktop</td><td>Enable sticky heading section.</td><td></td></tr><tr><td>Show title border</td><td>Enable the title border.<br><br><em><mark style="color:orange;">Note: Only applicable when the 'enable sticky heading' setting is disabled.</mark></em></td><td></td></tr><tr><td>Alignment</td><td>Select the alignment of the header text to be either to the Left, Center or to the Right of the section.</td><td></td></tr><tr><td>Title</td><td>Enter the text for the title.</td><td></td></tr><tr><td>Title font size</td><td>Specify the font size of the title on desktop.</td><td></td></tr><tr><td>Title font size on mobile</td><td>Specify the font size of the title on mobile.</td><td></td></tr><tr><td>Title bottom margin</td><td>Determine the spacing of the title from bottom on Desktop.</td><td></td></tr><tr><td>Title bottom margin on mobile</td><td>Determine the spacing of the title from bottom on Mobile.</td><td></td></tr><tr><td>Title color</td><td>Apply a color to the text.</td><td></td></tr><tr><td>Title border color</td><td>Set color for the border/underline of the title.</td><td></td></tr></tbody></table>

### Section top padding

<table><thead><tr><th width="334">Settings</th><th>Meaning</th></tr></thead><tbody><tr><td>Desktop</td><td>Determines the height of the top inner space of the section on the desktop device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr><tr><td>Tablet</td><td>Determines the height of the top inner space of the section on the tablet device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr><tr><td>Mobile</td><td>Determines the height of the top inner space of the section on the mobile device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr></tbody></table>

### Section bottom padding

<table><thead><tr><th width="334">Settings</th><th>Meaning</th></tr></thead><tbody><tr><td>Desktop</td><td>Determines the height of the bottom inner space of the section on the desktop device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr><tr><td>Tablet</td><td>Determines the height of the bottom inner space of the section on the tablet device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr><tr><td>Mobile</td><td>Determines the height of the bottom inner space of the section on the mobile device. Can be from 0px to 100px, increasing arithmetically of 5px (pixel).</td></tr></tbody></table>

## Block settings

### Video

<table><thead><tr><th width="331">Settings</th><th>Meaning</th><th data-hidden></th></tr></thead><tbody><tr><td>Cover image</td><td>Set Cover Image for video</td><td></td></tr><tr><td>Video type</td><td>Select the video type. There are 2 options:<br><br><mark style="color:orange;"><strong>YouTube or Vimeo</strong></mark><br><mark style="color:orange;"><strong>Mp4</strong></mark></td><td></td></tr><tr><td>A video from youtube or vimeo on desktop</td><td>Enter a URL for a YouTube or Vimeo video.<br><br><em><mark style="color:orange;">Note: Use a youTube or vimeo link.</mark></em></td><td></td></tr><tr><td>An MP4 video on desktop</td><td>Select video Mp4.<br><br><em><mark style="color:orange;">Note: Describe the video to make it accessible for customers using screen Readers.</mark></em></td><td></td></tr><tr><td>Video height (unit %)</td><td>Enter the Width / Height ratio to render the video.</td><td></td></tr><tr><td>Video alt text</td><td>Describe The Video To Make It Accessible For Customers Using Screen Readers.</td><td></td></tr><tr><td>Auto-play video</td><td>Set auto play for video.</td><td></td></tr></tbody></table>

### Product

<table><thead><tr><th width="331">Settings</th><th>Meaning</th><th data-hidden></th></tr></thead><tbody><tr><td>Collection</td><td>Select a collection to show on the block.</td><td></td></tr><tr><td>Maximum products to show</td><td>Limit the number of products displayed on this block.</td><td></td></tr><tr><td>Show navigation dots on desktop</td><td>Toggle the paginating dots on desktop.</td><td></td></tr><tr><td>Show navigation dots on mobile/tablet</td><td>Toggle the paginating dots on tablet and mobile.</td><td></td></tr><tr><td>Top margin of the navigation dots</td><td>Determine the spacing of the dots from the slider.</td><td></td></tr><tr><td>Show navigation arrows on desktop</td><td>Toggle the navigation arrows on desktop.</td><td></td></tr><tr><td>Show navigation arrows on mobile/tablet</td><td>Toggle the navigation arrows on mobile.</td><td></td></tr><tr><td>Show slide counter</td><td>Show above next arrow of slider. (Position current of item on slider / total items)</td><td></td></tr><tr><td>Show scroll bar</td><td>Show Progress Bar of slider.</td><td></td></tr><tr><td>Height</td><td>Specify scrollbar height.</td><td></td></tr><tr><td>Track background color</td><td>Apply a background color to Scrollbar Track.</td><td></td></tr><tr><td>Thumb background color</td><td>Apply a background color to Scrollbar Thumb.</td><td></td></tr><tr><td>Thumb background hover color</td><td>Apply a background color hover to Scrollbar Thumb.</td><td></td></tr></tbody></table>