> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/image-banner.md).

# Image banner

The Image banner section displays a striking full-width image with customizable text, buttons, and an optional countdown timer.

Use the Image banner to promote key products, offers or new collections with a large image and text on top. You can set a separate image and layout for mobile.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FZfboJasj8oQYlfxXujSt%2FScreenshot%202025-12-04%20at%203.16.35%E2%80%AFPM.png?alt=media&amp;token=73eff0f2-c631-46ec-ada3-e5d9bfd8477b" alt=""><figcaption></figcaption></figure>

### 1. How to add the section

{% stepper %}
{% step %}
In the theme editor, click **Add section**.
{% endstep %}

{% step %}
Choose **Image banner** (in the **Banners** category). The section is added with a heading, text and buttons, ready for you to customize.
{% endstep %}
{% endstepper %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FA3txyCpe3iKkCWGiUf0g%2FScreenshot%202025-10-01%20at%203.10.53%E2%80%AFPM.png?alt=media&amp;token=04a93d9b-002a-4bc2-8687-0530a7484a46" alt=""><figcaption></figcaption></figure>

### 2. Section settings

Click the **Image banner** section to open its settings.

**General**

* **Image:** the main banner image. 1920 x 1080px is recommended.
* **Mobile image:** an optional image for mobile (1000 x 500px recommended). If you leave it empty, the main image is used on mobile too.
* **Image overlay opacity:** adds a dark layer over the image (0–100%) so your text is easier to read.
* **Overlay style:** how the overlay is applied:

{% tabs %}
{% tab title="Gradient from bottom" %}
Applies a gradient starting from the bottom of the image.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FYMnxJGZw8PEgOyUpgpbO%2FScreenshot%202025-07-17%20at%204.13.25%E2%80%AFPM.png?alt=media&amp;token=8b7f64da-2f59-45e3-9e32-95132e32698f" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Gradient from top" %}
Applies a gradient starting from the top of the image.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2Fn07u9q5j8CGGqgcz17uh%2FScreenshot%202025-07-17%20at%204.14.20%E2%80%AFPM.png?alt=media&amp;token=b1beefc3-cdf6-4fdd-8fe3-9fe69f128474" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Full image darken" %}
Darkens the whole image evenly.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FjEoBdeDzAR7K89asP78b%2FScreenshot%202025-07-17%20at%204.11.55%E2%80%AFPM.png?alt=media&amp;token=a10d065b-c237-4595-9be6-b454b3c83523" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* **Desktop banner height:** Adapt to image size, Small, Medium, Large, Full screen or Custom. **Adapt to image size** keeps the image's own proportions. **Full screen** fills the height of the screen.
  * **Custom desktop height:** appears when you choose **Custom**. Set an exact height from 200 to 1000px.
* **Desktop content position:** where the text and buttons sit on the image on desktop. Choose from 9 positions: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center or Bottom right. A few examples:

{% tabs %}
{% tab title="Middle left" %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2F0sXhyfVdd7Qwgb3l7eQ3%2FScreenshot%202025-07-17%20at%204.24.52%E2%80%AFPM.png?alt=media&amp;token=72954eac-efc3-43ad-ba12-7dd6fed06cde" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Middle center" %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FnTigUvJicDpQ6YCngslj%2FScreenshot%202025-07-17%20at%204.26.14%E2%80%AFPM.png?alt=media&amp;token=5bd48e6a-4ee2-4c70-9879-c095aa674eea" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Middle right" %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FsX0gpdg5wSq2qfjhXPKD%2FScreenshot%202025-07-17%20at%204.26.28%E2%80%AFPM.png?alt=media&amp;token=e824a8f5-6751-42c7-b825-d0be995d0510" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* **Desktop content width:** the maximum width of the text area. Options: Small, Medium or Large. On mobile, the width is adjusted automatically.

**Mobile layout**

* **Mobile banner height:** Adapt to image size, Small, Medium, Large, Full screen or Custom.
  * **Custom mobile height:** appears when you choose **Custom**. Set an exact height from 200 to 800px.
* **Mobile content alignment:** where the content sits on the image on mobile. The same 9 positions as on desktop.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md). The Small, Medium and Large heights are set in [Appearance](https://help.byinspiredlabs.com/theme-settings/appearance.md).
{% endhint %}

### 3. Block settings

Click **Add block** inside the section to add content. You can drag blocks to change their order.

**a. Heading** (up to 2)

* **Heading:** your banner title.
* **Heading size:** Small, Medium, Large, Extra large or Extra extra large.
* **Enable key words highlight:** highlights words you've set in italic. Select the words in the **Heading** field and press the italic button, then turn this on and pick the highlight color in **Text**.
* **Use custom color:** pick your own heading color.

**b. Text** (up to 2)

* **Description:** supporting text under the heading.

**c. Caption**

* **Text:** a short tagline.
* **Text style:** Subtitle or Uppercase.

**d. Buttons**

* Settings for the **First button** and **Second button:** **Button label**, **Button link** and **Button style** (Solid, Outline or Text). Leave a label empty to hide that button.
* **Use custom colors:** pick a color scheme for each button.

**e. Countdown timer**

* **End date** (format `mm-dd-yyyy`) and **End time** (format `hh:mm:ss`). The timer uses the time zone set in your Shopify settings.
* **Font:** use your Body or Heading font for the numbers.
* **Hide when countdown reaches zero:** hides the timer once the time is up.
* **Style:** With border or No border.
* **Use custom color:** pick your own countdown color.

**f. Collections**

* **Collections:** pick up to 6 collections to show as links on the banner.
* **Use custom color:** change the link color (white by default).

**g. Scrolling images**

Adds a row of small images that scroll continuously across the banner. The row pauses when a visitor hovers over it.

* **Position:** Top, Middle or Bottom of the banner.
* **Vertical offset:** moves the row up or down (-100 to 100px).
* **Image width:** the width of each image (30–300px).
* **Space between images:** 0–100px.
* **Direction:** Left or Right.
* **Speed:** how long one scroll cycle takes (5–40 seconds). A lower value scrolls faster.
* **Image ratio:** Adapt to image, Square, Portrait, Circle or Landscape.
* **Image 1** to **Image 6:** choose an **Image** and an optional **Link** for each.

**h. Rating**

* **Rating:** a star rating from 0 to 5, in half-star steps.
* **Star color:** the color of the stars.
* **Text:** text shown next to the stars, for example "Excellent 4.9".

**i. Logo image**

* **Image:** a logo or graphic shown on the banner.
* **Desktop width** and **Mobile width:** the logo size, as a percentage (10–100%).
* **Position:** Middle or Bottom.
* **Alignment:** Left, Center or Right.
