Getting Started

How AutoCart Works

AutoCart is a Shopify app with multiple extension types that work together to manage cart items automatically based on rules you configure in the app.

Extension Types

Theme App Extensions

The standard theme extension is the core storefront integration. When added to your theme, it:

1. Reads your configured automation rules
2. Populates the AutoCart configuration on every page load
3. Intercepts cart actions (/cart/add, /cart/change) to evaluate rules
4. Displays a gift picker modal when rules match

The AutoCart Progressive app embed runs alongside it for Tiered and Cyclic rules. It observes cart updates, recalculates progression from all products or selected products, tags, or collections, and synchronizes gift quantities.

Checkout UI Extensions

Checkout extensions run inside Shopify's checkout. They have access to:

• Cart lines and attributes
• Customer identity and tags
• Discount codes
• Payment options
• Delivery groups

autocart-checkout-gift handles standard rules and gift selection. autocart-checkout-progressive independently handles Tiered and Cyclic progression.

Discount Function

The discount function runs server-side on Shopify's infrastructure to apply product-level discounts to autocart items. It reads cart line attributes and applies the configured discount automatically.

Configuration Flow

1. Admin UI — Configure automation rules in the AutoCart app
2. Storefront — The standard and Progressive theme engines evaluate their respective rules and manipulate the cart client-side
3. Checkout — The standard and Progressive checkout extensions re-evaluate their respective rules with checkout context
4. Discounts — The discount function applies product-level discounts server-side