Step-by-Step Instructions
Step 1: Access Theme Customization
From your Shopify admin dashboard, navigate to Online Store > Themes
Locate your current active theme (in this example, it's "Dawn")
Click the Customize button on the right side of your theme
Step 2: Locate the Canteen App Embed
Once the theme editor opens, look for the App embeds section in the left sidebar
Find Canteen Deposits & Fees in the list of available app embeds
Ensure the toggle switch next to the app name is turned ON (enabled)
Step 3: Select the Compatible Version
This is the most critical step for percentage fee functionality:
In the app embed settings, locate the Version dropdown menu under "Cart Page Configurations"
Click on the dropdown to view all available versions
Select version 4.1.0 from the list
Important Note: Only version 4.1.0 is compatible with percentage-based fees. Other versions do not support this feature.
Step 4: Save Your Changes
After selecting version 4.1.0, click the Save button in the top-right corner of the theme editor
Step 5: Verify the Fee Application
Once saved, the percentage fee will automatically be applied at the checkout page when customers proceed to complete their purchase.
Troubleshooting
If the percentage fee is not appearing at checkout:
Double-check that you've selected version 4.1.0 specifically
Ensure the Canteen app embed toggle is enabled
Clear your browser cache and test in an incognito/private browsing window
Verify that your fee settings are properly configured in the Canteen app dashboard
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.