Known Limitations and Workarounds
Introduction
FeeBee uses Shopify’s Cart Transformation API to bundle fees with products, making it possible to apply both fixed and percentage-based fees across all sales channels, including Checkout, Draft Orders, and POS. While this offers a high level of flexibility, certain limitations are imposed by the Shopify platform itself.
This article outlines the known limitations of FeeBee and offers available workarounds where possible.
Limitations
1. Fees Cannot Be Limited to Specific Sales Channels
Shopify does not currently allow apps using the Cart Transform API to restrict their functionality by sales channel (for example, online store vs. POS). As a result, FeeBee applies fees across all sales channels.
Workaround: There is no workaround at this time. If Shopify introduces sales channel scoping for cart transformations in the future, FeeBee will support it.
2. Fee Display in the Checkout Cannot Be Changed
The way bundle components (product + fee) are displayed in the Shopify checkout is controlled by Shopify. Currently, there is no way for apps to alter the formatting or presentation of bundle components in the checkout.
Workaround: Use the display settings for checkout to display the fee price during checkout or use our "Bundle with Fees" to list fees as a separate line item.
3. Fee Visibility on the Cart Page Requires Theme Support ("Bundle with Product" fees)
Most Shopify themes are not yet designed to display bundle components on the cart page. Without custom development, only the total price of the bundle is shown, and customers do not see a breakdown of the base product and the fee.
Workarounds:
- Custom theme update: A developer can modify your Shopify theme to loop through
line_item.item_componentsand render each bundle component with its name and price. Shopify’s Liquid documentation provides guidance on how to do this. - FeeBee display setting: Enable “Show fees in the cart under the main product” in the Fee settings. FeeBee adds the base product and fee details as line item properties, so they appear as text beneath the product in the cart. This is purely cosmetic and does not change Shopify’s native bundle display, but it improves clarity for the customer.
4. Fees Cannot Be Applied to Gift Card Products
Shopify does not allow cart transformations (and therefore FeeBee) to modify gift card products. This is a strict platform-level restriction, and FeeBee cannot apply fees to gift cards under any circumstances.
Workaround: None currently exists.
5. Bundle App Compatibility
Fees of type “Bundle with Product” are usually not compatible with products already managed by Shopify Bundles or another bundle app. In most cases, only one app can reliably bundle or transform the same product line. Please use “Bundle with Fees” for those products instead.
6. Only Three Custom Fields Are Preserved per Product
FeeBee can preserve up to three line item properties (custom fields) per product. This is a limitation of Shopify’s cart transformation system, which does not support unlimited fields during checkout.
Workaround:
You can combine multiple fields into one. For example:
Booking Info: Date: June 15, Time: 6:00 PM, Guest Name: Alice
We offer a script to help automate this. Contact our support for free assistance on this.