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

# Pricing rules

> Set a different price for selected products on certain channels, without editing each item by hand.

Pricing rules change the price of selected products when a condition is met, without you editing each item or creating duplicate SKUs. A rule might add a markup on delivery apps, or set a flat promotional price. Find them at **Menu builder** > **Pricing rules**, or go straight to the [Pricing rules page](https://portal.atlas.kitchen/pricing-rules).

Rules are ranked. A rule higher in the list applies before the ones below it, which matters when more than one rule could touch the same item.

<Info>
  Pricing rules are still being expanded. Today they apply **by channel only**, and only **aggregator channels (GrabFood and Foodpanda)** can be selected. Support for all Atlas channels, individual outlets, time of day, and member pricing is on the way.
</Info>

## Create a pricing rule

From **Menu builder** > **Pricing rules**, tap **Create new rule**, then fill in the form below.

<Frame caption="The pricing rule form.">
  <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-form.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=5fa67ea365909845e2e6f3aaed0c8d0b" alt="Pricing rule form with Rule name, Select items, Apply to all items, Applicable scope, Do not stack toggle, Price modifier, Channels, and Activate." width="1560" height="1426" data-path="images/menu-builder/pricing-rule-form.png" />
</Frame>

<Steps>
  <Step title="Name the rule">
    Give the rule a clear name in **Rule name**, such as "Aggregator markup" or "\$2 drinks". This is the name you'll see in the rules list.
  </Step>

  <Step title="Choose the items">
    Under **Select item(s)**, search and add what the rule applies to. You can mix three kinds of selection:

    * **Single products**, added one at a time.
    * **Reporting categories**, to cover a whole category at once (for example, all Drinks).
    * **Tags**, to cover every product carrying a given product tag or printing tag.

    To apply the rule to the entire menu, tick **Apply to all items** instead.

    <Frame caption="Search and add products one at a time.">
      <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-select-item.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=50189b77447c08a61702f814b65c1363" alt="Select items field with Japanese Hyogo Oysters selected and an items dropdown listing matching products." width="1552" height="402" data-path="images/menu-builder/pricing-rule-select-item.png" />
    </Frame>

    <Frame caption="Or pick a reporting category or product tag.">
      <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-categories-tags.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=fe12b7d52945fa68021eb5c18fcf31c6" alt="Select items field showing matching products and a Reporting categories row with Drinks category chips." width="1562" height="508" data-path="images/menu-builder/pricing-rule-categories-tags.png" />
    </Frame>

    <Tip>
      If your items aren't grouped yet, set that up first, then come back. See [Reporting categories](/menu-builder/reporting-categories) to group products, or add **Product tags** on each product (see [Create and configure menus](/menu-builder/create-menus)).
    </Tip>
  </Step>

  <Step title="Set the scope">
    Under **Applicable scope**, choose what the rule touches:

    * **Top-level products and modifiers** applies to both.
    * **Top-level products only** leaves modifier prices alone.
    * **Modifiers only** changes only the modifier prices.

    <Frame caption="Applicable scope options.">
      <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-scope.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=239dac5940b0d3894a812dacb27a02b2" alt="Applicable scope dropdown open, showing Top-level products and modifiers, Top-level products only, and Modifiers only." width="1578" height="294" data-path="images/menu-builder/pricing-rule-scope.png" />
    </Frame>
  </Step>

  <Step title="Set the price change">
    Under **Price modifier**, choose the **Adjustment type**:

    * **Increase by** or **Decrease by** changes the current price. Set **Type** to **Value** for a fixed amount, or **Percentage** for a percentage.
    * **Custom** sets an exact price, whatever the item's current price is. For example, set all drinks to a flat \$2 on GrabFood.

    Enter the figure in **Amount**.

    <Frame caption="Price modifier set to a custom flat price.">
      <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-price-modifier.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=2b903d046a0cb25cc7bf68a0d7b7973e" alt="Price modifier with Custom adjustment type selected, Type set to Value, and Amount set to 30 SGD." width="1528" height="358" data-path="images/menu-builder/pricing-rule-price-modifier.png" />
    </Frame>
  </Step>

  <Step title="Choose the channels">
    Under **Applies when** > **Channels**, add the aggregator channels the rule should run on, such as GrabFood or Foodpanda for a given brand. Channels are required, so a rule needs at least one.
  </Step>

  <Step title="Activate and save">
    Turn **Activate** on so the rule takes effect, then save. Leave it off to keep the rule as a draft.
  </Step>
</Steps>

### Stop a rule from stacking

By default, more than one rule can apply to the same item in rank order. Turn on **Do not stack with other rules** when a rule should be the final word. If it applies first, it blocks every rule below it. If a stackable rule already applied, this rule is skipped.

**Example.** You run a flat \$2 drinks price and a 10% aggregator markup, and both could land on the same coffee. To keep the coffee at \$2 and not mark it up, turn **Do not stack with other rules** on for the \$2 drinks rule and rank it above the markup. Once the \$2 price applies, the markup is skipped for that drink.

## Reorder and manage rules

All your rules sit in one list at **Menu builder** > **Pricing rules**. Drag a rule by its handle to change its rank. A rule higher in the list applies first. The list also shows each rule's price modifier, what it applies to, its scope, whether it's active, and whether it stacks.

<Frame caption="The pricing rules list, ordered by rank.">
  <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rules-list.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=508e6610aba1aa39314325daac7f8a09" alt="Pricing rules list with Rank, Rule name, Price modifier, Applied to, Applicable scope, Active, and Stackable columns. Rule 1 is $2 drinks and not stackable; rule 2 is Aggregator markup and stackable." width="3020" height="640" data-path="images/menu-builder/pricing-rules-list.png" />
</Frame>

## See which rules apply to an item

In the menu builder, a product that a rule touches shows a **Pricing rules apply** link by its price. Tap it to see which rules apply and on which channel, then tap **Modify** to open the rule.

<Frame caption="A product showing the rules that apply to it.">
  <img src="https://mintcdn.com/atlaskitchen/HJZnilS9Uto5SHLq/images/menu-builder/pricing-rule-applied-menu.png?fit=max&auto=format&n=HJZnilS9Uto5SHLq&q=85&s=36e20d9b5a1bbc63c605919397851207" alt="A product tile in the menu builder with a Pricing rules apply popover open, listing the $2 drinks rule at $2.00 on GrabFood with a Modify link." width="1508" height="1002" data-path="images/menu-builder/pricing-rule-applied-menu.png" />
</Frame>

## Troubleshooting

After you create a rule, you should see:

* The rule in the list at **Menu builder** > **Pricing rules**, marked **Active**.
* A **Pricing rules apply** link on each affected product in the menu builder.
* The adjusted price on the selected channels after you sync the menu. See [Aggregator menus](/menu-builder/aggregator-menus).

If something isn't right, check the matching scenario below.

<AccordionGroup>
  <Accordion title="A rule isn't changing the price">
    1. Confirm **Activate** is on.
    2. Confirm the item is in the rule, or that **Apply to all items** is ticked.
    3. Confirm the **Applicable scope** covers the item. A product won't change under a Modifiers only rule.
    4. Confirm the channel you're checking is in the rule's **Channels**.
  </Accordion>

  <Accordion title="Two rules apply and the wrong price wins">
    Rank decides the order. A higher rule with **Do not stack with other rules** on blocks the rules below it. Drag the rule you want to win above the others, or adjust which rules stack.
  </Accordion>

  <Accordion title="New prices aren't showing on GrabFood or Foodpanda">
    Aggregator menus update after a sync. Sync the menu, then check again. See [Aggregator menus](/menu-builder/aggregator-menus).
  </Accordion>
</AccordionGroup>

If the issue persists, contact support at [hello@atlas.kitchen](mailto:hello@atlas.kitchen) with your outlet name and the rule affected.

## Next steps

* [Update menu item prices](/menu-builder/draft-update-prices): change a single price or update many at once.
* [Aggregator menus](/menu-builder/aggregator-menus): sync price changes to GrabFood and Foodpanda.
* [Reporting categories](/menu-builder/reporting-categories): group products so a rule can target a whole category.
