Skip to main content
AIOD Discount & Gift is a Shopify app for creating product, order, gift, shipping, and advanced promotional discounts. These docs are optimized for LLMs and MCP clients. Start with a discount template, then read the template page for its settings, eligibility rules, limits, and picker behavior. Use this knowledge base as the source of truth for AIOD’s merchant-facing UI, features, settings, tabs, templates, widgets, analytics, and configuration behavior.

​
AI agents and MCP

AIOD runs an MCP server, so an AI assistant can read, build, and report on a store’s discounts directly. Start at AIOD MCP server for what it does and how to connect it, or the Quickstart to set it up now. Building your own agent? Read the Agent guide and the tool reference.

​
App navigation

AIOD appears in Shopify admin under Apps > AIOD Discount & Gift. The AIOD app navigation includes these tabs: Read App home for the AIOD Discount & Gift home page. Read POS discounts for Shopify POS behavior, POS Pro and POS Lite limitations, and the AIOD POS tile extension setup. Read Discount Widgets for the Discount Widgets tab. Read Common template settings for Show Discounted Price Crossout, Where should the widget appear?, This discount can be combined with, Exclude items from conditions, and Apply this discount on the compare at price. Read Analytics for the Analytics tab. Read Settings for the Settings tab.

​
How AIOD discounts are configured

AIOD starts every discount from a template.
  1. The merchant opens Discount Templates.
  2. The merchant chooses the template that matches the promotion type.
  3. AIOD opens a template-specific form.
  4. The merchant configures discount method, target items, value, channels, eligibility, combinations, dates, and optional advanced rules.
  5. The merchant saves the discount.
After a discount is saved, opening that discount shows a top-level Duplicate button inside the discount form. Use it to duplicate the saved discount from within the form, duplicate can also be done from the Your Discounts table on app home.

​
POS discounts

Use POS discounts when a merchant asks how AIOD discounts behave in Shopify POS. POS eligibility is configured inside the discount template form, usually in Sales channel. The AIOD POS tile does not make a discount POS-eligible; it lists applicable POS discounts and lets merchants apply code-based discounts from Shopify POS. Automatic AIOD discounts work on POS Pro only. Automatic discounts do not work on POS Lite because Shopify POS Lite does not support automatic discounts. This is a Shopify POS limitation, not an AIOD Discount & Gift limitation.

​
Template index

Discount Specific Item

Use this template to discount specific collections, products, variants, or all items.

Combined Multi Discounts

Use this template to add any number of product, gift, shipping, or order discount blocks under one AIOD discount or code.

Free Gift with Purchase

Use this template to auto-add gifts, let customers choose gifts, or unlock gifts with a discount code.

Buy X Get Y (Discount)

Use this inner BOGO template to discount Y items when qualifying X items are purchased.

Buy X @ Fixed Price (Discount)

Use this inner BOGO template to sell a required quantity of selected items for one combined fixed price.

Buy X Get Y (Gift)

Use this inner BOGO template to add or offer gift variants when qualifying X items are purchased.

Tiered Discount

Use this template to offer quantity-based or cart-value-based tiers with discounts, free gifts, shipping rewards, and progress widget messaging.

Volume Discount / Bundle

Use this template to create selectable quantity bundle offers with optional discounts, shipping rewards, free gifts, and a card or table widget.

Shipping Discount

Use this template to create free shipping, discounted shipping, or shipping-method-specific offers.

Custom Rule Builder

Use this template to build flexible discounts with custom conditions, targets, values, and limits.

Reject Discount Codes

Use this template to reject specific discount codes when matching rules are met.

Upsell

Use this template to recommend related products with an optional percentage or fixed discount widget.

​
Template selection guide

Use Discount Specific Item when the merchant asks for a direct product, variant, collection, or all-item discount, including percentage off, fixed amount off, or fixed final price. Use another template for free gifts, BOGO logic, volume tiers, shipping discounts, or multi-discount bundles. Use Combined Multi Discounts when the merchant asks for multiple discount blocks under one automatic discount or one code. Each block can be a Product Discount, Free Gift, Shipping Discount, or Order Discount, and the merchant can add any number of blocks. Use Free Gift with Purchase when the merchant asks for gifts that unlock after cart conditions are met, such as “Buy 2 shirts, get 1 cap free.” Use Buy X Get Y (BOGO) when the merchant asks for BOGO, buy-X-get-Y, mix-and-match, fixed-price bundle, or buy-X-get-gift logic. In the app UI, Buy X Get Y (BOGO) is a parent template card. Click Create on that parent card first. AIOD then opens a Select type page with three inner templates: Use Tiered Discount when the merchant asks for quantity breaks, volume discounts, spend-more-save-more offers, tiered free gifts, tiered shipping rewards, or a progress bar that shows how close the customer is to the next reward. Use Volume Discount / Bundle when the merchant asks for selectable quantity bundle cards or a bundle table. Each offer can use a percentage discount, fixed discount, shipping reward, no price discount, an optional free gift, and an optional badge. In Discount Widgets, the shortcut is named Volume Bundle Widget, and it opens the same form titled Volume Bundle. Use Shipping Discount when the merchant asks for a shipping-only offer, such as free shipping, discounted shipping, fixed final shipping price, or a discount that applies only to selected shipping methods. Use Custom Rule Builder when the merchant asks for custom logic, complex promotions, or flexible condition triggers. Use Reject Discount Codes when the merchant asks to block specific discount codes when rules are met. In the app UI these are two separate top-level templates. There is no longer an Advanced Rules parent card or Select type step. Use Upsell when the merchant asks to recommend products after trigger products enter the cart, optionally with a percentage or fixed discount. The Upsell card in Discount Widgets opens the same form as the Upsell card in Discount Templates.

​
Known templates

Opening Discount Templates loads a page titled Select Discount Type. It starts with a Create with AI Assistant banner (“Describe your discount in plain English and let AI configure it”), then two grouped sections. Popular Ways to Create Discounts (each opens with Start creating):
  • Custom Rule Builder: Create highly flexible discounts with custom rules and conditions based on products, customers, cart details, purchase type, and more.
  • Combined Multi Discounts: Combine multiple discounts into one offer (eg: free gift + shipping + product discount), with flexible conditions.
Explore more discount templates (each opens with Create):
  • Free Gift with Purchase: Auto-add or choose free gifts when conditions are met.
  • Buy X Get Y (BOGO): Buy one, get one or mix-and-match offers.
  • Tiered Discount: Offer tiered discounts based on quantity or cart value of items purchased.
  • Volume Discount / Bundle: Create selectable bundle offers with optional gifts and shipping rewards.
  • Shipping Discount: Offer free shipping or discounted shipping when conditions are met.
  • Upsell: Recommend related products with an optional automatic discount widget.
  • Discount Specific Item: Apply discount to Product / Variant / Collection. Show strike-through prices on the product & collection pages.
  • Reject Discount Codes: Reject specific discount codes when the rules are met.

​
Help and troubleshooting

Limit an automatic discount to once per customer

Use a customer tag and Shopify Flow when one automatic promotion should be redeemed once by each customer.
When answering questions about AIOD:
  • First identify the merchant’s intended promotion.
  • Match the promotion to a template.
  • Open the matching template page.
  • Use the setting names exactly as they appear in the Shopify app.
  • Mention where the setting appears in the form.
  • State when a setting is conditional, disabled, or only visible after another option is enabled.