# Promotion bar

Use the **Promotion banner** section to announce a campaign, event, or other promotion. Choose between **two column** or **one column** layout, then add custom promo text, images, buttons, and colors.

{% hint style="info" %}
See the [Promotion banner](/stiletto/sections/theme-sections/promotion-banner.md) section for a more compact promotional section. See the Sales banner for a similar section with a prominent sales price.
{% endhint %}

## Set up section

***

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](/stiletto/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [insert dynamic content with metafields](/stiletto/general/adapting-your-theme/dynamic-content-with-metafields.md)
{% endhint %}

In the editor side panel, click **(+) Add section** and select **Promotion bar**. Click and hold the drag handles **`⋮⋮`** to re-order sections.

Click the section to edit the general **section styles:** [Padding](/stiletto/sections/theme-sections/using-sections.md#section-padding) | [Animation](/stiletto/sections/theme-sections/using-sections.md#section-animations)

### Add headings and text

***

Change the **Heading** and **Text** that display within the bar.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Promotion bar** section to open the settings.
2. Enter **Heading** text to display as a title on the left side of the bar.

   > we recommend one to three words.

   > Delete the text in this field to remove the heading.
3. Enter additional **Text** to the right of the heading.

   > We recommend one to two short sentences.

   > Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's [Rich text editor guide](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor).
4. Click **Save**.

</details>

### Add buttons

***

Add a **Button** to link to your collections or products or any other page with a custom label.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Promotion bar** section to open the settings.
2. Select or paste a URL for the **Button link**.
3. Enter text for the **Button label**.

   > The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, [read "What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380)
4. Select a **Button style**: either **Solid**, **Outline**, or **Text**.

   > The button uses the theme-wide button color set in the Theme settings.
5. Click **Save**.

</details>

### **Add background image**

***

Choose to display a background image that spans the entire bar instead of a background color.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Promotion banner** section to open the settings.
2. (*Optional*.) Under **Background image**, click **Select image** to upload a background image.

   > For optimal quality across all devices, we recommend images with a minimum width of `2500px`.
3. Use **Image focal points** to specify the main focus of your images. The focal point of your image will remain centered and within frame when your site adapts to different screen sizes.

   > See our [image guide](/stiletto/general/image-guide/theme-image-settings.md#image-focal-point) to learn more about specifying a focal point for an image used within a section or for an uploaded image file when used anywhere on your site.
4. Use the color selector to change the **Text** and **Background** color.

   > The background color appears when there's no background image.
5. (*Optional*.) Change the **Overlay color** and **Overlay opacity** using the slider to increase the contrast between the text and background image (if used).

   > These settings help make your text clear and readable.
6. (*Optional*.) Click the **Overlay gradient** option to add a color overlay that fades across a range of hues.

   > You can choose the style, angle, position, and opacity of the gradient. See Shopify's [color gradient guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) to learn more.
7. Click **Save**.

</details>

## Section style

***

Choose whether to enable **Full width**, customize section colors, and adjust the **Padding** of the section.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Promotion bar** section and scroll down to the **Section style** settings.
2. Use the **Height** and **Mobile Height** sliders to adjust the height of the entire bar.

   > Choose between **`60 - 300px`** for desktop and mobile.
3. Under **Color** in the section settings, use the color selectors to customize the **Text**, **Buttons**, **Sold button text**, and **Background color**.

   > We recommend using WebAIM's [contrast checker](https://webaim.org/resources/contrastchecker/) when matching colors to make sure your text is clear and readable for everyone.
4. Choose whether to **Enable animation** to show visual effects when scrolling, hovering, or interacting with the section.

   > Learn more about [Section animations](/stiletto/theme-styles/animation.md).
5. Check the **Enable full width** option to span the bar across the whole window or screen, removing the margins on either side.
6. Select a **Padding** option to add space around the section to either the **Top and bottom**, **Top only**, **Bottom only**, or set it to **None**.
7. Click **Save**.

</details>

## Settings reference

Click the **Promotion bar** section to find the following settings.

#### Bar

<table><thead><tr><th width="149">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Height</td><td>Change the height of the bar for desktop screens: between <strong>60</strong> and <strong>300</strong> pixels.</td></tr><tr><td>Mobile height</td><td>Change the height of the bar for mobile screens: between <strong>60</strong> and <strong>300</strong> pixels.</td></tr></tbody></table>

#### Content

<table><thead><tr><th width="178">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Heading</td><td>Enter text to show a heading.</td></tr><tr><td>Text</td><td>Enter multiple lines of text.</td></tr><tr><td>Button link</td><td>Select or paste a URL for the button.</td></tr><tr><td>Button label</td><td>Enter text to display a button label. Leave this field blank to remove the button.</td></tr><tr><td>Button style</td><td>Choose a style for the button. Select <strong>Solid</strong>, <strong>Outline</strong>, or <strong>Text</strong>.</td></tr></tbody></table>

#### Background image

<table><thead><tr><th width="178">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Image</td><td>Select or upload an image to display as the background. There are no required image dimensions. We recommend a minimum width of 2500px.</td></tr><tr><td>Mobile image</td><td>Select or upload an image to display as the background of the banner on mobile devices. There are no required image dimensions. We recommend a minimum width of 1200px.</td></tr><tr><td>Image focal point</td><td>Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes.<br><br>You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our <a href="/pages/W1limMa3a6HViAgYU6Ns">Image settings guide</a>.</td></tr><tr><td>Mobile Image focal point</td><td>Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes.<br><br>You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our <a href="/pages/W1limMa3a6HViAgYU6Ns">Image settings guide</a>.</td></tr></tbody></table>

#### Color and overlay

<table><thead><tr><th width="197">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Text</td><td>Enter multiple lines of text.</td></tr><tr><td>Button</td><td>Select the color of the button background.</td></tr><tr><td>Solid button text</td><td>If the <strong>Solid</strong> button style is selected in the button block settings, select the color for the button text.</td></tr><tr><td>Background color</td><td>Select the color of the bar background.</td></tr><tr><td>Overlay</td><td>Select a color to overlay the image. This option helps provide contrast with text and headings to keep them clear and readable.</td></tr><tr><td>Overlay gradient</td><td>Add a color overlay that fades across a range of hues. You can choose the style, angle, position, and opacity of the gradient. See Shopify's <a href="https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients">color gradient guide</a> to learn more.</td></tr><tr><td>Overlay opacity</td><td>Use the slider to adjust the transparency of the overlay color. Set the opacity to 0% to turn off the overlay color. If set to 100%, the overlay will be opaque.</td></tr></tbody></table>

#### Section style

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Enable animation</td><td>Choose whether to display visual effects when scrolling, hovering, or interacting with the section.<br><br>See the <a href="/pages/x3Rlhb4LqJjyu0IhUpI3">Animation guide</a> to learn more.</td></tr><tr><td>Padding</td><td>Add a margin of space around the section to either the <strong>Top and bottom</strong>, <strong>Top only</strong>, <strong>Bottom only</strong>, or set it to <strong>None</strong>.</td></tr><tr><td>Enable full width</td><td>Display the banner at the full width of the screen or window.</td></tr></tbody></table>

\\

***

> **Related links**
>
> [Countdown banner](/stiletto/sections/theme-sections/countdown-banner.md)\
> [Countdown bar](/stiletto/sections/theme-sections/countdown-bar.md)\
> [Promotion banner](/stiletto/sections/theme-sections/promotion-banner.md)\
> [Sales banner](/stiletto/sections/theme-sections/sales-banner.md)


---

# 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://help.fluorescent.co/stiletto/sections/theme-sections/promotion-bar.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.