Usage Tracking
Every Vivreal group has resource quotas determined by its tier. This guide explains how to monitor your usage and what happens when you approach or hit a limit.
The Usage Panel
Your current resource consumption is visible on the Dashboard. The usage panel shows key metrics with progress bars indicating how close you are to your tier's limit:
- VivRecords — total number of collection objects across all collections
- Media storage — total size of uploaded files (images, videos, documents)
- API calls — number of API requests this billing cycle
- CDN bandwidth — data served through the CDN this billing cycle
- Sites — number of deployed sites
- Team members — current member count
Tier Quotas
| Resource | Free | Basic | Pro | Pro Plus |
|---|---|---|---|---|
| VivRecords | 50 | 500 | 5,000 | 25,000 |
| Media storage | 500 MB | 5 GB | 25 GB | 100 GB |
| Sites | 0 | 1 | 3 | 10 |
| Team members | 1 | 5 | 10 | 25 |
| Integrations | 3 | 5 | Unlimited | Unlimited |
| Social platforms | 1 | 3 | Unlimited | Unlimited |
| API calls / month | 1,000 | 50,000 | 500,000 | 2,000,000 |
| CDN bandwidth / month | 1 GB | 25 GB | 100 GB | 500 GB |
| Agent actions / month | -- | 50 | 500 | 5,000 |
| Webhooks | -- | 3 | 10 | 10 |
What Happens When You Hit a Limit
Hard Limits (creation blocked)
For VivRecords, sites, and team members, hitting the limit prevents you from creating new items. You'll see a message explaining which quota has been reached and suggesting an upgrade.
Existing content is never deleted or hidden when you hit a limit. Everything you've already created remains fully accessible.
Soft Limits (usage continues with overage)
For API calls and CDN bandwidth, paid tiers can opt into overage billing. When enabled, you can exceed your quota and pay for the additional usage. See Billing & Tiers for overage rates.
If overage billing is not enabled (or you're on the Free tier), exceeding API call or CDN limits returns a 402 Payment Required response until the next billing cycle resets.
Reducing Your Usage
If you're close to a limit and don't want to upgrade:
- Media storage — remove unused media files. Deleting an object also removes its associated media.
- VivRecords — delete outdated content entries you no longer need.
- API calls / CDN — these reset at the start of each billing cycle (monthly, UTC).
Next Steps
- Billing & Tiers — upgrade your plan or enable overage billing
- Roles & Permissions — control who can create content and consume resources