> For the complete documentation index, see [llms.txt](https://orbit-b2b.gitbook.io/orbit-b2b-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbit-b2b.gitbook.io/orbit-b2b-docs/wholesale-pricing/create-rule.md).

# Create a rule

## Steps

1. Go to **Wholesale Pricing** in the app menu
2. Click **Create rule**
3. Fill in the rule details (see fields below)
4. Click **Save**

***

## Rule fields

### General

| Field        | Description                                                      |
| ------------ | ---------------------------------------------------------------- |
| **Title**    | Internal name for your reference (not shown to customers)        |
| **Status**   | Active or Inactive. Inactive rules are saved but not applied     |
| **Priority** | Higher number = wins when multiple rules match the same customer |

### Discount

| Field                   | Description                                            |
| ----------------------- | ------------------------------------------------------ |
| **Discount type**       | Percent off / Amount off / Fixed price                 |
| **Discount value**      | The percentage, dollar amount, or fixed price          |
| **Per-variant pricing** | Enable to set a different discount per product variant |

### Customer eligibility

| Option                  | Who it targets                    |
| ----------------------- | --------------------------------- |
| **All customers**       | Everyone (including guests)       |
| **Logged-in customers** | Any customer with an account      |
| **Guest visitors**      | Customers not logged in           |
| **Customer tags**       | Only customers with specific tags |

Optionally, add **Excluded customers** to block specific individuals even if they match the tag.

### Product eligibility

| Option                   | What it targets                       |
| ------------------------ | ------------------------------------- |
| **All products**         | Your entire catalog                   |
| **Specific products**    | Search and select individual products |
| **Specific collections** | All products in selected collections  |
| **Product tags**         | All products with matching tags       |

### Active dates

Set a **Start date** and/or **End date** to automatically activate or deactivate the rule on a schedule.

***

## Tips

* Give your rules descriptive titles like `"Gold Members — 25% off All Products"` so they're easy to manage later.
* Use **Priority** to control which rule wins when customers qualify for multiple rules. E.g. a VIP rule with priority 10 beats a general rule with priority 1.
* To temporarily pause a rule without deleting it, set **Status → Inactive**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/wholesale-pricing/create-rule.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.