~/apps/ca-battery-fee/install

Install CA Battery Fee

Four steps. Estimated install time: 5–15 minutes depending on catalog size. Install from the App Store, then finish setup in your dashboard.

Install on Shopify App Store →

Install from Shopify App Store

Free public Shopify app. Requires Shopify Plus — the checkout-extensibility surface this app uses for the disclaimer is Plus-only.

→ continue to step 02

$ open https://apps.shopify.com/ca-battery-fee
→ Approve scopes: read_products, write_cart_transforms
→ Plan: Shopify Plus required
✓ App installed

Configure battery + fee products

In the dashboard, search-and-select the collection containing your battery products and the unlisted fee variant. Customize the disclaimer message template if needed.

→ continue to step 03

$ admin → ca-battery-fee → dashboard
battery_collection = "Batteries" · 47 products
fee_variant = "California Battery Recycling Fee" · $0.01
message = "A {AMOUNT} California Battery Recycling Fee..."
✓ Settings saved

Add the disclaimer block at checkout

Open your checkout editor and add the CA Battery Fee Disclaimer app block to the Order summary section. Toggle on "Include block in Shop Pay" under Checkout behavior so the disclaimer renders during Shop Pay checkouts too. Required step — without the block placed, no fee is applied at checkout.

→ continue to step 04

$ admin → Settings → Checkout → Customize
→ Order summary → Add app block → "CA Battery Fee Disclaimer"
→ Toggle on "Include block in Shop Pay"
→ Save
✓ Block live on every checkout

Test with a California address

Add a battery product to cart, proceed to checkout with a CA ZIP. The fee + disclaimer render in the order summary, calculated per California H&S Code § 25214.10.2.

$ checkout test
ship_to = Los Angeles, CA 90210
cart = 1× Battery Pack · $50.00
→ Subtotal: $50.00
→ CA Battery Recycling Fee: $0.75
→ Disclaimer: "A $0.75 California Battery Recycling Fee..."
✓ Compliant

~/apps/ca-battery-fee/help

Stuck on a step? We're here to help.

Contact support →