Frequently Asked Questions

This page answers the most common questions about Alfo - Functions. If your question is not covered here, check the Troubleshooting page for issue-specific guidance.

1. What discount types does the app support?

Alfo provides 4 specialized discount function types:

TypeDescription
ConditionalIf-then discount rules based on conditions.
Volume & TieredEscalating discounts based on quantity or spending thresholds.
Buy X Get YBuy a set of items, get other items discounted or free.
BundleDiscount applied when specific product combinations are in the cart.

Each function type is optimized for a specific discount pattern. See the Introduction for a comparison table.

2. Can I use multiple conditions on one rule?

Yes. Each rule group supports up to 16 condition types, and you can combine them using AND or OR logic. With AND logic, all conditions must pass for the rule group to apply. With OR logic, any single condition is sufficient.

For example, you can require that the customer has a “VIP” tag AND the cart subtotal is over $100, or you can allow either condition to trigger the discount.

3. Which Shopify plans does the app work on?

Works on the Basic plan and higher. Checkout upsells and some payment options need Shopify Plus.

Alfo’s discount, validation, delivery, and payment rules run as Shopify Functions. Shopify Functions run on all plans except Shopify Starter, so these rules do not run on a Shopify Starter store. The Shopify Starter plan is not the same as Alfo’s Starter plan.

These features need Shopify Plus:

FeaturePlan needed
Checkout upsellsShopify Plus only. The upsell block shows in the information, shipping, and payment steps, and Shopify allows extensions in these steps only on Shopify Plus.
Payment termsShopify Plus only.
Order reviewShopify Plus only, for B2B purchases.
Hiding a payment method in some placements onlyShopify Plus only.
Several product discounts on one cart lineShopify Plus only.

4. Can I combine discounts from different functions?

Yes. Shopify allows multiple discounts to apply to the same order, controlled by the combinesWith settings on each discount. You configure these settings when creating the discount in Shopify Admin:

SettingEffect
combinesWith.productDiscountsAllow stacking with other product discounts.
combinesWith.orderDiscountsAllow stacking with other order discounts.
combinesWith.shippingDiscountsAllow stacking with shipping discounts.

For example, you can have a “20% off tagged products” discount (Conditional) combine with a “Free shipping over $50” discount (Conditional) by enabling the appropriate combinesWith toggles on both discounts.

5. What happens if I downgrade my plan?

Existing discounts continue to function at checkout. The WebAssembly function does not check your billing tier at runtime, so your customers will not experience any disruption.

However, the rule builder UI will block you from creating or editing features that are not included in your new plan. For example, if you downgrade from Pro to Starter, you cannot edit existing Volume & Tiered discounts, but they continue to apply at checkout.

6. Is there a limit on rule groups?

Yes. The maximum number of rule groups depends on your plan:

PlanMax Rule Groups per Discount
Starter10
Pro20
Enterprise40

This limit applies per discount: each discount can contain up to the plan’s maximum number of rule groups. Since Shopify allows up to 25 automatic discounts per store, a single discount with multiple rule groups effectively replaces what would otherwise require multiple separate discounts. Existing rule groups beyond the limit are not deleted when you downgrade, but you cannot create new ones until you are within the limit.

7. Can I apply discounts to shipping?

Yes. All four discount functions (Conditional, Volume & Tiered, Buy X Get Y, and Bundle) support the Shipping discount class. You can create discounts that reduce or eliminate shipping costs based on conditions like cart subtotal, customer tags, or the buyer’s country.

To create a shipping discount, set the target to shipping with a scope of "all" (all delivery options) or a specific scope. A 100% percentage discount on shipping effectively makes shipping free.

Note: Conditional and Volume & Tiered shipping discounts check only cart-level conditions, so a product-level condition (like productTag) has no effect on their shipping discount. For Buy X Get Y and Bundle, the shipping discount also needs enough matching items: a complete bundle, or enough items for at least one get item. Product-level conditions decide which lines count toward that bundle or set.

8. How does the “first” vs “all” strategy work?

The strategy controls how the function handles multiple matching rule groups within a single discount.

