Skip to content

Plans & limits ​

Plans decide what each customer account may use: how many websites, how many sessions are counted and replayed per month, how long recordings are kept, how many people are on the team, and which features (heatmaps, A/B tests, AI…) are switched on. The same plans fill the pricing page of your public website and the customers’ Plan & billing page.

10 minutesSaaS operators (installation administrators)SaaS
Available inSingle userSaaSThe Single user edition has no plans: everything is unlimited.

Where: Administration › Plans (/plans). Only installation administrators see this page.

your-site.com/plansInteractive: click the numbers
Administration › Plans: one card per plan with its prices and every limit.Administration › Plans: one card per plan with its prices and every limit.
1. New planOpens the plan editor with an empty plan.
Administration › Plans: one card per plan with its prices and every limit.

The plan cards ​

Each card shows one plan, in display order:

Part of the cardWhat it shows
Name and badgesDefault (the default plan), Enterprise (listed apart on the pricing page)
PriceMonthly price with / month, or Free when the monthly price is 0
… / yearThe yearly price, only when the plan has one
LimitsOne row per plan-limited feature (see Limits): a number, Unlimited, Included, Not included, or Default when the plan does not mention the feature
AccountsHow many accounts an administrator has put on this plan (on the Users page). Paying subscribers are not counted here
Stripe, PaddleHow the plan can be bought online with each provider: Monthly, Yearly, Monthly and yearly, or — (not for sale there)
EditOpens the plan editor
DeleteDeletes the plan after a confirmation. Disabled for the default plan

A fresh installation starts with two plans: Free (default, 1 website, 1,000 sessions a month, 30 days of retention) and Pro ($39 a month, 10 websites, 50,000 sessions a month, 365 days). Change or replace them before you open sign-up.

The plan editor ​

New plan or Edit opens the editor. Everything applies as soon as you click Save plan: account limits are cached for at most a minute and the cache is cleared on every save, so customers get the new limits on their next request.

your-site.com/plansInteractive: click the numbers
The plan editor (top part): name, prices, currency and price ids.The plan editor (top part): name, prices, currency and price ids.
1. NameShown on the pricing page, in Plan & billing and in emails. Up to 80 characters.
The plan editor (top part): name, prices, currency and price ids.

Name, prices and currency ​

FieldWhat it doesAllowed values / default
NameThe plan’s name everywhere customers see itRequired, up to 80 characters
Price per monthWhat the plan costs per month, in normal currency units (stored in cents). 0 = free0 to 1,000,000.00; default 0
Price per yearThe yearly price. The pricing page shows it per month (yearly ÷ 12) with the saving against twelve monthly payments (“save 17%”)Empty = monthly only; 0 to 10,000,000.00
CurrencyThe currency the prices are shown inExactly 3 letters (ISO code), saved in capitals; default USD

The currency only labels the price

Customers are charged in the currency of the price in Stripe or Paddle, not of this field. Keep both the same, and keep the amounts the same too: the pricing page shows what you type here, the checkout charges what the provider’s price says.

Price ids (selling the plan online) ​

FieldWhat it does
Stripe price idThe recurring monthly price in Stripe (price_…). Empty = not for sale monthly through Stripe
Stripe yearly price idThe recurring yearly price in Stripe. Empty = not for sale yearly through Stripe
Paddle price idThe recurring monthly price in Paddle (pri_…)
Paddle yearly price idThe recurring yearly price in Paddle. Empty = not for sale yearly through Paddle

Each id may hold letters, digits and _, up to 120 characters. Only the ids of the active payment provider matter (see Billing: Stripe and Billing: Paddle); you can fill in both providers’ ids and switch later. A plan can be bought online for an interval only when it has both a price above 0 for that interval and a price id; otherwise Plan & billing shows it as Not for sale online and the administrator assigns it by hand.

When a payment provider reports a subscription, Replora finds the plan by the price id that was paid. That is how a subscription maps to a plan.

Don't change a price id while customers pay for it

The price id is how a running subscription finds its plan. If you replace the id (or delete the plan), the next renewal or change reported by the provider no longer matches any plan, and the account falls back to the default plan. To raise prices, create a new price in the provider, put the plan’s customers on it in the provider’s dashboard, then change the id here; or make a new plan and leave the old one in place for existing subscribers.

Limits ​

Below the price ids the editor lists every plan-limited feature of the modules that are installed and enabled (a removed module’s features disappear from the editor; plans keep their stored values). There are two kinds:

  • Numbers (a text box): empty = Unlimited, 0 = Not included (the feature is switched off), any other whole number = the limit.
  • On/off features (a switch, keys ending in .enabled): Included or Not included.
