# Free shipping message

Displays a dynamic message showing how close a customer is to earning free shipping.

<figure><img src="/files/yA7LIwI5PY2XElRkFBIh" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="181.40020751953125">Settings</th><th width="150.3046875" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Show progress wheel</td><td align="center"><code>checkbox</code></td><td>Visually displays progress toward free shipping.</td></tr><tr><td>Message</td><td align="center"><code>textarea</code></td><td>Use <code>||amount||</code>to display progress towards free shipping.</td></tr></tbody></table>

&#x20;Learn more about Broadcast's target settings:

{% embed url="<https://broadcast.presidiocreative.com/header/announcement-bar-settings/target-settings>" %}

The wheel fills up, and the value changes as items are added to the cart.&#x20;

{% hint style="success" %}
Use to encourage add-on sales and increased quantities.&#x20;
{% endhint %}

### 1. Add the Block

Navigate to Theme editor -> Announcement bar -> Add block -> Free shipping message.

This creates a new block to display free shipping progress.

### 2. Configure the Message

* **Progress wheel**: Toggle Show progress wheel to display a circular visual indicator of progress toward the free shipping threshold.

<figure><img src="/files/Lzko5GzUn8vOE7JdQRcH" alt=""><figcaption></figcaption></figure>

* **Message text:** Enter the message customers will see. Use the placeholder `||amount||` to dynamically display how much more the customer needs to spend to qualify for free shipping.

> Example: `You are ||amount|| away from free shipping.`

<figure><img src="/files/oJyLDbCD3u6qxbnuQJSJ" alt=""><figcaption></figcaption></figure>

### **3. Set Free Shipping Amount**

* Go to **Theme settings -> Cart ->** [**Free shipping**](/theme-settings/theme-settings/cart.md#free-shipping-limit-and-lock-icon).
* Enter the minimum spend amount required for free shipping.
* **Tip:** Use only numbers (e.g., `200`) without currency symbols, letters, or decimals.


---

# 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://broadcast.presidiocreative.com/header/announcement-bar-settings/free-shipping-message.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.
