From 32ec5b183fe34e0e19cccff38510d2807dbd6dc5 Mon Sep 17 00:00:00 2001 From: Le Vaillant Pierre Date: Fri, 26 Jun 2026 10:32:09 +0200 Subject: [PATCH] Clarify collaboration minutes in pricing docs (#3547) --- docs/pages/pricing/faqs.mdx | 39 +++++++++++++++++++++++++++---- docs/pages/pricing/overview.mdx | 16 ++++++------- docs/pages/pricing/plans/free.mdx | 2 +- docs/pages/pricing/plans/pro.mdx | 2 +- docs/pages/pricing/plans/team.mdx | 2 +- 5 files changed, 46 insertions(+), 15 deletions(-) diff --git a/docs/pages/pricing/faqs.mdx b/docs/pages/pricing/faqs.mdx index 9301d8552f..f55cd4f2a1 100644 --- a/docs/pages/pricing/faqs.mdx +++ b/docs/pages/pricing/faqs.mdx @@ -19,10 +19,41 @@ For full per-metric rates and worked examples, see our ## What counts as a realtime collaboration minute? -Realtime collaboration minutes count when multiple users are active in a room. -Two users in a room for 5 minutes is 10 collaboration minutes, billed at $0.002 -each. You can see exactly what's being counted on your -[dashboard usage page](/dashboard/usage). +Realtime collaboration minutes measure time when two or more people or agents +are in the same room together. Each connected user-minute counts. Two users in a +room for 5 minutes is 10 collaboration minutes, billed at $0.002 each. + +Solo sessions cost $0. If only one person or agent is in a room, it is not +billed. + +### What counts as connected? + +A user counts as connected when they have an open connection to a room—for +example, after joining with +[`RoomProvider`](/docs/api-reference/liveblocks-react#RoomProvider) or +[`enterRoom`](/docs/api-reference/liveblocks-client#Client.enterRoom). Each +browser tab is one connection. + +### When does billing pause? + +If no one is using the room (no presence updates, cursor movement, or other +activity), the room becomes inactive after 10 seconds. Collaboration minutes +stop accumulating until someone interacts again. + +### Do background tabs count? + +By default, Liveblocks keeps connections open in background tabs, so those users +still count as connected. To disconnect inactive background tabs automatically, +set +[`backgroundKeepAliveTimeout`](/docs/api-reference/liveblocks-client#createClientBackgroundKeepAliveTimeout) +on your client. + +### Where can I see collaboration minutes? + +Your [dashboard usage page](/dashboard/usage) shows collaboration minutes at the +workspace level. Each project overview page shows collaboration minutes over +time for that project. Per-user and per-room breakdowns are not available in the +dashboard today. ## Which Liveblocks plan should I choose? diff --git a/docs/pages/pricing/overview.mdx b/docs/pages/pricing/overview.mdx index 6de507064c..b6f1bb1044 100644 --- a/docs/pages/pricing/overview.mdx +++ b/docs/pages/pricing/overview.mdx @@ -36,14 +36,14 @@ See [Plans](/docs/pricing/plans) for full details on each plan. Liveblocks charges for what your app uses, applied against your monthly credits first. The main metered units: -| Unit | Description | Rate | -| ----------------------------------------------------------------------- | ----------------------------------------------------- | ----------------- | -| [Realtime collaboration minutes](/docs/pricing/plans/pro#Metered-usage) | Active time people and agents spend together in rooms | $0.002 per minute | -| [Comments created](/docs/pricing/plans/pro#Metered-usage) | Each comment posted in your app | $0.01 per comment | -| [Realtime data storage updates](/docs/pricing/plans/pro#Metered-usage) | Each change written to stored data | $1 per 1M updates | -| [Realtime data stored](/docs/pricing/plans/pro#Metered-usage) | Total data kept in storage | $0.15 per GB | -| [Monthly custom notifications](/docs/pricing/plans/pro#Metered-usage) | Notifications you trigger from your own code | $0.01 per event | -| [File storage](/docs/pricing/plans/pro#Metered-usage) | Total files stored | $0.15 per GB | +| Unit | Description | Rate | +| ----------------------------------------------------------------------- | ------------------------------------------------------------ | ----------------- | +| [Realtime collaboration minutes](/docs/pricing/plans/pro#Metered-usage) | When 2+ people are in the same room, each user-minute counts | $0.002 per minute | +| [Comments created](/docs/pricing/plans/pro#Metered-usage) | Each comment posted in your app | $0.01 per comment | +| [Realtime data storage updates](/docs/pricing/plans/pro#Metered-usage) | Each change written to stored data | $1 per 1M updates | +| [Realtime data stored](/docs/pricing/plans/pro#Metered-usage) | Total data kept in storage | $0.15 per GB | +| [Monthly custom notifications](/docs/pricing/plans/pro#Metered-usage) | Notifications you trigger from your own code | $0.01 per event | +| [File storage](/docs/pricing/plans/pro#Metered-usage) | Total files stored | $0.15 per GB | Rates shown here are indicative. See [Pro](/docs/pricing/plans/pro#Metered-usage) and diff --git a/docs/pages/pricing/plans/free.mdx b/docs/pages/pricing/plans/free.mdx index fdc60d2384..6b102d3025 100644 --- a/docs/pages/pricing/plans/free.mdx +++ b/docs/pages/pricing/plans/free.mdx @@ -18,7 +18,7 @@ monthly credits and overage billing. | Item | Free included usage | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | -| Realtime collaboration minutes | included | +| Realtime collaboration minutes | included | | Comments created | included | | Realtime data storage updates | included | | Realtime data stored | included | diff --git a/docs/pages/pricing/plans/pro.mdx b/docs/pages/pricing/plans/pro.mdx index a23a554ccc..09eabd1452 100644 --- a/docs/pages/pricing/plans/pro.mdx +++ b/docs/pages/pricing/plans/pro.mdx @@ -25,7 +25,7 @@ anything above them. | Item | Pro pricing | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | -| Realtime collaboration minutes | | +| Realtime collaboration minutes | | | Comments created | | | Realtime data storage updates | | | Realtime data stored | | diff --git a/docs/pages/pricing/plans/team.mdx b/docs/pages/pricing/plans/team.mdx index de81e9993d..91dd926ff1 100644 --- a/docs/pages/pricing/plans/team.mdx +++ b/docs/pages/pricing/plans/team.mdx @@ -30,7 +30,7 @@ anything above them. | Item | Team pricing | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | -| Realtime collaboration minutes | | +| Realtime collaboration minutes | | | Comments created | | | Realtime data storage updates | | | Realtime data stored | |