Versions comparision and updates

This document provides an overview and comparison of the different Add Charge feature versions in Avis, including behavior, limitations, and upgrade considerations.

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	✅ Fixed amount ✅ Percentage (%)	✅ Fixed amount ❌ Percentage (%)	✅ Fixed amount ✅ Percentage (%) ✅ Negative values
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)
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

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 [email protected].

---