> 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/customize/customize-volume-discount.md).

# Customize Volume Discount

Overview of customizing the appearance of the Volume discount on the product page.

BOGOS provides 2 widget types for Volume Discount offers:&#x20;

1. Quantity Options
2. Quantity Discount Table

Each widget has its own content and display settings, allowing you to control exactly what customers see.

## 1. Quantity options

### 1.1 Content

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Fn1ZIGhxW3YJ71z1ebi3v%2Funknown.png?alt=media&amp;token=dfb82241-4452-4f50-870a-a06eb34f9644" alt=""><figcaption></figcaption></figure>

**Show description:** Enable to display a description below the title (e.g: Best deals selected for you!).

**Each tier will show** (choose between):

* Total price: Shows the full price of each tier (e.g: $50)
* Price per item: Shows the price for each item of each tier. Enter per item text to make it clearer (e.g: $10 per item)

**Options to change text:**

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Fe1RwqNOXns05OW62coDp%2Funknown.png?alt=media&amp;token=5b09cd4f-5ad6-4d2f-9241-95bd90f3d281" alt=""><figcaption></figcaption></figure>

* Text format: Edit the discount label shown on each tier. Keep the variable {{discountAmount}} to dynamically display the discount value.
* Total price text: The label shown next to the total price.
* Button text (the text on the button of the widget): The text displayed on the widget's action button.
* Select variant text: The text shown when customers need to select a product variant.

**Shipping discount:** select available shipping icons or upload your own (Accepts image, gif.)

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F6hsSu7oC3EHhLM9861C1%2Funknown.png?alt=media&amp;token=17f06801-0afa-48ad-9ca0-7bf25fcb7cee" alt=""><figcaption></figcaption></figure>

**Subscription:** display subscription options within the widget (if you're set up in Create Volume Discount).

1\. Select a layout: choose between Radio or Checkbox.

2\. Edit the following text fields:

* Subscription title: The heading shown above the subscription options.
* Option label: The label text for each subscription option.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Fmf0sjD1rJl0ZtNXlTsRk%2Funknown.png?alt=media&amp;token=5e48ddf9-982d-49ed-83c5-35ea9950c0e1" alt=""><figcaption></figcaption></figure>

### 1.2 Color

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](/detailed-guide/customize/ai-theme-detector.md) 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.

### 1.3 Add-on

Customize how add-ons appear on the widget. Each offer can have its own set of add-ons.

**Countdown:** Show a countdown timer to motivate customers to buy before the offer ends.

![](https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F9dvtXkHCeBicOxsHrtZV%2Funknown.png?alt=media\&token=24a671a6-5a92-403f-ba7b-ea0ee2bd7cb4)

* **Choose countdown display mode:** Top bar / In-widget bar / Banner / Badge.
* **Countdown text:** The text shown next to the countdown (e.g., "Expiring in").
* **Countdown content align:** Left, Center, or Right.
* **Countdown background style:** Flat color or Gradient color.
* **Customize colors for:** Background, Number text, Number wrap, Description text.

**Free gift:** Customize how the free gift indicator and gift section appear.

![](https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FzhVwitumepEQLRE82kWy%2Funknown.png?alt=media\&token=56dabb03-a26f-4841-8837-ab1b7c459f6e)

* **Select icon:** Choose from available gift icons or upload your own (image or gif).
* **Customize colors for:** Label color, Label text.
* **Gift section title:** The heading above the gift product list.
* **Free price text:** The text shown as the price of each gift (e.g., "FREE").

**Shipping discount:** Customize how the shipping discount banner appears.

![](https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FZoqHuN9kj9blQXX7eaVe%2Funknown.png?alt=media\&token=63652ea7-e875-47c8-b4f0-787ced00ec19)

* **Shipping icon:** Choose from available shipping icons or upload your own.
* **Customize colors for:** Banner color, Banner text.

## 2. Quantity discount table

### 2.1 Content

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F7AgjaBE8HTVftZ1hCPTh%2Funknown.png?alt=media&amp;token=b120fc00-67f8-4033-a017-f381dab83ff3" alt=""><figcaption></figcaption></figure>

