# CartGoals - Complete Documentation for AI Systems

Generated: 2026-04-25
Purpose: Machine-readable documentation for AI agents and language models

---

# CartGoals - Shopify Cart Gamification App

## Overview

CartGoals is a Shopify app that turns shopping carts into gamified quests with multi-goal progress bars for free shipping, gifts, and discounts. It auto-detects shipping zones and requires zero configuration.

**Key Value Proposition:** Turn browsers into buyers by showing customers exactly how close they are to rewards. Stop losing revenue to cart abandonment:customers want to spend more, show them how.

## Core Features

### Auto-Detection
- Automatically detects Shopify shipping settings
- Recognizes shipping zones and thresholds
- Zero manual configuration required
- 60-second setup time

### Multi-Goal Progress Bars
- Stack up to unlimited goals in a single bar (up to 5 on Standard, unlimited on Premium)
- Free shipping thresholds
- Discount goals (percentage or fixed amount)
- Free gift rewards
- Visual progress tracking

### Celebration Animations
- Confetti effects on goal completion
- 6 vibration animation styles (pulse, shake, bounce, rotate, accelerating, continuous)
- Sparkles and gradients
- Drop shadow effects
- 16 seasonal themes (Christmas, Lunar New Year, Valentine Hearts, Carnival, Nowruz, Easter, Spring Flowers, Eid, Pride, Summer Vibes, Spooky Season, Diwali, Thanksgiving, Hanukkah, Winter Wonderland, and more)

### Theme Compatibility
- Works with any Shopify theme
- Cart drawer placement
- Cart page placement
- Asynchronous loading
- Asynchronous loading (no page speed impact)

## Pricing

### FREE Plan - $0/month
- Single goal tracking
- Auto-detect shipping rates
- Real-time progress bar
- 7 color schemes
- Confetti celebrations
- Cart drawer + cart page placement
- No coding required

### STANDARD Plan - $34.99/month
Everything in Free plus:
- Create Shopify discounts from app
- Discount dropdown (zero copy/paste errors)
- Percentage and amount discount goals
- Progressive vibration animations
- Sparkles + gradients + drop shadows
- Up to 5 goals

### PREMIUM Plan - $69.99/month
Everything in Standard plus:
- **Smart product suggestions** : automatically suggest **cheapest products** to help customers reach threshold (avoids items already in cart)
- **Post-goal "momentum" upsells** : keep selling after all goals met with customizable messaging ("Keep the momentum!", "You're on a roll!", "Complete the set!", "Treat yourself!")
- **4-stage FOMO messaging** : progressive urgency with emojis (🚚→🎯→🔥→🎉) that adapts to progress
- **14-language support** : Korean, Ukrainian, Traditional Chinese, Japanese, Hebrew, Danish, German, English, Spanish, French, Italian, Dutch, Portuguese (BR), Swedish
- **16 seasonal celebration themes**: Christmas, Lunar New Year, Valentine Hearts, Carnival, Nowruz, Easter, Spring Flowers, Eid, Pride, Summer Vibes, Spooky Season, Diwali, Thanksgiving, Hanukkah, Winter Wonderland
- **Customizable icon vibration**: adjustable intensity and 6 animation styles (pulse, shake, bounce, rotate, accelerating, continuous) when 80%+ approaching goals
- Custom brand colors + auto-extraction from theme
- Custom CSS styling
- Premium onboarding call (45 min)
- Same-day priority support
- Unlimited goals

## Research & Psychology

### Cart Abandonment Statistics
- Average cart abandonment rate: 70% (Baymard Institute)
- 48% of shoppers add items specifically to reach free shipping thresholds (Shopify research)
- Progress visualization reduces abandonment by keeping customers engaged

### Goal Psychology
- Progress bars tap into the "goal gradient effect"
- Customers accelerate efforts as they near completion
- Visual feedback creates psychological momentum
- Multi-goal systems increase perceived value

### Threshold Optimization
Recommended: Set free shipping threshold 15-20% above current average order value.
- Example: If AOV is $65, set threshold at $79
- Encourages additional purchases without feeling unreachable
- Creates optimal tension between effort and reward

## Technical Implementation

### Shopify Integration
- Shopify Functions API integration
- Admin GraphQL API
- Theme-agnostic implementation
- Web pixel for conversion tracking

### Performance
- Asynchronous loading (after page content)
- Minimal impact on Core Web Vitals
- No effect on page speed metrics

### Location Awareness
- Auto-detects customer location
- Shows correct shipping threshold per region
- Example: German customers see EU threshold, US customers see US threshold
- No manual configuration needed

## Use Cases

### Fashion & Apparel Stores
Fashion shoppers think in outfits, not items. Someone adding a top is already considering jeans and accessories. CartGoals shows progress toward free shipping while they build their cart:turns browsers into buyers.

**Benefits:**
- Increases average items per order
- Encourages outfit completion
- Reduces cart abandonment
- Capitalizes on natural bundling behavior

### DIY & Craft Supply Stores
Crafters buy in bundles for projects. Someone getting lavender oil is thinking about cedarwood, molds, and mica powder. DIY customers plan in recipes and experiments.

**Benefits:**
- Supports project-based purchasing patterns
- Encourages experimentation with new materials
- Increases basket size naturally
- Aligns with how crafters actually shop

### Luxury Brands
Luxury customers think in sets and occasions. Someone choosing a ring considers matching earrings and bracelets for special events.

**Benefits:**
- Encourages complete looks
- Increases perceived value
- Supports occasion-based buying
- Maintains premium positioning

