> 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/promo-bar.md).

# Promo bar

Add a promotional strip with text, a button and an optional countdown timer.

The Promo bar section is a wide strip for promotions. It shows text and a button, and can include a countdown timer to build urgency for a sale or launch. You can also give it a background image.

Use it anywhere on a page, for example between sections on your home page. On desktop, the blocks sit side by side; on mobile, they stack.

### 1. How to add the section

In the theme editor, click **Add section** and choose **Promo bar** (in the **Storytelling** category). The section comes with one Text block and one Countdown timer block.

{% hint style="info" %}
**Note:** Promo bar is a page section. It can't be added to the header or footer areas.
{% endhint %}

### 2. Section settings

* **Color scheme:** the color scheme for the bar.
* **Hide section when countdown reaches zero:** hides the countdown timer once the end date and time have passed, so customers don't see an expired timer.
* **Show divider:** adds a thin line between the blocks.
* **Show border:** adds a border around the bar.
* **Background image:**
  * **Enable background image:** turn on to show the images below behind the content. When an image is shown, text turns white.
  * **Desktop image** and **Mobile image:** the background images. If you don't add a mobile image, the desktop image is used on mobile.
  * **Image overlay opacity:** darkens the image so text is easier to read (0–100%).
  * **Overlay style:** Gradient from bottom, Gradient from top or Full image darken.
  * **Enable parallax effect:** the image stays in place while the page scrolls. This effect isn't shown on phones.

{% 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).
{% endhint %}

### 3. Block settings

The section holds up to 2 blocks: two Text blocks, or one Text block and one Countdown timer block.

**Text block**

* **Heading:** the main promo text.
* **Heading size:** 15–80px. It's shown slightly smaller on mobile.
* **Description:** a short text below the heading.
* **Desktop content width:** the maximum width of the text (200–800px).
* **Desktop content alignment** and **Mobile content alignment:** Left, Center or Right.
* **Button:**
  * **Button label:** the button text. Leave it blank to hide the button.
  * **Button link:** where the button goes.
  * **Button style:** Solid, Outline or Text.

**Countdown timer block** (one per section)

* **Countdown end date:** the date the countdown ends, in the format `mm-dd-yyyy` (for example, `12-31-2026`).
* **Countdown end time:** the time the countdown ends, in the format `hh:mm:ss` (for example, `23:59:59`).
* **Number font:** Heading or Body.
* **Show timer labels:** shows Days, Hours, Minutes and Seconds under the numbers.
* **Size:** scales the timer (50–200%).
* **Color:** turn on **Use custom color** to pick a **Countdown timer** color.

{% hint style="info" %}
**Note:** The countdown uses the time zone set in your Shopify admin under **Settings > General**. The timer only appears when both the end date and end time are filled in.
{% endhint %}
