> For the complete documentation index, see [llms.txt](https://docs.bogos.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bogos.io/detailed-guide/boosters/create-today-offer-widget.md).
# Create Today Offer Widget
The Today Offer widget is a floating icon that appears on your storefront to grab customers' attention and notify them about your current deals.
You can display all available offers (gifts, bundles, discounts) or only the ones you select, keeping customers informed and driving engagement with your ongoing promotions.
{% hint style="warning" %}
* You can only create 1 Today Offer widget.
* The Today Offer widget will only display active offers. If you deactivate any offers, they will automatically disappear from the widget.
* If you're using the old version, located in the "Customize" field, please deactivate it first before using this new version.
{% endhint %}
{% embed url="" %}
Setting up a Today Offer widget with BOGOS includes 4 steps:
1. On the Menu, open Boosters > Create booster > Today Offer Widget.
2. Set up Content.
3. Set up Style.
4. Publish and set the widget's page display.
### 1. Set up Content
#### a) General
First, fill in the General information for your widget:
* **Booster name:** Edit the name of your Today Offer widget for internal use only. This helps you manage it easily within the system and won't be visible to customers.
* **Booster title:** Edit the title of your Today Offer widget that will be visible to customers.
* **Booster subtitle (optional):** Add an optional description below the widget title, used to provide additional context or details for the offer.
#### b) Offer list
First, choose which offers to display on your widget using 1 of these 2 methods:
* **Automatically select:** Display all your active **Gifts**, **Bundles**, and **Discounts**. You can also untick any offer type if you want to exclude it from your widget.
* **Manually select:** Display only specific offers you select. If you pick deactivated offers, the widget will only show them when they are activated.
Then, decide on the Offer card layout for your Today Offer widget:
* **Thumbnail:** Displays the offer with a product thumbnail.
* **Product preview:** Allows customers to preview the products included in your offer.
In Show on cards, the options depend on the Offer card layout you chose above:
* If you chose **Thumbnail**, tick **Offer description** to display a brief description of the offer under the title (e.g., "Best products selected for you").
* If you chose **Product preview**, you can tick:
* **Offer description:** Display a brief description of the offer under the title.
* **Label in product list:** Show a label above the product list (e.g., "Choose 1 gift(s) from").
In **Customize each offer display**, click **"Edit offer display"** to edit each offer's content, add a redirect button, badges, and choose which product to preview.
Follow these steps:
1. Select the offer you want to edit.
2. Edit its **Title** and **Description** that will be shown to customers on the Today Offer widget. Click Reset to default text if you want to restore the original wording.
3. **Add a redirect button (optional):** Tick to enable, then edit the button text and paste the redirect URL. When customers click the button, they'll be redirected to the page you link to (a product page, collection page, etc.).
4. **Offer highlight badge (optional):** Tick to enable, then enter the badge text (e.g., "10% OFF") to highlight the offer on the card.
5. **Offer timer (optional):** Tick to enable a countdown badge on the offer card. Then choose one:
* **Countdown to offer's end time:** The timer counts down to the offer's scheduled end time.
* **Set a custom duration:** You set the countdown length yourself.
{% hint style="warning" %}
If the selected offer doesn't have an end time set, the countdown won't appear. In that case, use Set a custom duration instead, or add an end time to the offer. Then, choose When countdown ends:
* Hide the timer when it ends (recommended): The timer disappears but the offer stays visible.
* Hide the whole offer when it ends: The entire offer is removed from the widget.
{% endhint %}
6. The last option depends on the Offer card layout you chose above:
▶ If you chose **"Thumbnail"**, set a thumbnail for your offer with 3 options:
* **One product image:** Select one product to show as the offer thumbnail.
* **Product image group:** Choose up to 4 products to show as the offer thumbnail.
* **Custom image:** Select from available icons or upload your own image. We recommend using .jpg or .png files with a maximum size of 100 KB for fast loading.
▶ If you chose **"Product preview"**, edit the **Product list label**, which will show above the product list (e.g., "Buy at least 2 items from the bundle").
{% hint style="warning" %}
If you don't edit the offer display, BOGOS will display the offer name (you set up when creating offers) as the title, and randomly select a product for the image preview.
{% endhint %}
### 2. Set up Style
#### a) Widget icon
Customize how the widget icon appears on your storefront:
* **Widget style:** Choose to show Only icon, or display both the icon and title text. If you choose to show text, you can customize it in the Widget title text field.
* **Widget position:** Place the widget in one of 4 positions on your store: Bottom left, Bottom right, Middle left, or Middle right.
* **Select icon:** Choose the icon for your Today Offer widget from a set of default BOGOS icons, or upload your own custom icon.
* **Widget size:** Drag the slider to adjust the icon size.
* **Padding:** Drag the slider to adjust the padding around the icon.
#### b) Open widget
Choose how the widget content opens when customers click the icon:
* **Popover:** Content expands in a small overlay near the widget icon.
* **Modal:** Content opens in a centered overlay on the page. When Modal is selected, two extra options appear:
* **Automatically open modal:** The modal opens automatically when the page loads, without requiring customers to click the icon.
* **Offers per row:** Set how many offers display per row inside the modal.
* **Desktop:** 2 or 3.
* **Mobile:** The widget will automatically show 1 offer per row.
#### c) Color
Here, you can easily customize the colors of all the widget elements to match your store's branding:
* **Widget color:** Adjust the Widget title, Widget description, Header color, and List background.
* **Offer card:** Adjust the Offer title, Offer description, Offer card color, and Dashed line color.
* **Button:** If you set a redirect link for your offers, customize the Button color and Button text color.
* **Notification dot:** Adjust the Dot color and Dot text color. The notification dot shows how many active deals are available on your store.
* **Add-on:** Customize badge colors for offers.
* **Offer highlight badge:** Badge color and Badge text color.
* **Offer timer badge:** Badge color and Badge text color.
### 3. Publish and Set Page Display
After setting up **Content** and **Style**, click **Publish** to save your Today Offer widget. Once published, the widget will appear on your storefront automatically.
In the **Placement** tab, you can choose where the widget shows up:
* **Show on all pages:** Displays the widget across your entire store.
* **Show on specific pages:** Tick the pages where you want the widget to appear (you can choose multiple pages):
* **Home page:** Show the widget on your homepage.
* **Cart page:** Show the widget on the cart page.
* **Product page:** Show the widget on all product pages.
* **Collection page:** Show the widget on all collection pages.
* **Custom page:** Show or hide the widget on specific pages. There are 4 options to choose from:
* **Equal to:** Enter the exact URL where you want the widget to show (a link to a specific collection, a specific product page, etc.). Example:
* **Not equal to:** Enter the URL where you do NOT want the widget to show.
* **Contains:** Enter a term. The widget will show only on pages with that term in the URL. Example: "summer-sale".
* **Not contains:** Enter a term to hide the widget on pages with that term in the URL.
### Need Help?
If you need any assistance, feel free to reach out to our customer support team via live chat within our BOGOS app.
## FAQs
How to show all gift products in the Today Offer widget?
To show all your gift offers inside the Today Offer widget:
1. Go to BOGOS app → Booster → Today Offer (widget).
2. In Offer Card → choose card layout (Thumbnail or Product preview).
3. Under “Choose which offers to display”, select **Automatically select** and keep **Gifts** (and any other types you want) checked.
4. Make sure all the relevant gift offers are **Active** so they appear in the widget.
The widget will then list all active gift offers (with their gifts previewed, depending on the layout).
How to add a clickable link/button to the Today Offer widget?
To add a clickable link/button to the Today Offer widget:
1. Open Booster > Today Offer (widget) > Offer List.
2. In “Customize offer display”, click **Edit offer display**.
3. Select the specific offer card you want to edit.
4. In the settings for that offer, find Add a redirect link:
* Paste your target URL (product, collection, landing page, etc.).
* Edit the button text if needed (e.g., “Shop now”, “View offer”).
5. Save your changes; the button will now appear inside that offer’s card on the Today Offer widget.
How to translate the texts on the Today Offer on another language site?
{% hint style="warning" %}
Note: Product names shown inside the widget come from your products and may not be translatable via BOGOS (handled by your store/translation app instead).
{% endhint %}
In order to change the language of today offer, please go to Translation section in our app and then add the language translation > choose Today offer to translate.
---
# 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.bogos.io/detailed-guide/boosters/create-today-offer-widget.md?ask=&goal=
```
`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.