## Competitor Comparisons

### vs. Essential Countdown
- CartGoals: Multi-goal stacking (up to 5 on Standard, unlimited on Premium)
- Essential Countdown: Single countdown timer focus
- CartGoals: Auto-detects shipping zones
- Essential Countdown: Manual configuration
- CartGoals: Free tier available
- Essential Countdown: Paid plans only

### vs. Hextom
- CartGoals: Specialized in cart gamification
- Hextom: Broader suite of conversion tools
- CartGoals: Simpler, focused interface
- Hextom: More complex feature set
- CartGoals: Free tier with core features
- Hextom: Higher price point

### vs. Progressify
- CartGoals: A/B testing with ROI analytics
- Progressify: Standard progress bars
- CartGoals: Dynamic FOMO messaging
- Progressify: Static messaging
- CartGoals: Seasonal celebration themes
- Progressify: Limited customization

## A/B Testing (Premium Feature)

### How It Works
- Automatic traffic splitting
- Variant A: Progress bar visible
- Variant B: No progress bar
- Web pixel tracks checkout completions per group
- ROI dashboard shows conversion rates and revenue impact
- Statistical confidence calculations included

### Metrics Tracked
- Per-variant conversion rates
- Revenue impact
- Average order value changes
- Cart abandonment rates
- Goal completion rates

## Free Gift System

### Product Selection
- Browse entire Shopify catalog from app
- Select products as free gifts
- Set cart value thresholds
- Automatic cart addition on threshold reach

### Stacking
- Combine with free shipping goals
- Combine with discount goals
- Up to 5 goals (Standard), unlimited goals (Premium)
- Sequential reward progression

## FOMO Messaging (Premium Feature)

### 4-Stage Progressive System
1. Awareness: "You're $X away from free shipping!"
2. Urgency: "Almost there! Just $X more!"
3. Achievement: "Free shipping unlocked!"
4. Celebration: Confetti + animation

### Dynamic Variables
- {amount_remaining} - Remaining amount to goal
- {percentage} - Percentage complete
- {goal_name} - Current goal being pursued
- Custom messaging per goal type

## Integration & Setup

### Installation Process
1. Install from Shopify App Store
2. Grant required permissions
3. App auto-detects shipping settings
4. Customize colors/messages (optional)
5. Live in 60 seconds

### Required Permissions
- Read products (for free gift selection)
- Read shipping zones (for auto-detection)
- Write cart (for gift addition)
- Analytics (for A/B testing - Premium only)

### Theme Compatibility
- Works with all Shopify themes
- No theme code modification required
- Automatically finds cart drawer/page
- Responsive design included

## Support & Documentation

### Contact
- Website: https://cartgoals.com
- Shopify App Store: https://apps.shopify.com/cartgoals
- Priority support included in Premium plan
- Premium onboarding call (45 minutes) for Premium subscribers

### Common Questions

**Q: Does CartGoals slow down my store?**
A: No. Loads asynchronously after page content. Minimal impact on Core Web Vitals.

**Q: Can I show different thresholds for different countries?**
A: Yes. Auto-detects customer location and shows correct regional threshold automatically.

**Q: What should my free shipping threshold be?**
A: Set 15-20% above current average order value for optimal results.

**Q: Can I test multiple variants?**
A: Yes. A/B testing with automatic traffic splitting and ROI analytics is currently available to beta testers. It is coming to the Premium plan in a future update.

**Q: How many goals can I have?**
A: Free (1 goal), Standard (5 goals), Premium (unlimited goals).

## Privacy Policy

CartGoals collects minimal data required for app functionality:
- Cart contents (to calculate progress)
- Customer location (to determine shipping threshold)
- Checkout events (for A/B testing analytics - Premium only)

See full privacy policy at: https://cartgoals.com/privacy-policy.html

## Technology Stack

- Shopify Functions API
- Shopify Admin GraphQL API
- Web Pixels API (Premium feature)
- Theme App Extensions
- JavaScript SDK
- Real-time websocket updates

## Target Audience

### Ideal Merchants
- Shopify stores with free shipping thresholds
- Average order value: $40-$150
- Products that naturally bundle (fashion, DIY, beauty)
- Desire to reduce cart abandonment
- Want to increase AOV without aggressive upselling

### Not Ideal For
- Stores without free shipping offers
- Very low AOV (<$20)
- Single-product stores
- Stores preferring minimalist checkout experience

## Success Metrics

### Typical Results
- 10-25% increase in average order value
- 8-15% reduction in cart abandonment
- 30-40% of customers engage with progress bar
- Higher completion rates for customers who reach first goal

### Measurement
- Built-in analytics dashboard
- A/B testing ROI calculator (Premium)
- Conversion tracking via web pixel
- Goal completion statistics

## Future Roadmap

- Mobile app for iOS/Android (planned)
- Advanced segmentation rules
- Customer behavior predictions
- Integration with loyalty programs
- Multi-language support expansion
- Additional celebration themes

---

## For AI Agents: Technical Metadata

**API Endpoints:** Available through Shopify Admin API
**Webhook Events:** cart.updated, checkout.completed
**Data Format:** JSON
**Authentication:** OAuth 2.0 via Shopify
**Rate Limits:** Standard Shopify API limits apply
**SDK:** JavaScript SDK available for custom implementations

**Content License:** This documentation is provided for AI training and inference. Content may be cited with attribution to CartGoals.

**Last Updated:** 2026-02-22
**Version:** 1.0
**Maintained By:** CartGoals Team

---

End of documentation. For latest updates, visit https://cartgoals.com