LimitKindWhat happens at the limit
SitesnumberNo more websites can be added (“Your plan allows N sites…”)
Sessions per monthnumberNew visits are not taken at all until the next month (see below)
Session replays per monthnumberNew visits are still counted in heatmaps, funnels and reports, but without a replay
Retention (days)numberThe longest time recordings are kept. Each website’s own retention setting is capped to it
Recording downloadson/offDownloading a replay as a file that plays offline
Team membersnumberHow many people the account may have, pending invitations included; further invitations are refused
AlertsnumberHow many alerts the account may create
Error trackingon/offThe JavaScript errors report
Custom eventson/offThe custom events report
A/B testsnumberHow many A/B tests the account may have
A/B test visitors per monthnumberDistinct visitors in tests per calendar month; tests pause for the rest of the month when it is reached
Form analyticson/offThe forms report
FunnelsnumberHow many funnels the account may create
Heatmapson/offClick, scroll and move heatmaps
HubSpot integrationon/offSending sessions to HubSpot
Behavior insightson/offThe insights report
AI summaries per monthnumberAI summaries of sessions written per month
AI searchon/offSearching sessions in plain words
Ask AI questions per monthnumberQuestions to Ask AI (and the AI digest) per month
SurveysnumberHow many surveys the account may have

The labels above are what the editor shows; the order on your page follows the installed modules. A switched-off feature answers “Your plan doesn’t include … Upgrade the plan to use it.” in the dashboard and the API.

Not mentioned is not the same as unlimited

A feature the plan does not mention (shown as Default on the card, typically after you install a new module) gets the installation default, which is unlimited for every feature listed here. Open and save the plan once to give the new feature an explicit value.

Default plan and enterprise plan ​

SwitchWhat it does
Default planAccounts without a plan of their own use it: new accounts, accounts whose subscription ended, accounts after an assignment ran out. Only one plan can be the default: turning it on turns it off on the previous one. A custom plan (one account’s own plan) can’t be the default
Enterprise planLists the plan apart, at the bottom of the pricing page under Need more scale?, instead of with the regular plans. Enterprise plans still appear as extra columns in the Compare all features table

Make the default plan a free plan (price 0). When a free trial ends, the account moves to the default plan if it is free, else to the first free plan; with no free plan at all, its websites stop recording until it chooses a plan.

Display order ​

Plans are shown in their sort order (0–1000), then by creation. The editor has no field for it: new plans get 0 and therefore come first. To reorder, send sort through the API:

bash
curl -X PATCH https://your-site.com/api/v1/plans/3 \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"sort": 30}'

The API (administrators only): GET /api/v1/plans (with meta.features, every feature key and label), POST /api/v1/plans, PATCH /api/v1/plans/{plan}, DELETE /api/v1/plans/{plan}. The fields are the same as in the editor: name, price_cents, yearly_price_cents, currency, price_ids (stripe, stripe_yearly, paddle, paddle_yearly), limits (feature key → whole number or null), is_default, is_enterprise, sort.

Sessions and replays ​

The two monthly session limits work together. Months are calendar months in UTC.

SituationWhat happens to a new visit
Under both limitsRecorded with its replay, and counted in every report
Session replays per month used upCounted without a replay: page views, clicks and errors still feed heatmaps, funnels, forms and the other reports, but there is nothing to play back
Sessions per month used upNot taken: neither recorded nor counted until the 1st of the next month

A visit that already started keeps going as it began, even when a limit is reached in the meantime. Everything already recorded stays. Leave Session replays per month empty to replay every counted session; set it lower than Sessions per month for plans that should count more traffic than they replay (for example 50,000 sessions, 10,000 replays).

Spreading the quota over the month ​

Each website has the setting Spread the monthly quota over the month (in its settings, see Website settings in the user guide). With it on, the account may only have used the month’s elapsed share of its limits so far (by the hour), so a busy start does not leave the rest of the month unrecorded.

The limit-reached email ​

When a limit is reached, the account’s managers (not suspended) get an email, once per limit: once a month, or once a day when the quota is spread over the month. There are two emails:

  • This month’s recording sessions are used up (or Today’s…): new visits aren’t recorded until the date given;
  • This month’s session replays are used up (or Today’s…): visits are still counted but not replayed.

Both have a See plans button to Plan & billing (“A larger plan records more… right away”). Raising the plan takes effect immediately.

Free trials ​

Trials are set in Settings › Installation › Free trial (see Installation settings):

SettingWhat it doesAllowed / default
Offer a free trialNew accounts that sign up themselves try a paid plan for free, once, without a cardOff
Trial length (days)How long the trial lasts1–90; default 14
Plan triedThe plan of the trial. Only paid plans are listednone = no trials

