> 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/customize/customize-gift-slider.md).

# Customize Gift slider

Customize Gift Slider is designed to help you adjust the text, colors, layout, and product display of your gift slider. The slider displays all the gift products that customers are eligible to receive and will appear when customers meet the conditions of the offers.

{% embed url="<https://youtu.be/Qh_bjkchzpo>" %}

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

## 1. Customization options <a href="#h.7t9zvvzdp0pq" id="h.7t9zvvzdp0pq"></a>

### 1.1. General <a href="#h.3qozp25yjgx2" id="h.3qozp25yjgx2"></a>

**Gift display:** Gift display let you control how free gifts will be presented to your customers. There are two main option for you to choose.

* By products: Show gifts as individual products, with variants grouped under each product.

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

* By variants: Display each variant (like size or color) as a separate gift choice.

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

**Grouping**: Grouping controls how free gifts are organized and displayed when multiple offers are active.

* Show gifts by offers: Gifts are grouped based on the offer they belong to, useful when multiple promotions run at once.

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

* Show all gifts at once: All eligible gifts appear in a single list for quicker browsing.

<figure><img src="/files/2RcBGWIMM0bhmLMBNda4" alt=""><figcaption></figcaption></figure>

**Products per row**: Adjust how many gift items appear in one row to ensure a clean layout.

### 1.2. Advanced <a href="#h.4iowmdam2shk" id="h.4iowmdam2shk"></a>

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

**Product display**: This lets you set up how gift products are visually presented, helping customers better interact with the gift offer.

* Show product title: Display the main product name.
* Show variant title: Show the variant name (e.g., size, color)

**Additional display**: Improve clarity and user navigation with optional display enhancements.

* Show number of gifts can be added: Let customers see how many gift items they can select within the offer.
* Show pagination: Add pagination when there are various gift items, keeping the display neat.

**Switch to disable slider**: This checkbox lets customers temporarily disable the slider. Set the time duration in minutes.

**Allow adding multiple gift**: Enable customers to select more than one gift.

### 1.3. Page Display <a href="#h.xshwd5hzjfmm" id="h.xshwd5hzjfmm"></a>

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

**Show on all pages**: Display the offer widget across your entire store site.

**Show on specific pages**: Choose exactly where the offer will be displayed

* Homepage
* Cart page
* Product page
* Collection page
* Custom page

### 1.4. Text <a href="#h.fyb024kjj98l" id="h.fyb024kjj98l"></a>

<figure><img src="/files/7gFgqbvHnl3jpZtmrbcw" alt=""><figcaption></figcaption></figure>

* **Gift slider title**: This is the headline that appears at the top of the gift slider window.
* **Add to cart button**: Name of add to cart button.
* **Disable slider text**: The name of a checkbox that lets customers disable the gift slider and not show it again for a few minutes.

### 1.5. Color  <a href="#h.ajm0shjqjvk8" id="h.ajm0shjqjvk8"></a>

BOGOS allows you to customize the colors of all elements with any of the 4 methods below:

* Choose a **ready-made color set** from the dropdown.
* **Manually adjust** each color field for all the available colors.
* Use [AI Theme Detector](#ai-theme-detector) to auto-generate a full widget color palette based on your store's branding.
* **Contact the BOGOS support team** to get help with color customization.

Click **Save** when done.

#### AI Theme Detector

BOGOS AI scans your online store and detects your brand's primary, secondary, and text colors, then generates a full widget color palette automatically.

{% hint style="warning" %}
Your store must NOT be password-protected for AI to access and detect your brand colors.
{% endhint %}

To edit the colors with BOGOS AI:

1. Click the **pen icon**.

![](/files/8HMgW0p6Hvadbsq4mpf0)

2. Click **Scan again** to let BOGOS AI re-detect, or **manually adjust** the Primary color, Secondary color, or Text fields.

![](/files/wr4WVSAsv8yHcB3JKixf)

3. Click **Apply** for preview to apply the colors to the widget preview.

### 1.6. Embedded Gift Slider into a Product Page <a href="#h.bqt56rm4ft9m" id="h.bqt56rm4ft9m"></a>

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

If you don't want to use the gift slider as a pop-up, click Open theme editor to customize your preferred display option (available on Homepage, Collection, Product, and Cart pages only). &#x20;

* **Step 1**: In the Theme Editor window, navigate to the block you want to add the Gift slider widget
* **Step 2**: In the left sidebar, go to Apps and click Add block.

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

* **Step 3**: When the window opens, go to Apps, enter "Gift slider" in the search bar, and select BOGOS: Gift Slider.

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

* **Step 4**: Move the placeholder of Gift slider to your desired position to attract customers and then click Save.

## 2. Add the Gift Slider to Other Store Pages

**Step 1:** Navigate to your **Online Stores** in the **Shopify navigation menu** => choose **Themes** => **Customize**

**Step 2:** In the **Shopify Theme Editor**, go to the page where you want to add the Gift slider block.

Then, on the left panel, scroll down, click **Add section**, choose **Apps**, find and select **BOGOS: Gift slider** block.<br>

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

## FAQs

<details>

<summary><strong>Are there options to help customers quickly find gifts, products, or variants on the gift slider?</strong></summary>

Yes! Please contact our support team to enable the “Search” option on the gift slider. Once enabled, customers can easily search by product or variant name.

![](/files/39b1AzdB7z8BMHEqaRPk)

</details>

<details>

<summary><strong>Is it possible to show the gift pop-up in the cart drawer?</strong></summary>

Currently, we can add our gift pop-up in only compatible cart drawer. If you want to do this request, please contact us via live chat, our technical team will check your cart first and then work on it.

</details>

<details>

<summary><strong>I want to control how often the gift popup appears, is that possible?</strong></summary>

Yes, you can partially control it using the built‑in “disable slider” option:

Here are the steps to turn on this feature:&#x20;

* Go to BOGOS → Customize → Gift Slider.
* In Advanced settings, enable “Switch to disable slider”.
* Set the time duration (minutes) – during this time, if the customer ticks that switch, the popup won’t appear again.

<div align="left"><img src="/files/41aYm1EklWmBM3CyE6zc" alt="" height="321" width="624"></div>

</details>

<details>

<summary><strong>Can I automatically hide/disable out-of-stock products from gift selection?</strong></summary>

With **Cloned gift logic**, yes but not by “hiding” them inside the slider settings; you control it via inventory behavior:

Checklist:

* In BOGOS → Settings → Gift inventory management, choose “Sync gift products’ quantity with original products’ quantity”.
* For When the gift is out of stock, select “Stop the offers” (not “Continue selling”).
* Make sure the original product (or cloned gift product, if you use manual inventory) has correct stock in Shopify.

With “Stop the offers” on, once a gift is out of stock, that offer stops, so the out‑of‑stock gift will no longer be available for selection.&#x20;

With **Gift function logic**, the out of stock gift will be hidden automatically in the gift slider so you don’t need to do anything.

If you need more granular per‑variant hiding inside one offer, contact BOGOS support via Live chat for a custom review.

</details>

<details>

<summary><strong>How to change the order of gift items in the gift pop-up?</strong></summary>

In order to change the order of gift items in the gift pop-up, please help me follow these steps:&#x20;

1. Going to the offer you create > go to Gift selection
2. Click at the first icon in front of the gift product title as in my screenshot to change product order

</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/customize/customize-gift-slider.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.