Concept · article 02 of 11

Revenue caps
explained.

How the annual revenue cap is measured (YTD gross, per plan), the warn threshold at 80%, and what triggers an upgrade prompt.

Ibrahim Ölmez Ibrahim ÖlmezFounder · nouz · 6 min read · Updated this week
YTD gross. The cap is on gross revenue (VAT included), accumulated from January 1st. Hitting it triggers an upgrade prompt — not a service interruption.

Revenue caps are how nouz prices fairly across shop sizes. A €40k/year café shouldn't pay the same as a €400k/year one — but neither should be charged based on what they make, just what tier of capacity they need.

01 How the cap is measured

Every revenue entry contributes its gross amount (cash + card) to your running YTD total. The total starts at zero on January 1st each year. The current value vs. your plan's cap is what nouz tracks for the warning banner and block.

Math lives in lib/billing/revenue-cap.ts and is computed server-side on every revenue write — so the check is authoritative, not browser-trusted.

02 The 80% warn, 100% block

ThresholdWhat happensWhat you see
Under 80%Normal operationNo banner
80%–99%Warn bannerYellow strip at top of every page
100%+New revenue entries blockedUpgrade prompt on save

The warn fires at 80% so you have time to upgrade calmly, not in a panic.

03 When the cap resets

On January 1st, the YTD count resets to zero. If you crossed your cap in December, you start fresh in January at €0 of €100k (or whatever your plan's cap is). You don't have to do anything — the reset is automatic.

04 Why a cap at all

Two reasons:

  • Fair pricing. A bigger shop uses more of our infrastructure (more entries, more queries, more support volume). Tying price to capacity tier is the cleanest fairness model we found.
  • Natural upgrade trigger. When your shop grows out of Starter, the cap tells you. Without it, you'd stay on the wrong plan forever and feature requests would diverge from what your shop actually needs.
Past entries always count. Backdated entries (logged today, dated last week) add to the YTD total of the year they're dated for. Useful to know if you're close to the cap and catching up on missed days.

Was this article helpful?

Your vote helps us decide what to write next.

Still stuck? Email support@nouz.co — a founder replies, usually the same business day.