Checkout Progressive Extension

Overview

The autocart-checkout-progressive extension runs Progressive Tiered and Cyclic automations inside Shopify checkout. It is separate from autocart-checkout-gift, which handles standard checkout and global rules.

The extension renders no customer-facing interface. Its checkout block hosts the evaluation engine, which reacts to checkout cart changes and keeps Progressive gifts synchronized.

Progressive functionality is available on the Advanced and Ultimate plans, including their annual variants. The extension checks the autocartProgressive.is_active app metafield before retrieving or executing rules.

Setup

1. Open the checkout editor in Shopify admin.
2. Add the AutoCart Checkout Progressive app block to checkout.
3. Optionally enable Debug in the block settings.
4. Save the checkout customization.

The block and the Progressive plan entitlement must both be active for checkout progression to run.

Evaluation Flow

1. Read the Progressive entitlement from app metafields.
2. Retrieve active Progressive automation metaobjects through Shopify's API.
3. Build the current checkout input from cart lines, costs, cart attributes, localization, discounts, payment selection, delivery groups, and customer tags.
4. Resolve product tag or collection membership when required by a rule.
5. Exclude AutoCart gift lines from qualifier totals.
6. Evaluate Tiered or Cyclic progression.
7. Queue removals, quantity changes, and additions sequentially through applyCartLinesChange.

Sequential processing prevents overlapping checkout mutations from losing updates.

Strategies

Tiered

Every configured step is evaluated against the qualifying cart. Gifts are added when a threshold is met and removed when it is no longer met. A later step can remove gifts from previous steps when Override previous steps is enabled.

Cyclic

The extension calculates how many times the threshold is met, applies the optional cycle limit, and multiplies each configured gift quantity by the earned cycle count. Existing gift quantities and discount metadata are updated when the target changes.

Qualification Sources

Checkout supports the same qualifier selection as the Progressive theme embed:

• All products
• Specific products
• Product tags
• Collections

Product tags and collection memberships are queried for the products currently in checkout. Collection pagination is followed when a product belongs to more than 250 collections. If required qualification data is unavailable, the affected automation is left unchanged rather than evaluated with incomplete data.

Outdated Gift Cleanup

When the active automations load, the extension scans lines carrying _autocart_prog. Gifts whose rule is now draft, deleted, or otherwise absent from the active configuration are queued for removal.

Settings

Unlike the Progressive theme embed, the checkout extension does not reload the page, invoke a theme callback, or publish DOM events. Shopify Checkout UI Extensions use reactive checkout APIs and applyCartLinesChange instead.