With "first" strategy, the function evaluates rule groups in order and stops at the first match. Only the first qualifying rule group’s discount is applied. Use this for priority-based rules where a higher-priority group should prevent lower-priority groups from applying.

With "all" strategy, the function evaluates every rule group, and every matching rule group makes its discount. Product discounts of several rule groups add up only when Product discount stacking is set to Apply all matching discounts. By default, Shopify keeps only the highest product discount. Order discounts of one discount never stack. See Selection Strategies for two exceptions. Use this when rule groups are independent and should combine.

Example: with "first" strategy and two rule groups (VIP 30% off, then General 10% off), a VIP customer gets 30% off and evaluation stops. With "all" strategy, a qualifying customer can receive both discounts only when they are product discounts and Product discount stacking is set to Apply all matching discounts. With the default Apply highest discount, or with two order discounts, the customer gets only the 30%.

9. Can I target specific products or collections?

Yes. You can target specific products using product-level conditions:

ConditionFilters by
productTagProduct tags (e.g., only items tagged “sale”).
collectionCollection membership (e.g., only items in the “Summer Essentials” collection).
productSpecific product IDs.
productVariantSpecific variant IDs.

When using product-level conditions with a product target, set the scope to "filtered" to apply the discount only to matching items. Setting the scope to "all" applies the discount to every item in the cart regardless of product conditions.

10. What are rejection rules?

Rejection rules let you block discount codes when specific conditions are met. Unlike regular rule groups that grant discounts, rejection rules prevent codes from being used.

Example: An automatic Alfo discount gives customers with the “staff” tag 40% off. You add a rejection rule to it with a customerTag condition using the hasNone operator for the “staff” tag. When a customer without that tag enters a discount code, the code is rejected with a custom message like “This discount is for staff members only.” (see Staff Discount with Code Rejection).

Rejection rules are evaluated before regular rule groups. When a rule matches, the function rejects the entered codes and then goes on to the rule groups. Rejection rules work only on an automatic Alfo discount: when the Alfo discount is itself a code discount, Shopify marks no entered code as rejectable, so its rejection rules reject nothing. Rejection rules are available on the Pro plan and above. See Rejection Rules.

11. Does the app support discount codes?

Yes. Alfo supports both automatic discounts (applied automatically at checkout) and code-based discounts (applied when the customer enters a code).

Both activation methods are available across all four function types. The choice between automatic and code-based is made when you create the discount in Shopify Admin, not within the rule builder.

12. How does Buy X Get Y allocate discounts?

By default, the BXGY function gives the discount to the cheapest qualifying get items first. Here is how it works:

  1. The function identifies all cart lines that match the buy filter (buyItemFilter) and the get filter (getItemFilter).
  2. It works out how many get items the cart earns from buyQuantity, getQuantity, and maxSets. A unit counts as a buy item or as a get item, never as both, and the last set can be partial.
  3. The discounted items (the “get” items) are picked in the Get item selection order: Cheapest items first (the default), Most expensive items first, or Cart order.

For example, in a “Buy 2 Get 1 Free” promotion with items priced at $30, $20, and $10, the $10 item is the free one with the default order, because it is the cheapest.

13. Can bundle components overlap?

Yes. A single cart line can match multiple bundle components, but each unit fills one component slot only. For example, your bundle requires 2 items from Collection A and 1 item from Collection B, and a product belongs to both collections. A line with 3 units of that product completes the bundle: two units fill A and one fills B. A line with 2 units does not, because no unit counts for both components. The function finds the largest number of complete bundles that the cart’s units can fill.

14. What is pre-aggregation?

Pre-aggregation is how the app collects metadata from your rule configurations and includes it in the Shopify Function’s input query.

When you configure conditions that reference tags or collection IDs, the UI aggregates all referenced values into three top-level lists in the JSON configuration: collectionIds, productTags, and customerTags. Shopify fills the variables of the function’s input query from these lists, so the function receives the tag and collection answers it needs at checkout.

This is necessary because Shopify Functions have a fixed input query that must declare upfront which data it needs. The function cannot dynamically request additional data during execution. Pre-aggregation ensures the function always has the data it needs to evaluate your conditions.

You do not need to manage pre-aggregation manually. The rule builder UI handles it automatically when you save your configuration.

