> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/extra-features/create-basic-banner.md).

# Create a basic banner

Build a basic banner from content elements, style the bar, add a close button or click-through link, and choose where it appears.

A basic banner is a bar you build from **content elements** — headings, messages, buttons, countdowns, images — grouped into one or more sections. The editor has two tabs: **Design** (content and styling) and **Placement** (where and to whom the bar appears).

{% stepper %}
{% step %}

## Open the Banners page

In your Shopify admin, open the **Sami Product Labels** app, click **Extra Features** in the app sidebar, then switch to the **Banners** tab.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-eac3346ef6817a452d1732ac53ec2f474f661bba%2Fimage_220.png?alt=media" alt="The Banners section in the app sidebar"><figcaption><p>Open Banners from the Sami Product Labels sidebar.</p></figcaption></figure>
{% endstep %}

{% step %}

## Click Create banners, then choose Basic

Click **Create banners**. In the **Select Type** dialog, click **Select** next to **Basic** — the type that supports single or multiple content groups.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-1a06c7b347d7948a62a0e6e1f64b84b7d165042a%2Fimage_221.png?alt=media" alt="The Select Type dialog with the Basic and Infinite Scroll options"><figcaption><p>Choose Basic to build a standard announcement bar.</p></figcaption></figure>

{% hint style="info" %}
Prefer not to start from scratch? On the Banners page, use **Featured templates** or **View all templates** to open a ready-made banner and edit it instead.
{% endhint %}
{% endstep %}

{% step %}

## Name the banner

The full-screen editor opens on the **Design** tab. Replace **New Banner** in the name field above the preview with a name of up to 50 characters. This name is internal — it identifies the banner in your list and is never shown to customers.

Next to the name you also get a language selector, desktop and mobile preview toggles, and the **Active** / **Draft** status switch.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-c47b5120de649208e8e70081bc87ceb2edfe8b6c%2Fimage_161.png?alt=media" alt="The banner editor toolbar with the name field, language selector, preview toggles, and Active/Draft switch"><figcaption><p>The toolbar above the preview holds the banner name, language, preview device, and status.</p></figcaption></figure>
{% endstep %}

{% step %}

## Build the content

Under **Content**, **Section 1** lists the elements that make up the bar. Click any element to edit its text and styling, drag the handle on the left to reorder, or use the icons on the right of a row to hide, duplicate, or delete it.

Click **Add element** to add a new one:

| Element        | What it adds                               |
| -------------- | ------------------------------------------ |
| **Message**    | A line of body text.                       |
| **Heading**    | A large headline.                          |
| **Line break** | Vertical spacing between elements.         |
| **Button**     | A call-to-action button with its own link. |
| **Countdown**  | A days / hours / minutes / seconds timer.  |
| **Image**      | An image or logo.                          |

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-f7e6bd3917e9c7a8c6fdbcbb43f1ce4d24fc3eb6%2Fimage_162.png?alt=media" alt="The Content panel listing the elements in Section 1 next to the live preview"><figcaption><p>Add, reorder, and edit the elements that make up the bar.</p></figcaption></figure>
{% endstep %}

{% step %}

## (Optional) Add more content groups

Click **Add Group** to create **Section 2**, **Section 3**, and so on. Each section is a separate message, and the banner rotates through them — control the timing under **Animation** in the next steps.

Leave a single section if you only want one static message.
{% endstep %}

{% step %}

## Style the bar

In the **Style** panel:

* **Background Type** — choose **Single Color**, **Gradient Color**, or **Pattern Image**, then set the color or image.
* **Font Style** — set the typeface, size, weight, and text color.
* **Padding** — control the spacing inside the bar.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-f51245c5e323270bd772bbe9bc49fa2cceb87d9b%2Fimage_163.png?alt=media" alt="The Style panel with Background Type, Font Style, and Padding options"><figcaption><p>Set the background, fonts, and padding for the whole bar.</p></figcaption></figure>
{% endstep %}

{% step %}

## Add a close button or make the bar clickable

Both options live in the **Button** panel and are off by default:

* Tick **Include Close Button** to place an "x" on the bar so customers can dismiss it. Two fields appear: **Color** and **Hover Color**.
* Tick **Bar Clickable** to make the whole bar a link. A **Link URL** field appears — enter the destination, and use the toggle beside it to open the link in a new tab.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-c25811a97a0809777aa1a2347705ee9b23e759c7%2Fimage_164.png?alt=media" alt="The Button panel with Include Close Button and Bar Clickable enabled"><figcaption><p>Enabling each checkbox reveals its settings — close button colors, or the link URL.</p></figcaption></figure>
{% endstep %}

{% step %}

## Set the animation timing

In the **Animation** panel, choose a **Horizontal** or **Vertical** transition, then set the timings in seconds:

| Field                            | What it controls                                         |
| -------------------------------- | -------------------------------------------------------- |
| **Disappear After**              | How long the bar stays on screen before hiding.          |
| **Interval Between Bar Display** | The gap before the bar reappears.                        |
| **Time For The Bar To Fade In**  | The length of the fade-in animation.                     |
| **Time Per Group**               | How long each section shows before rotating to the next. |

{% hint style="info" %}
Leave a field at `0` to disable that behaviour — for example, `Disappear After = 0` keeps the bar visible until the customer closes it.
{% endhint %}
{% endstep %}

{% step %}

## (Optional) Add custom CSS

Open **Advance Section** to write your own CSS in the **Custom CSS (Developer Zone)** box. The **CSS reference** list below it shows the available selectors — click one to insert it.
{% endstep %}

{% step %}

## Choose where the banner appears

Switch to the **Placement** tab and pick a display position:

| Position           | Behaviour                                              |
| ------------------ | ------------------------------------------------------ |
| **Top**            | Pushes page content down.                              |
| **Top Sticky**     | Pushes content down and stays visible while scrolling. |
| **Top Overlay**    | Overlaps the top of the page content.                  |
| **Overlay Sticky** | Overlaps content and stays visible while scrolling.    |
| **Bottom Sticky**  | Fixed at the bottom of the page.                       |
| **Custom**         | Place the bar anywhere using a shortcode.              |

Below the position picker, narrow the audience with **Product conditions**, **Customer conditions**, **Page conditions**, **Language conditions**, **Country conditions**, **Other conditions**, and **Visibility date**. The **Shortcode** panel gives you the snippet to paste into your theme when you choose **Custom**.

See [Configure display conditions](/extra-features/configure-display-conditions.md) for the full breakdown of each condition type.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-276b6300382bea138cefdd898e34393429e0a020%2Fimage_165.png?alt=media" alt="The Placement tab showing the six display positions and the condition panels"><figcaption><p>Pick a display position, then add conditions to control who sees the banner.</p></figcaption></figure>
{% endstep %}

{% step %}

## Save and activate

Set the status switch above the preview to **Active**, then click **Save** in the top-right corner. Leave it on **Draft** to keep working without publishing.

{% hint style="warning" %}
Banners only render on your storefront if the app embed is enabled in your theme. See [Enable the app in your theme](/getting-started/enable-app-in-theme.md).
{% endhint %}
{% endstep %}
{% endstepper %}

## Next steps

* [Configure display conditions](/extra-features/configure-display-conditions.md) — set up detailed targeting rules for your banner.
* [Create an infinite scroll banner](/extra-features/create-infinite-scroll-banner.md) — try a ticker-style scrolling bar instead.

{% hint style="success" %}
**Need support?**

If you run into any difficulty while following these steps, contact us at <support@samita.io>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.samita.io/extra-features/create-basic-banner.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.