Core concept
What Are Groups?
A Group is your workspace in Vivreal — it holds your collections, sites, integrations, team members, and all your usage quotas.
Your workspace boundary
Every Group gets its own isolated database, S3 media bucket, and usage tracking. Nothing leaks between Groups.
- Separate MongoDB database per Group (multi-tenant isolation)
- Dedicated S3 bucket for media uploads (vivreal-{groupKey})
- Independent quota tracking for VivRecords, media, API calls, CDN
- Perfect for agencies managing multiple clients or brands
Roles & permissions
Three roles control who can do what inside a Group.
- Owner — full access including billing, tier changes, and destructive actions
- Admin — manage content, sites, members, and integrations (no billing access)
- Member — view-only access (no creation or editing)
Quotas tracked per Group
Every Group has usage limits based on its tier. Hard limits block actions; usage-based limits can opt into overage billing.
- VivRecords: 50 → 500 → 5K → 25K → Unlimited
- User Seats: 1 → 5 → 10 → 25 → Unlimited
- Sites: 0 → 1 → 3 → 10 → Unlimited
- Media Storage: 500MB → 5GB → 25GB → 100GB → Unlimited
- API Calls/mo: 1K → 50K → 500K → 2M → Unlimited
- Agent Actions/mo: 0 → 50 → 500 → 5K → Unlimited
Audit logging & version history
Groups automatically track changes for accountability and rollback.
- Audit log retention: 7 days (Free) → 30 → 90 → 365 → Unlimited
- Content versions per object: 5 → 20 → 50 → 200 → Unlimited
- 15 tracked event types across content, integrations, and team changes
- Fire-and-forget — logging never blocks the main operation
One Group, Everything Your Team Needs
Groups are the foundation of Vivreal — every collection, site, integration, and team member lives inside one. Start free, upgrade when you need more capacity.