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

  1. Click "+""New Organization"
  2. Fill in:
    • Organization Name: Unique name (alphanumeric, hyphens)
    • Description (optional): What your org does
    • Website (optional): Your organization's website
  3. 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:

  1. Navigate to organization page
  2. 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:

  1. Go to SettingsMembers
  2. Search for users
  3. Click "Add Member"

Manage Roles:

  • Owner: Can manage organization settings and repositories
  • Member: Can access assigned repositories

Remove Members:

  1. Go to SettingsMembers
  2. Find the member
  3. Click "Remove"

Teams

Create teams for better organization:

  1. Go to SettingsTeams
  2. Click "New Team"
  3. Configure:
    • Team Name: Descriptive name
    • Description: Team purpose
    • Permission Level: Read, Write, or Admin
    • Members: Add team members
    • Repositories: Grant access to repositories
  4. 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:

  1. Go to repository Settings
  2. Collaboration → Add individual collaborator
  3. 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