During the trial the account is on the tried plan and a banner above every page counts the days left. Three days before the end (daily at 09:00, once per trial) the managers get a reminder email. A subscription or an administrator’s assignment wins over a trial. When the trial ends the account moves to the free plan; without a free plan its websites stop recording (“Your free trial has ended…”) until it chooses a plan. Changing these settings does not change trials already running. The pricing page shows N-day free trial on the tried plan and its button reads Try … free.

How an account gets its plan ​

An account’s plan is resolved in this order, and the first that applies wins:

  1. Assigned by an administrator (Users › Change plan), until its end date if it has one;
  2. A paid subscription that gives access now (the most expensive one if there are several);
  3. A running free trial;
  4. The default plan (after a trial: the free plan, or no plan at all).

A subscription gives access while it is active, while it is cancelled but paid until its end date, and while a payment has failed for up to PLANS_GRACE_DAYS days (default 7) while the provider retries. After that the account is back on the default plan.

Change one account's plan ​

  1. Open Administration › Users, find the person and choose Change plan in their row’s menu (see Users).
  2. Choose a Plan, or What they pay for (or the default plan) to remove an earlier assignment.
  3. Optionally set Until: after that day the account is back on what it pays for, its trial or the free plan. Empty = until you change it.
  4. Click Save plan.

An assigned plan applies whatever the account pays for, and is never billed.

Give one account its own limits ​

In the same dialog, Make a custom plan copies the account’s current plan into a plan that only this account is on (named Custom: account name, not for sale online). Change its limits and Price per month (what you charge this account, for your records) right there, or later in Administration › Plans. Moving the account to another plan deletes its custom plan.

Upgrades, downgrades and cancelling ​

Customers change plans on Account › Plan & billing (/plan). Only the account’s managers see the buttons; others see Ask a manager to switch. The server enforces the same rule: a billing request from a member or viewer (for example through the API) is refused with 403 Only managers of the account can change its billing.

your-site.com/plan
Plan & billing, as a customer sees it: the plan, a meter per limit, unlimited limits and the included features.Plan & billing, as a customer sees it: the plan, a meter per limit, unlimited limits and the included features.
Plan & billing, as a customer sees it: the plan, a meter per limit, unlimited limits and the included features.
ActionWhat happens
First purchaseOpens the provider’s checkout (Stripe Checkout or Paddle’s overlay). The plan changes only when the provider’s webhook confirms the payment, usually within seconds; the page checks again by itself
Upgrade / downgrade / Monthly ↔ YearlyWith a running subscription, the subscription is switched to the new price at once and the provider prorates the difference
Manage billingOpens the provider’s portal (cards, invoices). Only after the account has paid once
Cancel subscriptionCancels at the end of the paid period; the plan stays until then, then the account moves to the free plan
Resume subscriptionUndoes a cancellation while the paid period is still running

Limits follow the plan on every request. After a downgrade nothing is deleted: existing websites, funnels, surveys and team members stay, but nothing new can be added above the new limit, switched-off features answer “Your plan doesn’t include…”, and recordings older than the new retention are removed by the next clean-up.

Delete a plan ​

  1. Make another plan the default first if this one is the default.
  2. Move every account an administrator assigned to it (the Accounts number) to another plan.
  3. Click Delete on the card and confirm.

Paying customers

Deleting checks only assigned accounts, not subscriptions. Customers who pay for the plan through Stripe or Paddle lose it (they fall back to the default plan) while the provider keeps charging them. Cancel or move those subscriptions in the provider’s dashboard first.

The pricing page ​

The public Pricing page (/pricing) is built from these plans; see Public website.

your-site.com/pricing#compare
Compare all features: every plan side by side, enterprise plans last.Compare all features: every plan side by side, enterprise plans last.
Compare all features: every plan side by side, enterprise plans last.
  • Regular plans are cards in display order. Each card shows Sessions per month, Session replays per month, Sites, Retention and Team members (what the plan mentions), then All features included or N of M features.
  • A Monthly / Yearly toggle appears when any plan has a yearly price, with save up to N%.
  • The middle regular plan is highlighted as Most popular, unless it is the default plan.
  • Enterprise plans are listed apart under Need more scale? with their sessions as the headline (e.g. 500K sessions); one with price 0 shows Custom pricing and Contact sales. Without enterprise plans the page shows Need more? with Talk to us.
  • Compare all features (with two plans or more) lists every feature a plan mentions; the key numbers come first.
  • Custom plans never appear publicly.

.env ​

KeyWhat it doesDefault
BILLING_PROVIDERstripe, paddle or empty (no online payments; administrators assign plans). Can also be set in Settings › Installation › Paymentsempty
PLANS_GRACE_DAYSDays a plan keeps working while the provider retries a failed payment7

Replora: see what your visitors see.