15. Is there a free trial?

Yes. The Starter and Pro plans include a 7-day free trial. Enterprise has no trial.

PlanWho gets the trial
StarterEvery new Starter subscription that you start with no active plan.
ProA store’s first Pro subscription only. A later Pro resubscription or a reinstall has no trial.
EnterpriseNo trial.

A switch from an active plan to another plan never starts a trial. The trial starts when you approve the plan. During the trial, the features of the plan you chose work as on a paid subscription, except the welcome credits: on the Pro trial, the 50 welcome AI credits arrive when the trial ends, so AI generation during the trial needs a purchased credit pack. You are not charged if you cancel before the trial ends.

16. Are annual plans available?

Yes. Every plan has a monthly price and a yearly price:

PlanMonthlyAnnual
Starter$39/mo$400/yr
Pro$99/mo$1,000/yr
Enterprise$299/mo$3,000/yr

Annual plans are billed as a single upfront charge. To switch, open Billing in the app navigation. See the Pricing page for details.

17. What is the AI Assistant?

The AI Assistant lets you generate, update, refine, and explain discount configurations using natural language. Generate, Update, Refine, and Expert are in the AI Assistant panel on the discount detail page. Explain is the Explain with AI button on the discount, payment customization, delivery customization, and validation pages.

There are five modes:

ModeWhat it doesPlan
GenerateDescribe the discount you want from scratch and the AI creates the full configuration.Pro and Enterprise
UpdateDescribe changes to your existing configuration and the AI applies them.Pro and Enterprise
RefineHave a multi-turn conversation to iteratively adjust the configuration.Pro and Enterprise
ExpertUse an advanced AI model for complex discount logic.Pro and Enterprise, 2 credits/request
ExplainGet a plain-language explanation of your current configuration.All plans including Starter, free with rate limits

Every AI result (Generate, Update, Refine, Expert) goes through format, schema, rule, and ID checks. A failed check makes the AI try again, up to two more times, before the panel shows an error.

See the AI Assistant guide for full documentation.

18. How does AI generation billing work?

AI Explain is free on all plans (including Starter), subject to rate limits: 10 successful explanations per 2 hours on Starter, 30 per hour on Pro and Enterprise. A second cap counts every request, failed ones too, at three times these numbers.

AI Generation (Generate, Update, Refine, Expert) uses a credit-based billing system available on Pro and Enterprise plans:

TierCredits and limits
Pro50-credit welcome bonus (one-time). No monthly credit grant. Standard + Expert modes (1 or 2 credits/request).
Enterprise Monthly100-credit welcome bonus (one-time). No monthly credit grant. Standard + Expert modes (1 or 2 credits/request).
Enterprise Annual100-credit welcome bonus (one-time). Once per calendar month, a balance below 200 credits is raised to 200. At most 200 successful AI generations per calendar month. Standard + Expert modes (1 or 2 credits/request).
Additional creditsPurchase credit packs: Starter Pack (50 credits/$20), Pro Pack (110 credits/$40), Power Pack (180 credits/$60). Purchased credits never expire.

Credit packs are one-time purchases. Shopify bills one-time app charges on separate invoices, not on your regular Shopify subscription bill.

19. What is rule scheduling?

Rule scheduling lets you set date-based activation windows on individual rule groups within a discount. A rule group with a schedule is only active during the specified date range. Outside that window, the rule group is skipped as if it does not exist.

This is available on Pro and Enterprise plans.

Common use cases:

Use caseExample
Seasonal salesA holiday discount rule group that activates on November 15 and deactivates on January 2.
Flash promotionsA weekend-only discount that runs Friday through Sunday.
Campaign launchesPre-configure a promotion to go live at a specific date without manual intervention.

Scheduled rule groups coexist with non-scheduled rule groups in the same discount. If a discount has a mix of scheduled and unscheduled rule groups, the strategy (first/all) applies only to the rule groups that are currently active.

20. Can I use the app with multiple Shopify markets?

Yes. The market condition checks the buyer’s country code. It supports two operators. With isAny, the buyer’s country must match any of the listed country codes. With isNone, the buyer’s country must not match any of the listed country codes. Delivery customization and cart and checkout validation also have a deliveryCountry condition, which reads the country of the shipping address.

