> ## Documentation Index
> Fetch the complete documentation index at: https://aiodapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatic discounts

> Create percentage, fixed-amount, and fixed-price Shopify discounts through an AI agent connected to AIOD.

An AI agent connected to AIOD can create automatic Shopify discounts for you: a percentage off, an amount off, or a fixed final price — on one product, one variant, a collection, or everything in the store.

*Automatic* means it applies in the cart and at checkout with no code for the shopper to type.

## Just ask

<CodeGroup>
  ```text You theme={null}
  20% off everything in the Summer collection.
  ```

  ```text You theme={null}
  Take $10 off the Classic Tee.
  ```

  ```text You theme={null}
  Sell the starter kit at a flat $49.
  ```

  ```text You theme={null}
  Free shipping on all orders.
  ```

  ```text You theme={null}
  10% off sitewide for the whole of July.
  ```
</CodeGroup>

## Which template gets used

| Template          | When                                                                          |
| ----------------- | ----------------------------------------------------------------------------- |
| `specific_item`   | The discount always applies to one target, with no separate eligibility rule. |
| `custom_discount` | There's a real condition attached, or more than one target in the same rule.  |
| `custom_shipping` | It applies to shipping rather than to products or order value.                |

The moment a genuine gate appears — "only for VIP customers", "only over \$100" — it moves from `specific_item` to `custom_discount`. See [Conditional discounts](/docs/mcp-server/use-cases/conditional-discounts).

For the settings themselves, the merchant-facing pages are [Discount Specific Item](/docs/templates/discount-specific-item), [Custom Rule Builder](/docs/templates/custom-rule-builder), and [Shipping Discount](/docs/templates/shipping-discount).

## What the agent does

1. Reads AIOD's template contracts, then the reward shapes.
2. Picks `specific_item` for a plain target, or `custom_discount` as soon as there's a real condition.
3. Sets the reward: the items being discounted and the value. A condition is an eligibility gate, never a stand-in for the target.
4. Sets active dates if you mentioned a period.
5. Drafts it — validated and cart-simulated — and hands you a link.
6. Creates it in test mode only if you asked.

## Worth knowing

* `specific_item` targets exactly one of: a product, a variant, a collection, or all items.
* A single rule is locked to one discount type — all product-level, all order-level, or all shipping. Never mixed. For several reward kinds in one offer, it uses `combined_discount`.
* Shipping rewards use shipping method targets (all methods, specific ones, or all except selected ones), never product targets.