Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

Update docs to match new billing plans

Blue Moused86ab772b858
diff --git a/docs/content/docs/analytics-dashboard/experiments.mdx b/docs/content/docs/analytics-dashboard/experiments.mdx
index 98a8c8d92..9d36d7efd 100644
--- a/docs/content/docs/analytics-dashboard/experiments.mdx
+++ b/docs/content/docs/analytics-dashboard/experiments.mdx
@@ -5,6 +5,11 @@ slug: /analytics-dashboard/experiments
Experiments let you run A/B or A/B/n tests and compare how different variants affect a goal. Use them to test product changes, pricing pages, onboarding flows, copy, layouts, or any other change where you want to measure the effect before rolling it out.
+<Callout type="info">
+ On Swetrix Cloud, Experiments are available on Plus and Enterprise plans. Self-hosted instances
+ can use them without a cloud subscription.
+</Callout>
+
<Callout type="info" title="Experiments are backed by feature flags">
Every experiment is connected to a feature flag. Use the flag to gate eligibility in your
application, then let the experiment handle variant allocation, exposure tracking, and result
diff --git a/docs/content/docs/analytics-dashboard/feature-flags.mdx b/docs/content/docs/analytics-dashboard/feature-flags.mdx
index 8d1e4c46f..fbe673c05 100644
--- a/docs/content/docs/analytics-dashboard/feature-flags.mdx
+++ b/docs/content/docs/analytics-dashboard/feature-flags.mdx
@@ -5,6 +5,11 @@ slug: /analytics-dashboard/feature-flags
Feature flags allow you to toggle features on and off for your users without deploying new code. This is useful for rolling out new features gradually, testing in production, or quickly disabling a feature if something goes wrong.
+<Callout type="info">
+ On Swetrix Cloud, Feature Flags are available on Plus and Enterprise plans. Self-hosted instances
+ can use them without a cloud subscription.
+</Callout>
+
## Overview
With Swetrix Feature Flags, you can:
diff --git a/docs/content/docs/api/admin.mdx b/docs/content/docs/api/admin.mdx
index 2f5513d29..33a79b339 100644
--- a/docs/content/docs/api/admin.mdx
+++ b/docs/content/docs/api/admin.mdx
@@ -7,11 +7,12 @@ Swetrix provides the ability to control your projects (and soon your account) vi
Each request must be authenticated with an API key using `X-Api-Key` HTTP header. You can obtain an API key in your Swetrix [account settings](https://swetrix.com/user-settings).
-Rate limit for the API depends on your plan, you can find more information on the billing (or the main) page.
-As of 9 February 2023, the rate limits are as follows:
+Rate limit for the API depends on your plan. You can find more information on the billing page.
+The current rate limits are:
-- **Free plan**: 600 requests per hour;
-- **Any paid plan**: 600 requests per hour.
+- **Standard plan**: 300 requests per hour;
+- **Plus plan**: 6000 requests per hour;
+- **Enterprise plan**: custom, and may be unlimited on demand.
If you have special needs for more requests, please [contact us](https://swetrix.com/contact) to request more capacity.
diff --git a/docs/content/docs/billing/cancel-subscription.mdx b/docs/content/docs/billing/cancel-subscription.mdx
index c9ac305d6..155da1908 100644
--- a/docs/content/docs/billing/cancel-subscription.mdx
+++ b/docs/content/docs/billing/cancel-subscription.mdx
@@ -3,6 +3,10 @@ title: How to cancel your subscription
slug: /cancel-your-subscription
---
-To cancel your subscription plan, log into your account and go to the [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. To cancel your subscription, click on the "Cancel subscription" button located next to the tier selector.
+To cancel your subscription plan, log into your account and go to the [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. In the **Subscription** section, click **Cancel subscription** and confirm the cancellation.
-After cancelling, you will still have access to your dashboard and statistics will continue to be collected until the end of your current subscription cycle.
+After cancelling, your subscription remains active until the end of the current billing period. You will still have access to your dashboard and statistics will continue to be collected until that date.
+
+When the billing period ends, dashboard access is locked and new analytics events are no longer accepted. We keep your existing data, so you can subscribe again later to restore access.
+
+If you have an active website add-on, it is scheduled to end with your subscription.
diff --git a/docs/content/docs/billing/exceeding-plan-limits.mdx b/docs/content/docs/billing/exceeding-plan-limits.mdx
index 043c1b72f..fd96da312 100644
--- a/docs/content/docs/billing/exceeding-plan-limits.mdx
+++ b/docs/content/docs/billing/exceeding-plan-limits.mdx
@@ -4,9 +4,8 @@ slug: /exceeding-plan-limits
---
<Callout type="info">
- We don't stop collecting traffic or charge extra if you have an occasional traffic spike. We also
- don't stop collecting data if you miss your invoice for a short period of time. There are no
- hidden charges and we won't charge your card unexpectedly.
+ We don't charge extra or automatically move you to a more expensive plan if you have an occasional
+ traffic spike. There are no hidden charges and we won't charge your card unexpectedly.
</Callout>
If you exceed your subscription plan, we won't automatically upgrade you to the next one because it's unethical.
@@ -21,9 +20,9 @@ If this happens, we will not lock your dashboard immediately. Instead, we will g
We may also lock your dashboard if you miss a bill. We will lock the dashboard after 5 failed attempts.
<Callout>
- We will not stop collecting your analytics data even if your dashboard is temporarily locked. If
- you upgrade to an appropriate tier that reflects your traffic usage (or the payment issues are
- resolved) - the dashboard will automatically be unlocked.
+ If your dashboard is locked because of billing or plan limits, new analytics events are not
+ accepted until the issue is resolved. Existing analytics data is kept. Once you upgrade to an
+ appropriate tier or resolve the payment issue, dashboard access and collection are restored.
</Callout>
-We will only stop collecting data if our invoices go unpaid for many months, the dashboard is locked for a long time, or if you have exceptionally high traffic to your site and the billing issue is not resolved.
+If you need a higher event volume, choose a larger event tier from the [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. For very high traffic or custom limits, choose Enterprise or [contact us](https://swetrix.com/contact).
diff --git a/docs/content/docs/billing/faq.mdx b/docs/content/docs/billing/faq.mdx
index fe8debdda..33d658dc1 100644
--- a/docs/content/docs/billing/faq.mdx
+++ b/docs/content/docs/billing/faq.mdx
@@ -9,9 +9,15 @@ Yes. A valid payment method is required to start your 14-day free trial, but you
## How does billing work?
-If you subscribe to a monthly plan, you will be billed the same amount on the same day (unless you upgrade or downgrade your plan). For example, if you subscribe on the 15th of July, you will be billed on the 15th of each subsequent month.
+Your subscription is made up of a plan type, a monthly event volume, and a billing interval.
-If you have an annual plan, you will be billed on the same day each year.
+- **Standard** covers privacy-friendly analytics, funnels, error tracking, bot filtering, email reports, API access, and the core dashboard features.
+- **Plus** includes everything in Standard and adds session replays, feature flags, A/B testing, higher API rate limits, larger account limits, and priority support.
+- **Enterprise** is for custom limits, infrastructure, support, legal terms, and invoicing.
+
+If you subscribe to a monthly plan, you will be billed on the same day each month unless you change your plan. For example, if you subscribe on the 15th of July, you will be billed on the 15th of each subsequent month.
+
+If you have an annual plan, you will be billed on the same day each year. Annual billing is priced as 10 months, so you get 2 months free.
## Will I be billed per account or per website?
@@ -19,7 +25,23 @@ TLDR: We charge per account.
Our subscription tiers are based on the total number of pageviews, custom events, CAPTCHA events, and error events across all projects you create on your account. You can add as many sites to Swetrix as you like; the total number of events across all of them counts toward your subscription tier.
-All our subscription plans include up to 50 projects for free, for each additional project you will be charged $0.15 per project.
+Your plan includes a website allowance, shown on your [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. Invited project members do not need their own subscription; their usage counts toward the account owner's plan.
+
+If you need more websites than your plan includes, you can buy a recurring website add-on from the **Add-ons** section of the billing page. Website add-ons are sold in bundles of 50 extra websites, up to 1,000 additional websites.
+
+## What counts toward my monthly event limit?
+
+Pageviews, custom events, CAPTCHA events, and error events count toward your monthly event limit. The billing page shows the current calendar month breakdown and how much of the limit remains.
+
+## How do add-ons work?
+
+Add-ons are recurring extras on top of your base subscription. They are available for active paid subscriptions, but not while a trial is still running, a subscription is scheduled for cancellation, or billing is suspended.
+
+Website add-ons can be managed from **Plan and billing**, then **Add-ons**. Increases are charged immediately, with proration when you already have an active website add-on. Decreases, cancellations, and billing interval changes take effect on the next add-on renewal.
+
+Yearly website add-on billing is available when your main subscription is billed yearly. If your main subscription is monthly, website add-ons are billed monthly.
+
+Session replay add-ons are not self-serve yet. If you need a higher replay quota than your plan includes, please [contact us](https://swetrix.com/contact).
## How do I access my invoices?
@@ -27,7 +49,9 @@ We use Paddle as our payment processor, which sends invoices by email, with a co
## Can I switch between monthly and yearly billing?
-You can switch between monthly and annual billing at any time. For example, if you are halfway through your annual subscription and decide to switch to a monthly subscription, the price will be prorated to reflect what you have already paid.
+You can switch between monthly and annual billing from the plan selection page. The exact price is shown before you confirm the change.
+
+For active subscriptions, plan changes are prorated. For example, if you are halfway through an annual subscription and decide to switch to a monthly subscription, the preview will account for what you have already paid.
## What payment methods does Swetrix accept?
diff --git a/docs/content/docs/billing/update-subscription.mdx b/docs/content/docs/billing/update-subscription.mdx
index 47cccccda..b73aa386d 100644
--- a/docs/content/docs/billing/update-subscription.mdx
+++ b/docs/content/docs/billing/update-subscription.mdx
@@ -3,10 +3,39 @@ title: How to update your subscription plan
slug: /update-your-subscription
---
-To change your subscription plan, log into your account and go to the [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. There you will find a subscription selector that allows you to choose a plan based on how much traffic your site has.
+To change your subscription plan, log into your account and go to the [Plan and billing](https://swetrix.com/user-settings?tab=billing) page. The billing page shows your current monthly usage, website allowance, session replay quota, API rate limit, current plan, and add-ons.
-Once you have selected the plan that best suits your usage, press "Upgrade". This will bring up a modal that will tell you how much you need to pay now and in the next billing cycle.
+Click **Manage plan** or **Choose a plan** to open the plan selection page.
-We will prorate the amount you have paid so far and discount your future bill accordingly. For example, if you are halfway through your 500k events subscription and decide to upgrade to 1m, the first bill will be discounted to reflect what you have not used on your previous subscription. You can read more about pro-ration on the [Paddle's website](https://www.paddle.com/resources/proration).
+## Choosing a new plan
-Once you have reviewed your new subscription, press the "Confirm" button and your new plan will be automatically applied to your account.
+On the plan selection page:
+
+1. Choose the monthly event volume you need.
+2. Choose a plan type: **Standard**, **Plus**, or **Enterprise**.
+3. Choose monthly or yearly billing.
+
+Standard and Plus plans can be changed through self-serve checkout. Enterprise plans require contacting us because the limits and terms are custom.
+
+<Callout type="info">
+ You cannot change the selected plan while a paid trial is still running. You can change plans
+ after the trial converts to a paid subscription, or cancel the trial and subscribe again with a
+ different plan.
+</Callout>
+
+## Reviewing the price
+
+If you already have an active paid subscription, Swetrix shows a pricing preview before applying the change. The preview includes:
+
+- **Due now**: the immediate charge or credit for the change.
+- **Next payment**: the recurring amount and next billing date.
+
+We prorate the amount you have paid so far and discount your future bill accordingly. For example, if you are halfway through a 500k events subscription and upgrade to 1m events, the immediate charge will reflect the unused value of your previous subscription. You can read more about proration on [Paddle's website](https://www.paddle.com/resources/proration).
+
+Once you have reviewed the preview, press **Confirm** and the new plan will be applied to your account.
+
+## Updating add-ons
+
+Website add-ons are managed separately from your base plan in the **Add-ons** section of the billing page. They are available for active paid subscriptions and let you buy extra website capacity in bundles of 50 websites.
+
+Increasing a website add-on takes effect immediately. Decreasing, cancelling, or changing the billing interval is scheduled for the next add-on renewal.
diff --git a/docs/content/docs/billing/upgrade-from-trial.mdx b/docs/content/docs/billing/upgrade-from-trial.mdx
index cff3123c7..5cfa38940 100644
--- a/docs/content/docs/billing/upgrade-from-trial.mdx
+++ b/docs/content/docs/billing/upgrade-from-trial.mdx
@@ -3,54 +3,64 @@ title: Upgrade from trial to a paid subscription
slug: /upgrade-from-trial-to-a-paid-subscription
---
-When you sign up for Swetrix, you start with a free 14-day trial. A credit card is required to begin the trial, but you won't be charged until the trial period ends. We'll send you a reminder email before your trial expires so there are no surprises.
+When you sign up for Swetrix, you start with a free 14-day trial. You choose a plan before the trial starts, and a payment method is required, but you won't be charged until the trial period ends. We'll send you a reminder email before your trial expires so there are no surprises.
-At any time during your trial, or once it's over, you can upgrade to a paid subscription.
+If you do not cancel before the trial ends, the trial automatically converts to the plan you selected.
<Callout type="info">
We do not stop collection or reset your collected data. The analytics data is preserved when you
update from a trial to a paid plan, or change your paid subscription to another plan.
</Callout>
-## Updating to a paid subscription
+## Choosing the trial plan
<Steps>
<Step>
### Choose a plan
-Log in to your account and go to the [Plan and billing page](https://swetrix.com/user-settings?tab=billing).
+Log in to your account and go to the [Plan and billing page](https://swetrix.com/user-settings?tab=billing), then click **Choose a plan**.
You will see the Usage section with an indicator of how many events you used during the current calendar month. You can hover over this chart and see what kind of events you used during that period.
We count pageviews, custom events, CAPTCHA events, and error events as "events".
-Using the subscription plan selector, choose a plan based on your estimated usage, and the billing frequency (monthly or yearly). You can get 2 free months with a yearly subscription.
+On the plan selection page, choose:
+
+- The monthly event volume that fits your expected traffic.
+- The plan type: **Standard**, **Plus**, or **Enterprise**.
+- The billing interval: monthly or yearly.
+
+You can get 2 free months with a yearly subscription.
</Step>
<Step>
-### Start the upgrade
+### Start the trial
-Once you choose your subscription plan, click on the "Upgrade" button to get started.
+Once you choose your plan, click the plan button to start checkout.
<img alt="Upgrade to a paid subscription" src="/docs/img/billing/subscription-selector.png" />
</Step>
<Step>
-### Complete payment
-
-Since you already provided your payment details when starting the trial, the upgrade process is straightforward. Choose your plan and confirm — your existing payment method will be used.
+### Confirm payment details
-You can also update your payment method or switch to a different one (PayPal, payment card, Apple Pay, or Google Pay) during the upgrade.
+You can pay with a card, PayPal, Apple Pay, or Google Pay through Paddle. You will not be charged during the 14-day trial.
-After you're done, click on the "Subscribe now" button to complete the subscription. You'll receive an email confirmation and your subscription will be active immediately.
+After you're done, click **Subscribe now**. You'll receive an email confirmation and your trial will be active immediately.
</Step>
</Steps>
+<Callout type="warn">
+ You cannot change the selected plan while a paid trial is running. If you picked the wrong plan,
+ cancel the trial before it ends and subscribe again with the plan you want, or change the plan
+ after the trial converts to a paid subscription.
+</Callout>
+
## Opt into company VAT refund for your subscription
You can add your company details and VAT ID when subscribing to one of our plans. If you're eligible, no VAT or other sales taxes will be added to your subscription price.
-<img alt="Add VAT on existing invoice" src="/docs/img/billing/invoice_add_vat.png" />
+<img alt="Add VAT on checkout" src="/docs/img/billing/checkout_add_vat.png" />
You can also add your VAT number after you created a subscription, to do that open the invoice Paddle sent you to your email address, and click on the "Add address & VAT Number" button.
diff --git a/docs/content/docs/script-reference.mdx b/docs/content/docs/script-reference.mdx
index 4a7d3c415..9003a1734 100644
--- a/docs/content/docs/script-reference.mdx
+++ b/docs/content/docs/script-reference.mdx
@@ -230,6 +230,11 @@ swetrix.trackError({
Fetches all feature flags for the project. Results are cached for 5 minutes by default. This cache is shared with experiment assignments.
+<Callout type="info">
+ On Swetrix Cloud, the project owner must be on Plus or Enterprise for feature flag evaluation. If
+ the project is on a plan without Feature Flags, evaluation returns an empty result.
+</Callout>
+
```javascript
const flags = await swetrix.getFeatureFlags({
profileId: "user-123",
@@ -271,8 +276,10 @@ swetrix.clearFeatureFlagsCache();
Fetches variant assignments for running A/B test experiments that use default feature-flag exposure. Results are cached for 5 minutes by default and share the cache with feature flags.
<Callout type="info">
+ On Swetrix Cloud, the project owner must be on Plus or Enterprise for experiment evaluation.
Experiment assignments and feature flags are evaluated by the same request, so they share the same
- 5-minute cache.
+ 5-minute cache. If the project is on a plan without Experiments, evaluation returns an empty
+ result.
</Callout>
```javascript