# 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>**.

***