Checkout Gift Extension

Overview

The autocart-checkout-gift extension is the primary checkout UI extension for AutoCart. It runs inside Shopify's checkout where merchants can position it within the checkout flow.

Key Features

• Rule re-evaluation at checkout — Re-evaluates all automation rules with checkout-specific context (customer tags, payment method, delivery groups)
• Two display modes — banner and slider for presenting gift options
• Modal gift picker — Full modal UI for customers to select gift products or variants
• Auto-clean expired rules — Automatically removes products from rules that have expired or been deleted
• Schedule support — Rules can have start and end dates
• Storefront rule preservation — Optionally keeps products added by storefront-only rules without re-evaluating them
• Discount code application — Automatically applies discount codes associated with rules
• Auto-remove products — Can remove specific products from the cart when rules match
• Debug mode — Logs all evaluations and conditions to the console

How It Works

1. Activation check — Verifies the merchant's plan includes checkout features
2. Fetch automations — Retrieves all active automation rules
3. Scope filtering — Keeps only rules scoped to checkout or global
4. Build input — Constructs an input object from cart lines, cost, customer, attributes, discount codes, payment options, and delivery groups
5. Rule evaluation — For each automation, evaluates the rule conditions against the input
6. Cart mutations — Based on rule results, adds/removes products, applies discounts, or presents the gift picker modal

Next Steps

• Settings Reference — All merchant-configurable settings
• Behavior Deep Dive — Detailed rule evaluation and cart mutation logic