**Show description:** Enable to display a description below the title (e.g, Best deals selected for you!).

**Each tier will show** (choose among):

* Discount value: Shows the discount of each tier (e.g: 20% OFF)
* Discount value with label: Shows the discount of each tier with a background color.
* Total price: Shows the full price of each tier (e.g: $50)
* Price per item: Shows the price for each item of each tier. Enter per item text to make it clearer (e.g: $10 per item)

**Text format:** Edit the discount label shown on each tier. Keep the variable {{discountAmount}} to dynamically display the discount value.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FwyXsuA8GOuEiHylSQLaF%2Funknown.png?alt=media&amp;token=b56cecd8-9852-47dc-897d-cc94348bd238" alt=""><figcaption></figcaption></figure>

**Shipping discount:** select available shipping icons or upload your own (Accepts image, gif.)

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F3Ox8Pm9UVD8QqHeyLbjO%2Funknown.png?alt=media&amp;token=37b072fe-a427-46ce-b01a-92c5ddec131c" alt=""><figcaption></figcaption></figure>

### 2.2 Display

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Fvu0WE4je0QODSYfixE30%2Funknown.png?alt=media&amp;token=cb51e668-3e35-4cc0-b453-be57dfa42a3d" alt=""><figcaption></figcaption></figure>

**Widget header & description**: Select their alignment on the widget among Left, Center, or Right.

**Body style**: Choose how the table rows are visually separated between Line or Zebra.

**Hide lines between column** (optional): Remove the vertical dividers between table columns for a cleaner appearance.

### 2.3 Color

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](/detailed-guide/customize/ai-theme-detector.md) 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.

### 2.4 Add-on

Customize how add-ons appear on the widget. Each offer can have its own set of add-ons.

**Countdown:** Show a countdown timer to motivate customers to buy before the offer ends.

<img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F98ViJmiwoQh31W2NPDdj%2Funknown.png?alt=media&amp;token=cbad9497-98ff-43ec-a2f8-709ccbb2fd40" alt="" height="521" width="624">

* **Choose countdown display mode:** Top bar / In-widget bar / Banner / Badge.
* **Countdown text:** The text shown next to the countdown.
* **Countdown content align:** Left, Center, or Right.
* **Countdown background style:** Flat color or Gradient color.
* **Customize colors for:** Background, Number text, Number wrap, Description text.

**Shipping discount:** Customize how the shipping discount banner appears.

![](https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FxDwxaVxpS2T9PwXKTiFi%2Funknown.png?alt=media\&token=349896cb-f0a0-48ad-bc88-9486d1b4e732)

* **Shipping icon:** Choose from available shipping icons or upload your own.
* **Customize colors for:** Banner color, Banner text.

## 3. Add Volume Discount to other pages besides Product Page

{% hint style="info" %}
You can place the Volume discount block on any page of your store, except the Checkout page.
{% endhint %}

**Step 1:** Navigate to your **Online Store** 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 **Volume discount** block.

Then, on the left panel, scroll down, click **Add section**, choose **Apps**, find and select **BOGOS: Volume Discount** block.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Fm2v5LKB7lqhLeSbmTj8A%2Fimage.png?alt=media&amp;token=9c9fe41d-9b10-4dd1-a038-1e353ec7cfae" alt=""><figcaption></figcaption></figure>

**Step 3**: In the top-right panel, complete the setup fields.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2F63hnHCvZoHQsLrQcCxxk%2Fimage.png?alt=media&amp;token=14986168-f2fd-4ce6-a3ec-e052b6c649fc" alt=""><figcaption></figcaption></figure>

* **Offer ID**: Enter the ID of the Volume discount offer you want to display.
* **Product show**: Select a product from your store. All Volume discount offers linked to this product will be displayed on the current page.

For more details, please visit our \[[Adjust BOGOS Blocks](/quick-start-guide/adjust-bogos-blocks.md)].

## Need Help? <a href="#need-help" id="need-help"></a>

If you need any assistance, feel free to reach out to our customer support team via **live chat** within our BOGOS app.


---

# 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/customize/customize-volume-discount.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.
