For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configure banner display conditions

Control where each banner appears and who sees it, using the position picker and the condition panels on the Placement tab.

The Placement tab of the banner editor controls two things: where the bar sits on the page, and who sees it. Both banner types — basic and infinite scroll — use the same tab.

Open the Placement tab

While creating or editing a banner in Sami Product Labels, click Placement at the top of the left panel.

The Placement tab showing the six display positions and the condition panels
The Placement tab: a position picker at the top, condition panels below.

Choose a display position

Position is the first panel, and it is required — every banner has one.

Position
Behaviour

Top

Sits above your page content and pushes it down.

Top Sticky

Pushes content down and stays visible while the customer scrolls.

Top Overlay

Overlaps the top of your page content instead of pushing it.

Overlay Sticky

Overlaps content and stays visible while the customer scrolls.

Bottom Sticky

Fixed to the bottom of the viewport.

Custom

Renders nowhere by default — you place it yourself with the shortcode. See Shortcode placement.

Condition panels

Everything below the position picker is optional. Leave a panel empty and it places no restriction — the banner shows to everyone, everywhere the position allows.

Product conditions

Restrict the banner to products that match a rule. Click Add conditions, then build a row from three parts: a field, an operator (is equal to / is not equal to), and a value.

Field
Value you pick

Select Products

Individual products from your catalog.

Product tag

One or more product tags.

Product compare price

A compare-at price, for targeting discounted items.

Collections

One or more collections.

Use the delete icon at the end of a row to remove it, and Add conditions again to stack more rows.

Product tag conditions require the GOLD plan or above.

Match all conditions or any condition

When a panel holds more than one row, the Products must match radio decides how they combine:

  • all conditions — every row must be true (AND). For example, a product tagged sale and in the Clearance collection.

  • any condition — one row is enough (OR). For example, a product tagged sale or in the Clearance collection.

The Products must match radio with all conditions and any condition options
Switch between AND and OR logic for the rows in a panel.

See Condition operators reference for the full behaviour of each operator.

Customer conditions

Restrict the banner by who is browsing. Click Add conditions, then choose a field:

Field
Options

Customer

Is Logged In or Not Logged In.

Customer tag

Match one or more customer tags.

Customer tag conditions require the GOLD plan or above.

Page conditions

Restrict the banner to certain page types. Each row is Page + an operator + a page type:

Page type
Where it applies

Index page

Your store's home page.

Collection page

Pages listing the products in a collection.

Product page

Individual product detail pages.

Article Page

Blog article pages.

Blog page

Blog listing pages.

Cart page

The shopping cart page, including the cart drawer.

Search page

Search results.

Specific pages

Any other page, matched by the URL you enter.

There is no "all pages" option — leaving Page conditions empty is what shows the banner everywhere.

Language conditions

Switch the panel on with its toggle, choose an OperatorEquals or Not equals — then search for and select your store's languages. The banner shows only when the customer's active language matches.

Language targeting requires the DIAMOND plan. On other plans, banners display for all languages.

Country conditions

Switch the panel on with its toggle, pick an OperatorEquals or Not equals — then search for and select countries. Useful for region-specific shipping or promotional messages.

Other conditions

Holds a single Device targeting setting: All devices, Desktop, or Mobile.

Visibility date

Schedule the banner with a Start and an End date and time, both in YYYY-MM-DD HH:mm format. Leave a field empty to leave that end of the window open — set only End, for example, to run a banner until a sale finishes.

Shortcode placement

Choose the Custom position when you need the banner at an exact spot in your theme rather than pinned to the top or bottom of the page.

1

Copy the shortcode

Open the Shortcode panel at the bottom of the Placement tab and click Copy. The snippet looks like this:

You can also copy it from the Shortcode column on the banners list.

2

Paste it into your theme

In Shopify admin, go to Online Store > Themes > Edit code and paste the snippet into the Liquid template — or into a Custom HTML section — at the position where the banner should appear.

Only use the shortcode when you need exact placement. For everything else, one of the five built-in positions is enough on its own.

Tips for effective targeting

  • Start broad, then narrow. Pick the position first, confirm the banner shows, and only then add conditions.

  • Remember that panels combine. Conditions in different panels must all pass — a product condition plus a page condition means both have to match.

  • Check both devices. Use the mobile preview toggle above the editor, and set Device targeting if a message only makes sense on one.

  • Test on your storefront. Activate the banner and load the affected pages to confirm it appears where you expect.

Next steps

Last updated

Was this helpful?