> For the complete documentation index, see [llms.txt](https://uxsmart.gitbook.io/velare/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uxsmart.gitbook.io/velare/customize-your-pages/overlay-group/discount-popup.md).

# Discount popup

The **Discount popup** appears once immediately after a customer successfully creates an account. It can appear on any page where the registration is completed and does not use a configurable delay.

Use it to welcome newly registered customers, display a promotional message, share a discount code, and direct them to a selected collection or landing page. The popup remains open until the customer clicks outside it to close it.

This popup is triggered by successful account registration. The [**Newsletter popup**](/velare/customize-your-pages/overlay-group/newsletter-popup.md) collects email addresses, the [**Before You Leave**](/velare/customize-your-pages/overlay-group/before-you-leave.md) popup appears after its configured delay, and the [**Offers popup**](/velare/customize-your-pages/overlay-group/offers-popup.md) opens when a shopper clicks the offer icon in the header.

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

### Where to find it <a href="#where-to-find-it" id="where-to-find-it"></a>

{% hint style="success" %}
**Steps:**

1. Go to **Online Store > Themes > Customize**.
2. In the left sidebar, open the **Overlay** group.
3. Click **Discount popup**.
4. Upload the banner image, then fill in the subheading, heading, description, and the promo link and button label.
   {% endhint %}

*Result:* the popup preview opens in the editor with your campaign content and button.

### General settings <a href="#general-settings" id="general-settings"></a>

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

| Setting                    | Description                                                                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Width**                  | How much of the screen the popup covers. **Full width** stretches it edge to edge for a loud campaign, **Auto** keeps the window no wider than its own content. |
| **Banner image**           | The picture shoppers see beside the offer text. Use the campaign artwork so the popup looks like the sale page it links to.                                     |
| **Image width**            | How much of the popup that picture takes up. Lower it when the offer text needs more room to be read.                                                           |
| **Desktop image position** | Which side the picture sits on when the popup opens on a computer. **Left** puts the artwork first, **Right** lets shoppers read the offer first.               |
| **Subheading**             | A short line above the headline, useful for the campaign name or a deadline such as *Ends Sunday*.                                                              |
| **Heading**                | The biggest line in the popup and the first thing shoppers read, so state the offer itself, for example *30% off everything*.                                   |
| **Description**            | One or two sentences under the headline carrying the detail the offer needs, such as what it covers or when it stops.                                           |
| **Promoto link**           | Where the button sends shoppers. Point it at the collection or landing page that fulfils the offer, otherwise the popup leads nowhere.                          |
| **Promoto button label**   | The words on the button. Name the destination, for example *Shop the sale*, instead of a vague *Click here*.                                                    |

### What changes on the storefront <a href="#what-changes" id="what-changes"></a>

* The popup covers the page with your campaign message until the shopper closes it or clicks the button.
* The button is the only exit that leads somewhere, so a broken or empty **Promoto link** wastes the whole popup. Check it every time the campaign changes.

### Related pages <a href="#related-pages" id="related-pages"></a>

* [Overlay group](/velare/customize-your-pages/overlay-group.md): the other panels and popups
* [Newsletter popup](/velare/customize-your-pages/overlay-group/newsletter-popup.md): the signup popup, if your goal is collecting emails
* [Before you leave](/velare/customize-your-pages/overlay-group/before-you-leave.md): the exit-intent popup, which also carries a discount code
* [Offers popup](/velare/customize-your-pages/overlay-group/offers-popup.md): the popup opened from the header offer icon


---

# 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://uxsmart.gitbook.io/velare/customize-your-pages/overlay-group/discount-popup.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.