Promotion banner

Theme section

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.

See the Promotion bar section for a more compact promotional section. See the Sales banner for a similar section with a prominent sales price.

Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or insert dynamic content with metafields

STEPS

In your theme editor (Customize):

1. Select a Template to edit from the dropdown menu in the top bar.

   Learn how to use templates in our Templates guide.

2. Under Template, click (+) Add section and select Promotion banner.

3. Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.

Add headings and text

The Promotion banner has two columns for promotional headings and text. Customize the text content alignment and font size.

STEPS

In your theme editor (Customize):

1. Click on the Promotion banner section to open the settings.

   
2. Enter Big text to display in the Left Column as a section title.

   We recommend a short title of 1 to 3 words.

   Adjust the Font size (40px - 100px) and Text alignment (Left, Center, or Right) of the big text.

3. Enter Heading text to display in the Right column.

   we recommend one to three words.

   Set the Heading size from Small, Medium, or Large.

4. Use the Column width slider to set how wide the Left column should span within the section. The Right column will span the remaining width of the section.

5. Enter Text to display beneath the heading.

   We recommend two to three short sentences. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide ↗.

   Set the Text alignment to Left, Center, or Right.

6. Click Save.

Add buttons

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

STEPS

In your theme editor (Customize):

1. Click on the Promotion banner 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?"

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.

Add background image

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

STEPS

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 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 ↗ to learn more.

7. Click Save.

Section style

Adjust the section Height, choose whether to show the banner Frame (border), enable Full width, customize section colors, and adjust the Padding of the section.

STEPS

In your theme editor (Customize):

1. Click on the Promotion banner section and scroll down to the Section style settings.

2. Use the Height and Mobile Height sliders to adjust the height of the entire banner.

   Choose between 200 - 800px on desktop and 300 - 800px on 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 when matching colors to make sure your text is clear and readable for everyone.

4. Choose to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.

   Learn more about Section animations in Stiletto.

5. Uncheck the Show frame option to hide the thin border line within the banner.

6. Check the Enable full width option to span the banner across the whole window or screen, removing the margins on either side.

7. Select a Padding option to change the spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.

8. Click Save.

Settings reference

Click the Promotion banner section to find the following settings.

Banner

Setting	Description
Height	Change the height of the banner for desktop screens: between 200 and 800 pixels.
Mobile height	Change the height of the banner for mobile screens: between 300 and 800 pixels.

Left column

Setting	Description
Column width	Set how wide the column should span within the section. The right column will adapt to fill the remaining area.
Big text	Enter text to display a large title.
Font size	Change the font size to Small, Medium, or Large.
Mobile font size	Change the font size to Small, Medium, or Large.
Text alignment	Position the 'Big text' to the Left, Right, or Center.
Mobile text alignment	Position the text and headings to the Left, Right, or Center.

Right column

Setting	Description
Heading	Enter text to show a heading.
Heading size	Change the font size of the heading to Small, Medium, or Large.
Text	Enter text to add additional information about the promotion.
Text alignment	Position the text and headings to the Left, Right, or Center.
Mobile text alignment	Position the text and headings to the Left, Right, or Center.
Button link	Select or paste a URL for the button.
Button label	Enter text to display a button label. Leave this field blank to remove the button.
Button style	Choose a style for the button. Select Solid, Outline, or Text.

Background image

Setting	Description
Image	Select or upload an image to display as the background. There are no required image dimensions. We recommend a minimum width of 2500px.
Mobile image	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.
Image focal point	Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes. You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our Image settings guide.
Mobile Image focal point	Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes. You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our Image settings guide.

Color and overlay

Setting	Description
Text	Enter multiple lines of text.
Button	Select the color of the button background.
Solid button text	If the Solid button style is selected in the button block settings, select the color for the button text.
Background color	Select the color of the banner background.
Overlay	Select a color to overlay the image. This option helps provide contrast with text and headings to keep them clear and readable.
Overlay gradient	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 ↗ to learn more.
Overlay opacity	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.

Section style

Setting	Description
Enable animation	Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See the Animation guide to learn more.
Show frame	Display a thin border line within the section.
Padding	Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.
Enable full width	Display the banner at the full width of the screen or window.

---

Related links

Countdown banner Countdown bar Promotion bar Sales banner