# Versions comparision and updates

## Quick summary

* **Add Charge v3 (Current):** Bundle-style Add Charge generated in cart. Supports percentage add charge and negative values. Works with dynamic checkout buttons on product + cart pages. No extra products created in Shopify.
* **Add Charge v2 :** Uses an actual Shopify product to represent add-on charges. Best compatibility with Shopify discounts. Fixed amount only.
* **Add Charge v1 (Legacy):** Uses Draft Order logic. Supports percentage add charge, but discounts and dynamic checkout buttons are limited.

***

## Comparison table

| Topic                                   | Add Charge v1 (Legacy)                                              | Add Charge v2 (Legacy)                                              | Add Charge v3 (Current)                                                                                                                                     |
| --------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| How pricing is applied                  | Uses **Draft Order** to add price to the customer order             | Uses an **actual Shopify product** to add price to the main product | Uses a **bundle-style mechanism**; Add Charge is generated **only when in cart**                                                                            |
| Creates extra products in Shopify Admin | No                                                                  | **Yes**                                                             | No                                                                                                                                                          |
| Supported charge types                  | <p>✅ Fixed amount<br>✅ Percentage (%)</p>                           | <p>✅ Fixed amount<br>❌ Percentage (%)</p>                           | <p>✅ Fixed amount<br>✅ Percentage (%)<br>✅ Negative values</p>                                                                                              |
| Shopify discount compatibility          | ⚠️ Not fully supported (often requires a discount box / workaround) | ✅ Works normally with Shopify discounts (real product behavior)     | ✅ Works normally with Shopify discounts                                                                                                                     |
| Bundle app compatibility                | Depends on the Bundle app                                           | Usually OK                                                          | ⚠️ Works with discounts, but may not work with some bundle apps (still works with [**Avis Bundle**](https://apps.shopify.com/avis-bundles-volume-discount)) |
| Dynamic checkout buttons                | ❌ Not supported                                                     | ✅ Supported only on **cart page + checkout**                        | ✅ Supported                                                                                                                                                 |
| Extra capabilities                      | —                                                                   | —                                                                   | ✅ Supports **Dimension** option                                                                                                                             |

***

### Add Charge v1 (Legacy)

#### How it works

* Applies Add Charge using a **Draft Order** approach.
* Add Charge can be set as a **percentage (%)**.
* Does **not** create an actual product in your Shopify store.

#### Known limitations

* **Discount behavior is not fully compatible**, so stores may rely on a manual discount input box/workaround.
* **Dynamic checkout buttons do not work** with this version.

***

### Add Charge v2&#x20;

#### How it works

* Create an **actual Shopify product** to represent the add-on charge.
* When customers select an Add Charge option, the corresponding Add Charge product/variant is added to cart alongside the main product.

#### What it supports

* Add Charge is **fixed amount only** (no percentage).

#### Compatibility notes

* ✅ Shopify discounts generally work well (because it behaves like a standard product/variant).
* ✅ Dynamic checkout buttons typically work on **cart page and checkout**.

***

### Add Charge v3 (Current)

#### How it works

* Uses a **bundle-style Add Charge mechanism**.
* Add Charge is generated **only when the item is in cart**.
* Does **not** create extra add-on products in Shopify Admin.

#### What it supports

* ✅ Fixed amount
* ✅ Percentage (%)
* ✅ Negative Add Charge values
* ✅ Dimension option / Fomular price

#### Compatibility notes

* ✅ Shopify discounts generally work normally.
* ✅ Fully work with dynamic checkout buttons

#### Known limitations

* ⚠️ May not work alongside some bundle apps (still works with **Avis Bundle**).

***

### Which version should you choose?

#### Choose **Add Charge v3** if you want:

* Dynamic checkout button compatibility on the **product page**
* More flexible pricing (percentage and negative values)
* No extra add-on products created in Shopify

#### Choose **Add Charge v2** if you want:

* A “real product” approach that typically aligns best with Shopify discount rules
* Fixed-price add charges and the ability to manage add-on product behavior in Shopify

## **How to change the Add Charge version?**

We currently support switching between **Add Charge v2 and v3** for new customers.\
For more details or assistance, please contact our support team at **<helpdesk@avis.io>**.

***


---

# Agent Instructions: 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:

```
GET https://options-docs-v2.avisplus.io/pricing-and-upsell/add-charge-add-ons/versions-comparision-and-updates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.