Country codes use the ISO 3166-1 alpha-2 format (e.g., “US”, “CA”, “GB”, “DE”). This condition is available in all four function types.

You can use the market condition to create region-specific promotions, restrict discounts to domestic orders, or offer different discount tiers by country.

21. What are gift card exclusions?

Alfo’s discount functions never discount gift cards. Gift card line items are always excluded from product discounts.

When the function evaluates cart lines for product discounts, gift card lines are automatically filtered out and never receive a discount. This applies regardless of your conditions, targets, or discount configuration.

Order discounts leave gift-card lines out of the discounted subtotal too. Shipping discounts are not affected: they apply to delivery options.

22. What is Cart & Checkout Validation?

Cart & Checkout Validation blocks checkout based on cart, customer, product, or delivery-address conditions. It uses most of the condition types of discount rules, plus delivery-address conditions: subtotal thresholds, customer tags, product tags, delivery country, and more. It has no market, product, or productVariant condition.

Rule content is authored inside Shopify Admin → Settings → Checkout → Checkout rules, not inside the Alfo app. The Alfo app provides a read-only list where you can see every validation, toggle it, delete it, or ask the AI to explain it. This split exists because Shopify’s native Checkout settings is the canonical place to manage these rules.

Validation is available on all plans: 5 rules on Starter, 10 on Pro, 30 on Enterprise. See the Cart & Checkout Validation docs for a full walkthrough.

23. How are Checkout Upsells different from discounts?

A checkout upsell adds a product to the cart. It does not apply its own discount. The offer renders inside Shopify Checkout, and when the buyer clicks its add button, the chosen variant is added to their cart at its normal price.

If you want the offered product to appear at a discount, pair the upsell with a matching Discount Function (for example, a Conditional Discount that targets the upsell’s product tag). The upsell moves the product into the cart; the discount prices it.

Checkout Upsells are available on Pro (10 rules) and Enterprise (30 rules), on Shopify Plus stores only. See Checkout Upsells for details on placement, offer configuration, and trigger conditions.

24. What’s the Bundle Builder and how is it different from Bundle Discount?

Bundle Discount is the cart-time function that evaluates whether a complete bundle is in the cart and applies the discount. Bundle Builder is the storefront experience that helps shoppers assemble a qualifying bundle one component at a time.

In practice, the Bundle Discount defines what the bundle is (components, filters, discount value); the Bundle Builder is a theme block that renders a multi-step picker matching those components. When the shopper finishes, every item is added to the cart at once and the Bundle Discount applies the savings.

Bundle Builder requires the Enterprise plan. See Bundle Builder for setup instructions.

25. What does the Analytics Dashboard track?

The Analytics Dashboard tracks upsell acceptances and bundle acceptances that result in completed orders. Each panel shows total revenue, accept count, average order value, a daily stacked revenue chart (top 5 entities + “Other”), a daily trend line, and a sortable per-rule or per-bundle table.

Time ranges: 7 days, 30 days (default), and 90 days. Data is anonymized. Alfo does not store customer IDs with analytics records.

Access: Starter plans see an upgrade banner, Pro plans see the Upsells tab, and Enterprise plans see both the Upsells and Bundles tabs. Upsells need a Shopify Plus store. See Analytics Dashboard.

26. Does the Chat Assistant store my conversations?

No. Your chat history is stored only in your browser (in localStorage). Every request sends your latest messages to our AI provider for a response, and nothing about the conversation is retained on Alfo’s servers afterward.

Clearing the chat from the popup removes it from your browser. Our GDPR customers/redact and shop/redact webhooks are no-ops for chat specifically because there’s nothing stored to redact.

27. Is the Chat Assistant really free on Starter?

Yes. The Chat Assistant is free on every plan. The only thing that varies by tier is the rate limit:

TierHourlyDaily
Starter30150
Pro80500
Enterprise1501,500

There is no credit deduction and no cap beyond the rate limit. See Chat Assistant.

PageWhat it covers
TroubleshootingDiagnose specific issues with discount behavior.
Core ConceptsReview the foundational concepts behind the app.
PricingCompare plans and pricing.