> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/sections/banners/scrolling-promotion.md).

# Scrolling promotion

A continuously scrolling ticker bar with text, images, and links. Configurable speed, direction, and hover pause for promotional messages.

A moving ticker of text and images — the fastest way to put a time-sensitive message in front of every visitor. It is the go-to strip for limited-time offers, free-shipping thresholds, new drops, event countdowns and press mentions, and it sits comfortably above or below any section.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2Fhv3sEOP1QvMiEJY0VF7q%2Fscrolling_promotion.gif?alt=media&amp;token=dd905e4d-827d-46fc-b55c-c156d3add1cf" alt=""><figcaption></figcaption></figure>

### How to add

{% stepper %}
{% step %}

#### Add the section

In the theme editor, click **Add section → Scrolling promotion**.
{% endstep %}

{% step %}

#### Add your items

Click **Add block → Text** for each message, or **Context image** for a standalone logo, badge or icon. Mix the two freely — they ride in the same loop.
{% endstep %}

{% step %}

#### Write a shorter mobile version

Every **Text** block has a **Mobile text** field. Use it to swap long desktop copy for something that fits a phone.
{% endstep %}

{% step %}

#### Set the motion

**Direction** is **Right to left** (default) or **Left to right**. **Speed** is the time it takes the strip to shift by 100 pixels, from 0.5 to 2.5 seconds — a *higher* number means *slower* movement.
{% endstep %}

{% step %}

#### Set the spacing and the frame

**Gap between items** runs from 24 to 160 px (48 by default). **Line** adds a divider — **Top**, **Bottom**, **Both** or **Disable** — with its own padding.
{% endstep %}
{% endstepper %}

<div align="center"><figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FZgzacJ5apWzb1rgqM28E%2FGroup%202%20(1).png?alt=media&amp;token=b3ba86e9-0230-4157-b5e8-383242e96902" alt=""><figcaption></figcaption></figure></div>

### Good to know

**Speed is a duration, not a rate.** The setting is the time taken to move 100 pixels, so turning it up slows the ticker down. If the strip is moving too fast to read, raise the number.

**Two block types, one loop.** A **Text** block is a message, with an optional inline image and link; a **Context image** block is a standalone logo or badge with its own width, ratio, corner radius and link.

**Clean until hover.** Turn on **Show image on hover** and the inline images stay hidden, so the ticker reads as pure text until a visitor engages.

**The ticker pauses on hover**, so a visitor can read — or click — a message without it scrolling away.

{% hint style="success" icon="sparkles" %}
This section animates with the TweenMax (GSAP) library, which can slightly affect store performance. Keep the number of items and images modest.
{% endhint %}

**Right-to-left stores.** The ticker respects the store's text direction. See [RTL support](https://staylime.com/docs/avante-themes/features-and-advanced-setup/rtl-support.md).

### Customization ideas

* Alternate **Text** and **Context image** blocks to build an “as seen in” press strip under the hero.
* Put one message in the loop and let the gap do the work — a single repeating line reads as a banner rather than a ticker.
* Use a contrasting color scheme and a **Both** line to set the strip apart from the sections around it.
* Add the section directly under the header on every template for a free-shipping threshold that follows visitors around the store.
* Link each **Text** block to the collection it advertises so the strip is navigation as well as decoration.

### Best practices

* Keep each message to a few punchy words — a ticker rewards brevity over full sentences.
* Match **Speed** to intent: slower for an offer people need to read, faster for a decorative brand loop.
* Fill in **Mobile text** whenever the desktop copy runs longer than about five words.
* Use one ticker per page. Two competing strips cancel each other out.

***

### Related

* [Banners overview](https://staylime.com/docs/avante-themes/sections/banners.md)
* [Horizontal scrolling banners](https://staylime.com/docs/avante-themes/sections/banners/horizontal-scrolling-banners.md)
* [RTL support](https://staylime.com/docs/avante-themes/features-and-advanced-setup/rtl-support.md)
* [Common section settings](https://staylime.com/docs/avante-themes/sections/overview.md#common-section-settings)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/sections/banners/scrolling-promotion.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
