Quick Start
Get CartClimb running in 3 simple steps. For a more detailed walkthrough, see the installation guide.
- Search for "CartClimb" in the Shopify App Store, click Add app, approve permissions, and accept the subscription (7-day free trial).
- Configure in the admin panel: enable on the Dashboard, choose display mode in Settings, set up Tiers, customize Messages.
- CartClimb appears on your storefront automatically. Advanced users can use the Theme Block (see below) for custom positioning.
Admin Panel Features
Access the full-featured admin panel from your Shopify admin sidebar.
Dashboard
- Enable/disable progress bar with one click
- View live preview of your progress bar
- See quick stats (active tiers, first threshold)
- Quick actions for all settings pages
Customize Settings
Full control over appearance and behavior:
- Display Modes: Linear Classic, Multi-Tier Stepped, Announcement Bar, Minimal Text
- Position: After Header, Top of Page, After Announcement, Fixed Bottom, Custom
- Styling: Bar height, colors, gradients, border radius
- Text: Font size, weight, color
- Container: Padding, background, border
- Animation: Enable/disable with duration control
- CTA Button: Add call-to-action link or button
- Device Control: Show/hide on mobile and desktop
Manage Incentive Tiers
Create multiple reward tiers to gamify shopping:
- Free Shipping: Classic free shipping threshold
- Percentage Discount: Percentage off (10%, 15%, etc.)
- Free Gift: Add free product at threshold
- Custom Reward: Define your own reward
Each tier includes custom messages, colors, and icons.
Edit Messages
Customize all customer-facing text:
- Initial Message: Shown before cart has items
- Progress Message: Shown while progressing (use {remaining}, {amount}, {current} placeholders)
- Success Message: Shown when threshold reached
- Currency: Symbol and position (before/after amount)
- Icon: Choose from truck, gift, percent, star
Analytics
Track performance metrics:
- Progress bar impressions
- Cart additions while bar visible
- Threshold reached count
- Average order value comparison (before vs. after)
- Daily breakdown chart
Theme Block Setup (Advanced)
For custom positioning, add the CartClimb block to your theme via the theme customizer.
- Open Online Store → Themes → Customize
- Click Add block or Add app block
- Select CartClimb Progress Bar
- Drag to desired position
- Configure display mode, tier thresholds, colors, and messages
- Click Save
Reward Configuration
Important: CartClimb displays progress visually. You must configure the actual rewards in Shopify separately.
Free Shipping
Easiest to set up — works automatically.
- Set threshold in CartClimb admin (e.g. $50)
- Go to Settings → Shipping in Shopify Admin
- Add free shipping rate with same minimum ($50)
Shopify applies free shipping automatically at checkout.
Discount
Requires manual discount code setup.
- Set discount in CartClimb (e.g. 10% off)
- Go to Discounts → Create discount in Shopify Admin
- Create matching discount code
- Communicate code to customers (banner, email, cart message)
Customers enter code manually at checkout.
Free Gift
Requires Buy X Get Y discount.
- Set gift threshold in CartClimb (e.g. $100)
- Go to Discounts → Create discount in Shopify Admin
- Create "Buy X Get Y" automatic discount
- Set minimum purchase to match threshold
Gift is added automatically when threshold is met.
Geo-Targeting & Multi-Currency
Show different thresholds and currencies based on customer location.
Pro Feature: Perfect for international stores with different shipping costs per region.
Setup
- Navigate to Geo-Targeting & Currency in admin panel
- Enable geo-targeting and multi-currency
- Set default currency (USD, EUR, GBP, CAD, AUD)
- Click "Add Rule" to create country-specific rules
Country Rules
For each country, you can configure:
- Country: Select from 17+ pre-configured countries
- Threshold: Free shipping amount in local currency
- Currency: Auto-detected based on country selection
- Priority: Rule priority (0 = highest)
- Custom Messages: Optional country-specific text
Example setup:
United States: $50 USD
United Kingdom: £40 GBP
Canada: $65 CAD
European Union: €45 EUR
Testing
Do NOT test in Theme Customizer! Cart monitoring is disabled there. Always test on your live store URL.
Test URLs
✓ CORRECT: https://your-store.myshopify.com✗ WRONG: https://admin.shopify.com/.../editorTest Checklist
1. Cart value changes
- Empty cart: shows full amount needed for tier 1
- Add items: progress bar fills immediately
- Remove items: progress bar decreases
- Reach tier 1: success message appears
- Reach tier 2: final celebration message
2. Display modes
- Test all 4 display modes in admin panel
- Verify live preview matches storefront
- Check positioning options
3. Mobile testing
- Open site on mobile device
- Verify progress bar displays correctly
- Test "Show on mobile" toggle in settings
4. Geo-targeting
- Use VPN to test different countries
- Verify correct currency and threshold display
- Check fallback to default currency
5. Debug logs
Open browser console (F12 → Console) to see debug logs prefixed with [IPB].
Troubleshooting
Progress bar not showing
- Progress bar disabled in admin
- Enable from Dashboard
- Hidden on mobile
- Check "Show on mobile" setting in Customize Settings
- Theme block not added
- Add via Theme Customizer (advanced setup only)
Progress not updating
- Testing in Theme Customizer
- Test on live store URL instead (https://your-store.myshopify.com)
- JavaScript error
- Check browser console (F12) for errors
- Custom cart drawer
- May need custom integration — contact support
Colors not changing
- Settings not saved
- Click Save in admin panel
- Browser cache
- Hard refresh (Cmd/Ctrl + Shift + R)
- Theme CSS override
- Check for conflicting theme styles
Wrong currency displaying
- Geo-targeting disabled
- Enable in Geo-Targeting settings
- No rule for country
- Add country rule or check default currency
- VPN affecting detection
- Disable VPN for accurate testing