> For the complete documentation index, see [llms.txt](https://bogos-guideline.gitbook.io/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/boosters/create-today-offer-block.md).

# Create Today Offer Block

The Today Offer Block is a block that you can embed in any page of your store to keep customers informed and engaged about your ongoing promotions.

You can choose to display all available offers (gifts, bundles, discounts), or just the ones you select, keeping customers informed and driving engagement with your ongoing promotions.

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

**Note:**&#x20;

* After setting up your Today Offer Block, you have to [**add it to your theme**](#add-block-to-your-theme) to make it appear on your storefront.
* You can create multiple blocks, each with different offers and color settings, and display them on different pages.

{% embed url="<https://youtu.be/ykj6ujX5j9Q?si=8B904veHO7Ckn1OZ&t=221>" %}

## Set up Offer List

### 1. General

First, fill in the General information for your widget:

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

**Booster name:** Edit the name of your Today Offer block for internal use only. This helps you manage it easily within the system and won’t be visible to customers.

**Booster title:** Edit the name of your Today Offer block that will be visible to customers.

**Booster subtitle (optional):** Add an optional description below the block title, used to provide additional context or details for the offer.

### 2. Offer Card

<figure><img src="/files/9D5foBmx4WGL7tTEm7WJ" alt=""><figcaption></figcaption></figure>

First, decide on the **offer card layout** for your Today Offer block. You can choose between:

* **Thumbnail:** Displays the offer with a product thumbnail.
* **Product Preview:** Allows customers to preview the products included in your offer.

Then, choose which offers to display on your block 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 block.
* **Manually select:** Display only specific offers you select. If you pick deactivated offers, the block will only show them when they are activated.

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

In **Customize offer display**, click "Edit offer display" to edit each offer's content 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 block.
3. Add a redirect link: When customers click on that button, they’ll be redirected to the page you link to (a product page, collection page,...). You can also edit the button text.
4. The last option will appear differently depending on the card style you choose above:

▶ **If you choose “Thumbnail”**, you can choose a thumbnail for your offer with 3 options below:

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

* **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 choose “Product preview”**, you can edit the “Product list label”, which will show a label above the product list.

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

**Note:** 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.

### 3. Content

<figure><img src="/files/88qTI1yCjQQOHfbqni7h" alt=""><figcaption></figcaption></figure>

To attract customers' attention and provide more details about the promotion, you can:

* **Show offer description:** Displays a brief description of the offer under the title (e.g., "Best products selected for you").
* **Show label in product list** (only for "product preview"): Shows a label above the product list (e.g., "Buy at least 2 items from the bundle").

## Set up Block Style

### 1. Layout

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

**On desktop**, you can choose either of two display layouts:

* 2 offers per row
* 3 offers per row

**On mobile**, the block will automatically show 1 offer per row.

### 2. Color

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

Here, you can easily customize the colors of all the block elements to match your store’s branding. There are 3 options:

* **Block:** Change the overall color of the Today Offer block.
* **Offer card:** Adjust the color of the offer card that shows the details of each offer.
* **Button:** If you set a redirect link for your offers, you can customize the button color.

Feel free to play around with these settings and see the live results!

## Add Block To Your Theme

After setting up your Today Offer block, follow these steps to make it **show up on your store**:

1. **Online Store > Customize**
2. **Go to any page** where you want the block to appear (Home page, Cart page, Product page, Collection page).
3. Click **“Add section”** > **Apps** > Find **“BOGOS: Today Offer Block”**.

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

4. **Drag and drop** the block wherever you want it.
5. **To choose which block to display** if you want to show only one, instead of displaying all blocks by default, follow these steps:

Go back to the Today Offer block setup in the BOGOS app > **Copy the block’s ID** (e.g., 53).

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

\> Navigate to your theme editor&#x20;

\> Click on the Today Offer block > Paste the ID into the “Booster ID” field (e.g., 53).

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

## FAQs

<details>

<summary><strong>How to add the Today Offer block to my Shopify theme?</strong></summary>

In BOGOS app, please create & save your Today Offer Block (choose offers, layout, colors) first. Then, follow the steps below:

Step 1: In Shopify admin go to Online Store → Themes → Customize.

Step 2: Open the page where you want it (Home, Product, Collection, Cart, etc.).

Step 3: In the left sidebar, click “Add section” → Apps → select “BOGOS: Today Offer Block”.

<div align="left"><img src="/files/PsL5FQbO4slmLPkMVnsA" alt="" height="456" width="165"></div>

<div align="left"><img src="/files/tMqBg9Pc6YiDD0yyJuE2" alt="" height="380" width="366"></div>

Step 4: Drag it to the desired position and click Save.

<div align="left"><img src="/files/mUZBRnsdjo2rQrjeNw7z" alt="" height="379" width="240"></div>

In case you want to show only one specific block

* Back in BOGOS, copy that block’s ID (e.g. 53).
* Return to the theme editor, click the Today Offer Block section, paste the ID into the “Booster ID” field, then Save.

<div align="left"><img src="/files/4k8Rd4fnARYlz1CDqXRT" alt="" height="258" width="265"></div>

**How to find the Booster ID?**

Step 1: Open the BOGOS app in your Shopify admin.

<div align="left"><img src="/files/OuFbrd2dWiChWRkyLLRg" alt="" height="256" width="194"></div>

Step 2: Go to Boosters > Today Offer block you want to show

<div align="left"><img src="/files/m2XGkElnjgpyfrn68FHE" alt="" height="112" width="485"></div>

Step 3: Look at your browser URL—the numeric value at the very end is the ID

<div align="left"><img src="/files/CRlUDLBlGJuMIvXk6K6X" alt="" height="171" width="496"></div>

</details>

<details>

<summary><strong>How to customize the image of the gift product on the Today offer Block?</strong></summary>

The image of the Today Offer block is set according to the image of the first product selected in the offer. If you want to change the image, please follow the steps below:

Step 1: Open BOGOS app → Boosters > Today Offer Block.

<div align="left"><img src="/files/rZftja29tC91FoV9WpPO" alt="" height="178" width="530"></div>

Step 2: Open the Today offer Block you want to adjust image. In your block, go to **Offer Card** and make sure layout = **Thumbnail.**

<div align="left"><img src="/files/K8EUv0s5PCs39ZvwQi5u" alt="" height="295" width="411"></div>

Step 3: Under **Customize offer display**, click **Edit offer display.**

<div align="left"><img src="/files/u5Td4BWo6GSRZ9pfyJ7l" alt="" height="435" width="282"></div>

Step 4: Select the offer you want → in the thumbnail section choose:

<div align="left"><img src="/files/cesXjfqFm8PUnQu7Troi" alt="" height="363" width="609"></div>

* **One Product Image** or **Product Image Group**, then pick the product(s), or
* **Custom Image** and upload your own.  &#x20;

Step 5: Save the block, then refresh your storefront to see the new image.&#x20;

{% hint style="warning" %}
Note: If you don’t edit the offer display, BOGOS will auto‑pick a product image for you.
{% endhint %}

</details>

<details>

<summary><strong>When my offer is deactivated or expires, will it automatically hide on the Today Offer Block?</strong></summary>

Yes. The Today Offer Block only shows active offers. Please note that:

* Deactivated or expired offers are automatically hidden from the block on your storefront.
* If you manually selected offers, they’ll still be listed in the block setup, but won’t display to customers until you activate them again

</details>


---

# 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://bogos-guideline.gitbook.io/user-guide/detailed-guide/boosters/create-today-offer-block.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.