Organizations
Organizations allow you to group developers together and manage access to projects across your team.
What are Organizations?
Organizations in BetaHub serve as containers for:
- Multiple developers working on shared projects
- Project access management across team members
- Billing consolidation for paid plans
- Permission management at the organizational level
Creating an Organization
Prerequisites
To create an organization, you need:
- An active BetaHub account
- Understanding that multiple developers trigger billing
When you attempt to add a second developer to an organization on the Basic (free) plan, you’ll be prompted to upgrade to the Standard plan with a 30-day free trial. The trial begins when you complete the checkout process.
After the trial ends, you can choose to continue with the Standard plan or let the subscription expire to return to the Basic plan.
Step-by-Step Creation
- Access Organizations
- Click on your profile picture in the top right corner
- Select Organizations from the dropdown menu
- Create New Organization
- Click on Create organization
- Enter a unique organization name
- Click Create to finalize
Choose a distinctive organization name that clearly represents your team or company. Organization names must be between 3 and 255 characters.
Managing Organization Members
Inviting Developers
To add developers to your organization:
- Navigate to Organization
- Go to your profile menu → Organizations
- Click on the organization you want to manage
- Send Invitations
- Click on Invite developers
- Enter the email address of the developer you want to invite
- Click Invite to send the invitation
- Invitation Process
- The invited developer receives an email invitation
- They must accept the invitation to join
- Once accepted, they appear in your organization member list
Member Roles in Organizations
Organizations support four distinct roles with different capabilities:
Admin:
- Creates and manages the organization
- Can invite and remove members
- Manages billing and subscription
- Can create projects under the organization
- Counted toward billing
Developer:
- Can be added to projects within the organization
- Can create projects under the organization
- Counted toward billing
Support:
- Can be added to projects within the organization
- Has access to support-specific features
- Not counted toward billing (free seats)
- Availability depends on plan (Standard: 1 per project, Pro: 3 per project)
Tester:
- Can be added to projects within the organization
- Limited access for testing purposes
- Not counted toward billing
Only Admin and Developer roles count toward your subscription’s developer seats. Support and Tester roles are free seats with limited capabilities.
Removing Members
To remove a developer from your organization:
- Go to the organization management page
- Find the member in the list
- Click the Remove or Delete action
- Confirm the removal
Removing a member from the organization will also remove their access to all projects within that organization.
Organization Projects
Project Creation
When creating projects as an organization member:
- Projects are automatically associated with your organization
- Other organization members can be easily added to projects
- Billing is consolidated at the organization level
Project Access Management
Adding Organization Members to Projects:
- Go to your project page
- Navigate to the Members section
- Click Invite → From Organization
- Select organization members to add
- Assign appropriate roles (Developer, Support, Tester)
Cross-Organization Collaboration:
- You can only see and invite from organizations you belong to
- To collaborate across organizations, members must be added to relevant organizations first
Organization Member Benefits:
- Organization members who are added as testers automatically bypass Bug Isolation restrictions, allowing them to see all bugs even when isolation is enabled for external testers
Billing and Subscriptions
How Billing Works
Basic Plan (Free):
- Single developer per project
- Limited features and storage
- Support role not available
Standard Plan:
- Multiple developers per organization
- Advanced features and integrations
- Higher storage and API limits
- 1 Support member per project included
Pro Plan:
- Everything in Standard
- Priority support
- 3 Support members per project included
Billing Management
Who Gets Billed:
- Organization admins manage billing
- Charges are based on number of billable members (Admin + Developer roles)
- Support and Tester roles are not counted in billing
Trial Period:
- 30-day free trial when upgrading from Basic plan
- Full access to Standard plan features during trial
- Requires completing checkout to activate trial
- Can cancel before trial ends to avoid charges
Managing Subscriptions:
- Access billing through organization settings
- Upgrade/downgrade plans as needed
- Monitor usage and developer seat counts
Organization Settings
General Settings
Organization Details:
- Organization name (contact support to change)
- View organization membership summary
Member Management:
- View all organization members
- Track invitation status
- Manage member roles
Integrations and webhooks are configured at the project level, not the organization level. Each project has its own integration settings. See External Tool Integration for setup instructions.
Best Practices
Organization Structure
Small Teams (2-5 developers):
- Single organization for all projects
- All members as developers
- Simple permission structure
Medium Teams (6-20 developers):
- Department-based organizations
- Project-specific access control
- Mix of Developer and Support roles
Large Teams (20+ developers):
- Multiple organizations by product line
- Hierarchical access management
- Dedicated support team organization
Access Management
Principle of Least Privilege:
- Grant minimum necessary access
- Use Tester role for community members
- Reserve Developer role for core team
Regular Reviews:
- Audit organization membership quarterly
- Remove inactive members
- Update roles based on responsibilities
Project Organization
Naming Conventions:
- Use consistent project naming
- Include version or phase information
- Consider environment indicators (dev, staging, prod)
Template Usage:
- Create project templates for common setups
- Standardize tag systems across projects
- Define consistent workflows
Troubleshooting
Common Issues
Can’t Find Organization Members in Project Invites:
- Ensure you’re in the correct organization
- Verify the member has accepted their organization invitation
- Check if you have permission to manage project members
Billing Questions:
- Only organization owners can access billing
- Contact support for billing disputes
- Review member roles to understand charges
Access Problems:
- Verify organization membership status
- Check project-specific permissions
- Ensure organization trial hasn’t expired
Getting Help
Support Channels:
- Join our Discord server for community help
- Contact support for billing issues
- Check the FAQ for common questions
Documentation:
- Review project management guides
- Check integration documentation
- Explore advanced feature guides
Migration and Changes
Transferring Projects
Between Organizations:
- Contact support for project transfers
- Ensure both organizations have appropriate plans
- Plan for potential downtime during transfer
Ownership Changes:
- Organization ownership can be transferred
- All members and projects move with ownership
- Billing responsibility transfers to new owner
Organization Dissolution
Before Dissolving:
- Transfer or delete all projects
- Remove all members
- Cancel subscriptions
Impact of Dissolution:
- All organization projects become inaccessible
- Members lose access to organization resources
- Billing stops immediately
Advanced Features
API Integration
API tokens are managed at the project level. To access multiple projects programmatically, you’ll need to generate API tokens for each project individually. See API Access for details on generating and using API tokens.
Enterprise Features
Enterprise plans include additional capabilities:
- Higher developer seat limits with volume pricing
- Custom domain support for organization branding
- Priority support channels
- Extended API rate limits
Contact sales@betahub.io for enterprise plan details.
Next Steps
- API Access - Set up programmatic access
- Project Settings - Configure project defaults
- Integrations - Connect external tools
FAQ
Q: How many organizations can I belong to? A: There’s no limit on organization membership. You can be part of multiple organizations.
Q: Can I move a project between organizations? A: Yes, contact support to transfer projects between organizations you have access to.
Q: What happens if I don’t pay after the trial? A: Your organization will revert to the Basic (free) plan, limiting you to single-developer projects.
Q: Can organization members see all projects? A: No, organization members only see projects they’ve been specifically added to.
See Also
- Project Settings – Configure project options
- Security – Authentication and access control
- Project Setup – Create and configure projects