🛒 AutoCart Docs

Introduction

Documentation for AutoCart — the Shopify app that automatically manages cart items based on configurable rules.

Welcome to AutoCart Docs

AutoCart is a Shopify app that automatically adds, removes, and manages cart items based on configurable business rules. It operates across two main surfaces:

  • Storefront — via a theme app extension that intercepts cart actions and displays gift picker modals
  • Checkout — via checkout UI extensions that evaluate rules at the checkout stage

Advanced and higher plans also include Modal Designer, a responsive visual editor for the storefront gift picker. Saved designs are connected to the existing theme extension and fall back to the legacy modal whenever a valid design is unavailable.

Extensions Overview

AutoCart is composed of several Shopify app extensions, each serving a specific purpose:

ExtensionTypeStatusDescription
Theme ExtensionTheme App Extension✅ ActiveCore storefront integration. Injects AutoCart logic into your theme.
Progressive ThemeTheme App Embed✅ ActiveEvaluates Tiered and Cyclic gift progression on storefront cart changes.
Checkout GiftCheckout UI Extension✅ ActiveEvaluates autocart rules at checkout, manages gift products, and displays picker modals.
Checkout ProgressiveCheckout UI Extension✅ ActiveKeeps Tiered and Cyclic gifts synchronized during checkout.
Checkout (Deprecated)Checkout UI Extension⚠️ DeprecatedOriginal checkout extension. Superseded by Checkout Gift.
Checkout RemoveCheckout UI Extension✅ ActiveRenders a "remove" button next to autocart-added cart line items in checkout.
Discount FunctionShopify Function✅ ActiveServer-side discount function that applies discounts to autocart items.

Architecture

┌─────────────────────────────────────┐
│           Shopify Theme             │
│  ┌───────────────────────────────┐  │
│  │  Theme Extension              │  │
│  │  • Automatic mode             │  │
│  │  • Button mode                │  │
│  │  • window.autoCartConfig      │  │
│  └───────────┬───────────────────┘  │
│              │ cart/add, cart/change │
│  ┌───────────▼───────────────────┐  │
│  │  AutoCart Engine               │  │
│  │  • Rule evaluation            │  │
│  │  • Gift modal UI              │  │
│  │  • Cart manipulation          │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │  Progressive Theme Embed      │  │
│  │  • Tiered and Cyclic rules    │  │
│  │  • Progressive gift syncing   │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘
                  │
                  ▼ Proceeds to checkout
┌─────────────────────────────────────┐
│         Shopify Checkout            │
│  ┌───────────────────────────────┐  │
│  │  Checkout Gift Extension      │  │
│  │  • Re-evaluates rules         │  │
│  │  • Manages gift products      │  │
│  │  • Auto-cleans expired rules  │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │  Checkout Progressive         │  │
│  │  • Tiered and Cyclic rules    │  │
│  │  • Queued cart mutations      │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │  Checkout Remove Extension    │  │
│  │  • Remove button per line     │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │  Discount Function            │  │
│  │  • Applies product discounts  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

On this page