Skip to main content
Organizations are the root of Orchard’s resource hierarchy. They represent your team, company, or personal account and contain all your workspaces, projects, and deployments.
Orchard is currently in closed beta. Organizations are created by the Hack Club team, and you need an invitation to join one.

What is an Organization?

An organization is a container that:
  • Groups all related workspaces and projects together
  • Manages team membership and roles
  • Provides a unique slug for URL identification
  • Can have an avatar and description for identification

Organization Hierarchy

Organization (e.g., "Acme Corp")
├── Workspace (e.g., "Production")
│   ├── Project (e.g., "API")
│   └── Project (e.g., "Web App")
└── Workspace (e.g., "Staging")
    └── Project (e.g., "API")

Joining an Organization

During the closed beta, you need an invitation to join an organization.
1

Receive an invitation

An organization admin will send you an invitation via email.
2

Click the invitation link

Open the email and click Accept Invitation.
3

Sign in or create account

If you don’t have an account, you’ll be prompted to create one.
4

Access granted

You’ll be added to the organization with the role specified in the invitation.

Organization Roles

Members of an organization can have one of three roles:
RolePermissions
OwnerFull control over the organization, including deletion. Cannot be removed.
AdminCan manage members, workspaces, and settings. Cannot delete the organization.
MemberCan access workspaces they’ve been invited to. Cannot manage organization settings.

Managing Members

Inviting Members

1

Open organization settings

Navigate to your organization and click Settings or the members section.
2

Click 'Invite Member'

Enter the email address of the person you want to invite.
3

Select a role

Choose the appropriate role (Owner, Admin, or Member).
4

Send invitation

The invited person will receive an email with a link to join. Invitations expire after 7 days.

Managing Existing Members

From the members list, you can:
  • Change roles: Click on a member’s role to update it
  • Remove members: Click the remove button to revoke access (owners cannot be removed)
  • View pending invitations: See and resend invitations that haven’t been accepted
Removing a member from an organization also removes them from all workspaces within that organization.

Organization Settings

Basic Information

You can update your organization’s:
  • Name: The display name of your organization
  • Description: A brief description visible to members
  • Avatar: Upload an image (JPEG, PNG, GIF, or WebP, max 5MB)

Danger Zone

From the organization settings, you can also:
  • Transfer ownership: Assign another admin as the owner
  • Delete organization: Permanently remove the organization and all its contents
Deleting an organization is permanent and will remove all workspaces, projects, deployments, and data within it. This action cannot be undone.

Best Practices

Keep all related projects within a single organization for easier access management and billing.
Choose clear, recognizable names for your organization that team members will easily identify.
Only grant admin or owner roles to people who need to manage the organization structure. Most team members should be regular members.
Instead of creating separate organizations for staging and production, use workspaces within a single organization.

Next Steps