> ## 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.

# Search the docs

> shopify_discount_docs_search searches the AIOD product documentation, or reads one page in full.

Searches this documentation, or reads one page of it.

<Info>
  **Tool name:** `shopify_discount_docs_search` · **Previously:** `search_aiod_docs` · **Read-only, touches no store data**
</Info>

## When to use it

For the "how does AIOD behave?" questions that surround a promotion:

* Installing and enabling AIOD in the theme
* Plans and pricing
* How discounts stack with Shopify discount codes and other automatic discounts
* Behaviour in the cart, at checkout, and in [Shopify POS](/docs/app/pos-discounts)
* Scheduling a sale
* The storefront [widgets](/docs/app/discount-widgets) — progress bars, gift drawers, bundle and upsell widgets, strike-through pricing
* Troubleshooting a discount that isn't showing or isn't applying

**Not for building a config.** Field shapes come from [Read the discount schema](/docs/mcp-server/tools/shopify-discount-config-schema), and the store's own discounts from [Find discounts](/docs/mcp-server/tools/shopify-discount-find).

## Parameters

Pass either `query` or `page`. Passing neither returns nothing.

| Name      | Type   | Required | What it does                                                                             |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| `query`   | string | No       | Search terms. Returns ranked pages with excerpts.                                        |
| `page`    | string | No       | A page path from a search result, to read it in full. Wins over `query` if both are set. |
| `section` | string | No       | A heading within `page`, to read just that part.                                         |

The intended pattern is search, then read: get a path from a search result rather than guessing one.

## What comes back

Searching:

```json theme={null}
{
  "results": [
    {
      "title": "Free Gift with Purchase",
      "page": "templates/free-gift-with-purchase.mdx",
      "excerpt": "Use this template to auto-add gifts, let customers choose gifts..."
    }
  ]
}
```

Up to 8 results, with excerpts trimmed to fit a combined budget of about 6,000 characters.

Reading a page:

```json theme={null}
{
  "page": "templates/free-gift-with-purchase.mdx",
  "content": "---\ntitle: \"Free Gift with Purchase\"\n...",
  "truncated": false
}
```

`content` is `null` if the page can't be read. With `section` set, the read starts at that heading and returns the part that follows; a heading that doesn't match falls back to the whole page.

## Things people ask that land here

* "How do AIOD discounts combine with Shopify discount codes?"
* "Why isn't my volume bundle widget showing on the product page?"
* "Do automatic discounts work on Shopify POS Lite?"
* "What does 'Show discounted price crossout' do?"

## Limits

* Search words are sent to AIOD's documentation site to run the search. **Words only** — no store data goes with them.
* This is product documentation, not the configuration schema. Don't build a `config` from it.