AI Assistant

Overview

The AI Assistant lets you create and modify discount configurations using plain language descriptions. Instead of manually building rule groups, you describe the promotion you want and the AI generates a valid configuration for you.

• Plan: Pro and Enterprise
• Access: Discount detail page → AI Assistant panel
• Billing: Credit-based — credits included monthly, additional packs available for purchase
• Rate limit: 20/hr (Pro), 40/hr (Enterprise)
• Models: Standard (2 credits/request) | Expert (5 credits/request, Pro and Enterprise)

How to Access

1. Open the app in Shopify Admin.
2. Navigate to any existing discount or create a new one.
3. On the discount detail page, find the AI Assistant panel on the right side.
4. Select a mode and enter your prompt.

The AI Assistant panel is visible on Pro and Enterprise plans.

Modes

Generate

Creates a complete discount configuration from scratch based on your description. Use this when starting a new discount and you want the AI to produce the full rule group structure.

When to use: You have a promotional concept in mind but want to skip manual configuration.

Example prompt:

“Give all customers with the VIP tag 20% off products tagged ‘premium’. Limit to 3 rule groups max.”

Update

Applies targeted changes to your existing configuration. The AI reads your current setup and modifies only the parts you describe, leaving the rest intact.

When to use: You have a working configuration and need to adjust specific fields — a discount value, a condition, a filter — without rebuilding from scratch.

Example prompt:

“Change the discount from 20% to 25% and add a minimum cart subtotal of $50.”

Refine

A multi-turn conversation mode where you can iteratively adjust the configuration across multiple messages. Each message builds on the previous output.

When to use: You want to explore variations, ask follow-up questions, or make incremental adjustments before committing to a final configuration.

Example prompt (first turn):

“Create a buy 2 get 1 free offer on products tagged ‘clearance’.”

Example prompt (follow-up):

“Cap it at 2 sets maximum and restrict it to customers tagged ‘member’.”

Expert

Uses our advanced AI model for more sophisticated reasoning and complex discount logic. Expert mode handles ambiguous requirements, multi-layered promotions, and edge cases better than Standard mode.

Plan: Pro and Enterprise (5 credits per request)

When to use: Your promotion involves complex condition combinations, multiple interacting rule groups, or nuanced business logic that benefits from deeper reasoning.

Example prompt:

“Create a loyalty program discount: VIP customers get 25% off premium items, Gold customers get 15% off, and Silver customers get 10% off. Each tier should exclude items already on sale, and apply only when cart subtotal exceeds $100. Use the ‘first match’ strategy.”

Validation Pipeline

Every AI-generated configuration passes through a 4-stage validation pipeline before being applied:

1. JSON parse — Confirms the output is valid JSON and can be parsed.
2. Zod schema — Validates the structure against the discount configuration schema (required fields, correct types, valid enum values).
3. Semantic checks — Verifies logical consistency: buy quantities are positive, discount values are in range, filter types reference valid fields, etc.
4. Pre-aggregation fix — Ensures all tags, collection IDs, and variant IDs referenced in rule groups are correctly aggregated into the top-level query fields that the Shopify Function requires.

If a stage fails, the AI Assistant returns an error with details. You can revise your prompt and try again.

Usage & Billing

Credit Allocation per Plan

Welcome Bonuses

New subscribers receive a one-time credit bonus:

Credit Cost per Request

Purchasable Credit Packs

A “generation” is any request sent to the AI Assistant, regardless of mode (Generate, Update, Refine, or Expert). Each turn in a Refine conversation counts as one generation.

Monthly included credits reset at each billing period and do not roll over. Purchased credit packs never expire. Rate limits: 20 requests/hour (Pro), 40 requests/hour (Enterprise). If you hit the limit, wait and try again.

Writing Effective Prompts

Be specific about:

• Which products qualify — Use product tags, collections, or “all products” explicitly.
• Who qualifies — Customer tags, market/country, or no restriction.
• The discount amount — Percentage or fixed amount, and what it applies to.
• Any limits — Maximum sets, rule group count, or spending thresholds.

Examples by Function Type

Conditional Discount:

“10% off all products tagged ‘sale’ for customers tagged ‘member’ when cart subtotal is over $75.”

Tiered Discount:

“Buy 3–5 items: 10% off. Buy 6–9 items: 15% off. Buy 10 or more: 20% off. Apply to all products.”

Buy X Get Y:

“Buy 2 items from the ‘Coffee’ collection, get 1 item tagged ‘pastry’ at 50% off. Limit to 1 set per cart.”

Bundle Discount:

“20% off when the cart contains at least 1 item from collection ‘Skincare-Cleanser’ and 1 item from collection ‘Skincare-Moisturizer’.”

Next Steps

• Billing & Pricing — AI generation billing details and plan comparison.
• Conditional Discount — Manual configuration reference.
• Buy X Get Y — Buy-one-get-one configuration reference.