Home / Help Center / pos-app-restaurant / rest-order / Order Throttling
🛑 rest-order

Order Throttling

Order Throttling protects the kitchen during a rush by capping how many orders can be active at once and how many can come in per hour. When either limit is hit, new orders are blocked, selected channels (Delivery and/or Takeaway) are paused, and guests see a friendly capacity message instead of an order that would take an hour to cook.

📍 Menu path: Order & Kitchen → Order Throttling
👤 Who uses it: All roles with the Billing feature enabled

Overview

Two limits work together: Max Concurrent Orders (how many KOTs can be active at any one time, default 10) and Max Orders Per Hour (orders in a rolling 60-minute window, default 30) — hitting either one triggers throttling while the master toggle is on.

Two live capacity gauges show Active (Concurrent) Orders and Orders This Hour against their limits, with a marker line at the Alert Threshold percentage (default 80%) — the bar turns amber once past the threshold and red at 100%.

A status banner at the top reflects the current state: grey "Throttling disabled" when the master toggle is off, green "Monitoring — Capacity within limits" when on but under the limits, and a pulsing red "THROTTLED — Blocking new orders" when a limit has been hit; it also shows the live active-KOT and last-hour order counts.

The "Pause Channels When Throttled" checkboxes choose what gets paused during a throttle: Delivery (on by default) and/or Takeaway (off by default).

The Customer-Facing Message is the text guests see when throttled (default: "Kitchen is at capacity. Please try again shortly.") — fully editable.

Nothing takes effect until the master "Enable Throttling" toggle is on and you click Save Settings; the gauges keep displaying live capacity either way, so you can watch load without enforcing limits.

Before You Start

Step-by-Step Guide

1 Set up throttling for the first time

  1. Open Order Throttling and set Max Concurrent Orders and Max Orders Per Hour to what your kitchen can realistically handle.
  2. Set the Alert Threshold — the percentage of capacity at which the gauges turn amber as an early warning (default 80%).
  3. Tick which channels should pause when throttled (Delivery, Takeaway, or both).
  4. Edit the Customer-Facing Message if you want different wording.
  5. Switch on "Enable Throttling" and click "Save Settings."

2 Monitor capacity during a rush

  1. Watch the two Live Capacity gauges — amber means you are past the alert threshold and approaching a limit; red means the limit is reached and new orders are being throttled.
  2. Click Refresh to pull the latest active-order and last-hour counts.

3 Turn throttling off after the rush

  1. Switch "Enable Throttling" off and click "Save Settings" — the limits stay saved for next time, but nothing is blocked while the toggle is off.

Every Field & Button, Explained

Field / ButtonWhat it does
Enable ThrottlingMaster switch. When off, the page still shows live capacity but no orders are ever blocked, regardless of the limits.
Max Concurrent OrdersHow many KOTs may be active at the same time (1–200, default 10) — the first of the two limits that can trigger throttling.
Max Orders Per HourHow many orders may arrive in a rolling 60-minute window (1–500, default 30) — the second limit.
Alert ThresholdPercentage of either limit (10–100, default 80) at which the gauge turns amber and shows an "approaching limit" warning — an early heads-up before actual throttling starts.
Pause Channels When ThrottledDelivery (default on) pauses delivery orders on aggregator portals; Takeaway (default off) pauses takeaway orders. Dine-in is not a pausable channel here.
Customer-Facing MessageThe text guests see while throttled; defaults to "Kitchen is at capacity. Please try again shortly."

Tips & Best Practices

Troubleshooting & FAQ

The banner says THROTTLED but I only expected a warning.
Amber (alert threshold) and red (limit reached) are different states — throttling only actually blocks orders once a gauge hits 100% of its limit while Enable Throttling is on. Raise the limit or wait for active orders to complete to come back under it.
I changed the limits but nothing seems different.
Settings only apply after clicking "Save Settings" — and no blocking happens at all unless the master "Enable Throttling" toggle is on.
The gauge numbers look stale.
The page loads status when opened and on manual Refresh — it does not auto-poll like the KDS. Click Refresh for current counts.