Fees Not Showing on Your Online Store?
If fees aren't appearing on your online store, work through these steps:
1. Check the App Embed Is Enabled
Go to Online Store → Themes → Customize
Click App embeds (left sidebar)
Make sure the Canteen embed is toggled ON
Click Save
If you recently changed themes, you'll need to re-enable the embed on the new theme.
2. Check Your Rules
Open the Canteen app in your Shopify admin
Verify your rules are active (not paused or disabled)
Check that the correct products or collections are assigned to each rule
Make sure the fee amount is set correctly
3. Check the App Embed Version
If you're using percentage-based fees, make sure you're on version 4.1.0 of the app embed
Go to Theme Customize → App embeds → Canteen and check the version dropdown
4. Clear Your Browser Cache
Sometimes old cached scripts prevent the fee from showing. Try:
Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Try an incognito/private browsing window
5. Theme Compatibility
If you recently changed or updated your theme:
Re-enable the Canteen app embed on the new theme
Some themes with custom AJAX carts may need additional configuration
Contact us if fees work on the cart page but not in a slide-out/mini cart
Fees Not Showing on POS?
1. Check the POS Tile
Make sure you've added the Canteen - Deposits and Fees tile to your POS
The tile should show "Active" when products are in the cart, and "Inactive" when the cart is empty
2. The Tile Says "Inactive"
This is normal when the cart is empty. "Inactive" means there's nothing to monitor. Add a product to the cart and it should switch to "Active."
3. Fees Aren't Calculating Correctly on POS
In rare cases, adding products very quickly can outpace the fee calculation. If this happens:
Tap the Canteen Deposits & Fees tile — this forces a recalculation
The correct fees will be applied immediately
6. Mobile or Drawer Cart Issues
If fees apply on desktop but not on mobile, your theme likely uses a drawer cart (slide-out cart). Canteen intercepts the checkout button on the full /cart page, but some drawer carts render their own checkout button that bypasses this interception.
To fix this:
Make sure you are on Canteen v4.1.0 or later (Theme Customize → App embeds → Canteen)
Open the Canteen app in your Shopify admin and accept any new permissions
Try toggling your rule: deactivate → save → reactivate → save
If the issue persists, contact us with your store URL and theme name — some themes with custom drawer carts need additional configuration on our end
Express checkout buttons (Shop Pay, Apple Pay, Google Pay) on the product page may also bypass fee application. Canteen works best when customers go through the standard cart → checkout flow.
Still Having Issues?
Contact us through the chat widget and include:
Your store URL
Which products/collections should have fees
Whether the issue is on Online Store, POS, or both
Screenshots if possible
After Upgrading to a New Version
After changing your Canteen version, make sure to:
Open the Canteen app in your Shopify admin and accept any new permissions — newer versions may require additional permissions for fees to work properly.
If fees still aren’t applying, try toggling your rule: deactivate the rule → save → reactivate → save. This forces a sync and usually resolves any issues.
Seeing "A cart transform function failed" Error?
If you see an error in your Shopify admin like "A cart transform function failed: t:name by Canteen is not working properly", this typically means:
The Canteen app embed needs to be re-enabled. Go to Online Store → Themes → Customize → App embeds and toggle Canteen off and back on, then Save.
App permissions may need updating. Open the Canteen app in your Shopify admin and accept any pending permission prompts.
A conflict with another app. If you have other apps that modify the cart or checkout (custom pricing apps, VIP pricing, etc.), they may conflict with Canteen. Try temporarily disabling other cart-modifying apps to isolate the issue.
If the error persists, contact us with a screenshot and your store URL — we'll dig in and get it sorted.