Managing deployments for multiple clients is challenging enough without the headache of juggling user permissions across dozens of projects. That's why we're excited to announce Teams Management — a powerful new feature that makes organizing user access simple, scalable, and secure.
Available on Business and Enterprise plans, Teams Management lets you group users into teams with shared permissions and project access, eliminating the need to configure each user individually.
Why We Built Teams Management
As agencies grow and take on more clients, managing who can access what becomes increasingly complex. We heard from many of you that:
- Onboarding new developers meant tediously configuring permissions across multiple projects
- Client-specific access requirements were difficult to maintain
- Offboarding team members was error-prone and time-consuming
- There was no easy way to ensure consistent access policies across your organization
Teams Management solves all of these problems by letting you define access once at the team level and have it automatically apply to all team members.
How It Works
Teams are groups of users that share common permissions and project access. Instead of setting up permissions for each person individually, you create a team, configure its access levels, and then simply add users to that team. They immediately inherit all the team's permissions.
Account-Level Permissions
Each team can be granted specific account-level capabilities:
- Account Administrator: Full access to everything, including billing
- User Management: Ability to create, delete, and assign users to projects
- Billing Access: View and manage payment methods, invoices, and subscription changes
- Project Creation: Create new projects and manage them
Granular Project Access
Beyond account-level permissions, you can control exactly which projects each team can access:
- Grant access to all projects with a single toggle
- Or select specific projects for targeted access
- For each project, configure whether team members can deploy to specific servers, update project settings, or manage configuration files
Perfect for Agencies
If you're an agency managing deployments for multiple clients, Teams Management is built with your workflow in mind.
Create Client-Specific Teams
Set up a team for each client project with access limited to just that client's projects and servers. When you bring on a contractor for a specific engagement, add them to the relevant team and they'll have exactly the access they need — nothing more, nothing less.
Organize by Role
Create teams based on job function: a Developers
team with deployment access, a Project Managers
team with read-only visibility, and an Ops
team with full configuration access. As your team grows, new hires simply get added to the appropriate team.
Simplify Onboarding and Offboarding
When someone joins, add them to the right teams and they're ready to go. When they leave, remove them and their access is revoked instantly across all projects. No more auditing individual project permissions or worrying about forgotten access.
Maintain Client Confidentiality
Ensure developers working on Client A's projects never accidentally see Client B's deployment configurations. Teams create clear boundaries that protect sensitive information and maintain client trust.
Combining Teams with Individual Permissions
Teams work alongside individual user permissions, giving you maximum flexibility. When a user has both team-based and individual permissions, the most permissive access applies.
This means you can:
- Use teams for baseline access that applies to everyone in a role
- Add individual permissions for special cases or temporary access
- Maintain fine-grained control while still benefiting from team-based organization
Getting Started
Setting up your first team takes just a few minutes:
- Go to Settings → Team Management
- Click New Team and give it a name
- Select which users should be members
- Configure the team's account-level permissions
- Choose which projects the team can access and set project-specific permissions
- Click Create Team
That's it. All team members immediately have the access you've configured.
If you're new to DeployHQ, check out our beginner's guide to get started with your first deployment before setting up teams.
Available on Business and Enterprise Plans
Teams Management is available now for all Business and Enterprise customers. If you're on a different plan and want to take advantage of this feature, you can upgrade your subscription from Settings → Subscription Plans.
For detailed documentation on all Teams Management capabilities, visit our support article.
What's Next
With Teams Management in place, you can now pair it with other DeployHQ features to build a complete agency workflow:
- Use multiple environments per client project for dev, staging, and production
- Automate your workflows further with the DeployHQ API
- Follow our security checklist to lock down your deployments
Frequently Asked Questions
Can a user belong to multiple teams?
Yes! Users can be members of multiple teams simultaneously. Their effective permissions will be the combination of all team permissions — so if Team A grants access to Project X and Team B grants access to Project Y, the user will have access to both projects.
What happens when I delete a team?
Deleting a team removes the permissions granted by that team, but it doesn't delete the users themselves. Users will retain any individual permissions they have, as well as permissions from other teams they belong to.
Can I use teams and individual permissions together?
Absolutely. Teams and individual permissions work side by side. When a user has both, the most permissive access wins. This gives you flexibility to use teams for standard role-based access while handling exceptions through individual permissions.
Do changes to team permissions take effect immediately?
Yes. Any changes you make to a team's permissions or project access apply immediately to all team members.
Can team members deploy to all servers or just specific ones?
You have full control. For each project a team can access, you can either allow deployment to all servers or restrict it to specific servers or server groups.
Is Teams Management available on all plans?
Teams Management is available on Business, Enterprise, and all Enterprise tier plans. If you're on a Free or Basic plan, you can upgrade from Settings → Subscription Plans to access this feature.
How is this different from just setting individual user permissions?
Individual permissions work great for small teams, but they don't scale well. With teams, you configure permissions once and apply them to many users. Onboarding becomes add to team
instead of configure 15 different project permissions.
It's faster, less error-prone, and much easier to audit.
Have questions about Teams Management or want to share how you're using it? We'd love to hear from you — reach out to our support team or connect with us on Twitter.