Organizations
What is an Organization?
Organizations allow you to manage multiple repositories, teams, and members under a single umbrella. They're perfect for companies, open-source projects, and large teams.
Creating an Organization
Steps
- Click "+" → "New Organization"
- Fill in:
- Organization Name: Unique name (alphanumeric, hyphens)
- Description (optional): What your org does
- Website (optional): Your organization's website
- Click "Create Organization"
Organization Features
Repositories
- Create repositories under the organization
- Share repositories among team members
- Manage repository access centrally
Teams
Create teams with specific permissions:
- Owners: Full control over organization
- Members: Access to assigned repositories
- Custom Teams: Define custom permissions
Members
- Invite users to join the organization
- Assign roles (Owner, Member)
- Manage membership
Managing Organization
Settings
Access organization settings:
- Navigate to organization page
- Click "Settings" tab
Available settings:
- Profile: Update name, description, avatar, website
- Collaboration: Manage members and teams
- Repositories: Manage organization repositories
- Hooks: Organization-wide webhooks
Members Management
Invite Members:
- Go to Settings → Members
- Search for users
- Click "Add Member"
Manage Roles:
- Owner: Can manage organization settings and repositories
- Member: Can access assigned repositories
Remove Members:
- Go to Settings → Members
- Find the member
- Click "Remove"
Teams
Create teams for better organization:
- Go to Settings → Teams
- Click "New Team"
- Configure:
- Team Name: Descriptive name
- Description: Team purpose
- Permission Level: Read, Write, or Admin
- Members: Add team members
- Repositories: Grant access to repositories
- Click "Create Team"
Repository Permissions
Team Permissions
- Read: View and clone repositories
- Write: Push to repositories
- Admin: Full control including settings
Individual Permissions
Override team permissions for specific users:
- Go to repository Settings
- Collaboration → Add individual collaborator
- Set permission level
Best Practices
- ✅ Use descriptive organization names
- ✅ Create teams based on roles or projects
- ✅ Assign minimum required permissions
- ✅ Regularly review member access
- ✅ Document team responsibilities
- ✅ Use organization webhooks for automation
Organization vs Personal Account
| Feature |
Personal |
Organization |
| Ownership |
Individual |
Multiple owners |
| Repositories |
Personal |
Shared |
| Teams |
No |
Yes |
| Billing |
Free |
Free (self-hosted) |
| Best for |
Individual projects |
Teams & companies |
Next Steps