Display in Checkout & Cart

FeeBee allows you to apply product-based fees through Shopify’s cart transformation API. However, how these fees are displayed in the cart and checkout is restricted by Shopify’s native limitations. To improve fee visibility, FeeBee offers optional display settings designed to work around these restrictions.

These settings do not affect fee calculation or application. They are purely cosmetic and can be enabled or disabled at any time.

Cart Display

Default Shopify Behavior

Most Shopify themes do not yet support line_item.item_components , which is the Shopify feature used to define the bundled components (such as product fees). As a result, customers will only see the main product with the total price including the fee, but not the fee itself listed separately. This can be misleading or confusing, particularly in regions where fees must be clearly itemized (e.g. Germany’s bottle deposit requirements).

FeeBee Display Option: Show fees in the cart under the main product

When this setting is enabled, FeeBee adds the fee(s) as line item properties to the cart item. This results in additional lines appearing under the product title that show the fee name and amount. This method is compatible with most Shopify themes out-of-the-box.

This approach is especially helpful for merchants who need transparency but want a solution that works without modifying theme code.

If a more advanced display (e.g. showing fee icons or component images) is desired, a developer can use line_item.item_components directly in the Liquid theme to fully customize how the cart renders bundled items.

Checkout Display

Default Shopify Behavior

Shopify's checkout layout is controlled entirely by Shopify and cannot be modified by apps. When a product has a fee applied via FeeBee, Shopify will display the fee as part of the product bundle. However, only the total price is shown. The fee and base product are listed as components, but their individual prices are hidden.

This limits transparency, particularly when it's important to show customers exactly what they are paying for.

FeeBee Display Option: Show fees in the checkout under the fee product

Enabling this setting adds a line item property to each bundled component in the checkout. This line item property contains the fee or base product's price, allowing customers to see the exact breakdown, even though Shopify does not natively show component prices.

This does not change how Shopify calculates totals or taxes, it simply enhances the clarity of the cost breakdown during checkout.

Summary

These two display settings are designed to improve the visibility of applied fees in both the cart and checkout:

• Show fees in the cart under the main product: Adds fee descriptions as line item properties for better visibility in the cart.
• Show fees in the checkout under the fee product: Adds price information to each component for more transparency in the checkout.

Both settings are optional, non-destructive, and can be toggled on or off at any time without affecting how fees function in your store.