Billing
Manage your team's plan, upgrade, and understand usage limits.
Billing
KeyEnv offers three plan tiers. Each team has its own plan and billing. Only team admins can view and manage billing.
Plan Tiers
Free
The default plan for every new team. Includes:
| Resource | Limit |
|---|---|
| Team members | 1 |
| Projects | 3 |
| Secrets per environment | 100 |
| Environments per project | 3 |
The Free plan is suitable for personal projects and solo developers. All core features (encryption, CLI, environment permissions, audit trail) are included.
Team
For teams that need collaboration and higher limits. Includes:
| Resource | Limit |
|---|---|
| Team members | Unlimited |
| Projects | Unlimited |
| Secrets per environment | Unlimited |
| Environments per project | Unlimited |
Pricing: $4/user/month or $40/user/year ($3.33/month, save 17%). Billed per active team member -- the seat count adjusts automatically when members join or leave.
Enterprise
For organizations with advanced requirements. Includes everything in Team plus:
- Priority support
- Custom integrations
- SLA guarantees
Contact us at [email protected] for Enterprise pricing.
Free Trial
New teams receive a 14-day free trial of Team plan features when they first sign up. During the trial:
- All Team plan limits are available (unlimited projects, secrets, members, and environments)
- No payment method is required
- An email notification is sent 3 days before the trial ends
- When the trial expires, the team automatically downgrades to the Free plan
You can upgrade to a paid Team plan at any time during the trial. If you upgrade, the trial ends immediately and billing begins.
Upgrading to Team
Only team admins can upgrade the plan.
- Go to Team in the sidebar
- Click Billing or Upgrade
- Choose monthly or annual billing
- Complete payment through the Stripe checkout page
- Your plan upgrades immediately after payment
The upgrade takes effect instantly. All limits are lifted and you can invite members, create projects, and add secrets without restrictions.
Subscription States
Your subscription can be in one of the following states:
| State | Description |
|---|---|
active | Subscription is current and fully paid. All Team plan features are available. |
trialing | Team is in the 14-day free trial period. All Team plan features are available. |
past_due | A payment has failed. The system will retry automatically. Features remain available while retries are in progress. |
canceled | Subscription has been canceled. The team reverts to the Free plan at the end of the current billing period. |
Managing Your Subscription
After upgrading, team admins can manage the subscription through the Stripe billing portal:
- Go to Team in the sidebar
- Click Billing
- Click Manage Subscription
From the billing portal you can:
- Update your payment method
- View invoices and payment history
- Switch between monthly and annual billing
- Cancel your subscription
Downgrading
When you cancel your Team subscription, the following happens:
- Your plan reverts to Free at the end of the current billing period
- Existing resources are kept -- your projects, secrets, members, and environments remain intact
- New creation is blocked -- if your usage exceeds Free plan limits, you cannot create new resources of that type until you reduce usage or re-upgrade
- Team admins receive a notification about the over-limit state
KeyEnv never deletes your data on downgrade. Your existing secrets and projects remain accessible. You just cannot create new ones beyond Free plan limits.
Over-Limit State
If your team's usage exceeds the plan limits (typically after a downgrade from Team to Free), you enter an over-limit state:
- A warning banner appears in the web app
- The API returns a
402 Payment Requirederror when attempting to create resources that are over the limit - Existing resources continue to work normally (read, update, delete)
Resolving Over-Limit
To resolve an over-limit state, you can either:
- Reduce usage -- Delete projects, secrets, or environments to bring usage within Free plan limits
- Remove members -- Remove team members to get within the 1-member Free limit
- Upgrade -- Re-upgrade to Team to remove all limits
Sponsored Teams
In some cases, a KeyEnv administrator may sponsor a team, granting it Team features at no cost. Sponsored teams:
- Have all Team plan limits (unlimited everything)
- Do not need a Stripe subscription
- Cannot be charged through the checkout flow (checkout is blocked for sponsored teams)
- May include an optional note from the administrator explaining the sponsorship
Email Notifications
KeyEnv sends email notifications for the following billing events:
- Subscription created -- when a team upgrades to the Team plan
- Trial ending -- sent 3 days before the free trial expires
- Payment failed -- when a payment attempt is unsuccessful (includes the next retry date)
- Subscription renewed -- when a subscription is successfully renewed at the start of a new billing period
Viewing Usage
Any team member can view the team's current resource usage:
- Go to Team in the sidebar
- The usage section shows current counts and limits for:
- Projects
- Team members
- Secrets (highest count across all environments)
- Environments (highest count across all projects)
Usage warnings appear when you reach 80% of a limit. At-limit indicators appear when you have reached the maximum.