Organisations

An Organisation holds a collection of Projects, Members and Roles.

Creating an Organisation

Any logged-in user can create an organisation. Click the organisation selector at the top of the sidebar and choose Create Organisation.

You will be prompted for:

  • Name — the display name for the organisation.
  • ID — a unique identifier used in API calls and URLs. It can only contain lowercase letters, numbers, and hyphens, and cannot be changed after creation. By default it is auto-generated from the name.

Once created, you become the Owner of the organisation.


Members

The members list for an organisation can be seen by anyone with the See Roles and Members permission.

Each member is shown with their base role (Guest, Member, or Owner) and any assigned roles.

Inviting Members

Members with the Invite Members permission can invite new members by email address.

Click the Invite button at the top of the Members page, enter the user's email address, and click Invite. An invitation will be sent to that address.

Pending invitations appear in the Invited Members list below the active members list until the invite is accepted or cancelled.

Accepting an Invitation

When you receive an organisation invitation, it appears under Settings > Invitations. From there you can accept or decline it.

Removing Members

Members with the Remove Members permission can remove other members. Click the actions menu () next to a member and select Remove User.

Owners cannot be removed by other members — ownership must be transferred first.

Leaving an Organisation

You can leave an organisation from the members list by clicking the actions menu () next to your own name and selecting Leave Organisation. Owners cannot leave while they hold the Owner role.


Roles

Roles are named sets of permissions that can be assigned to members. See Permissions for the full list of available permissions and how they work.

Members with the Edit Roles permission can create, edit, and delete roles.

Creating a Role

  1. Go to the Roles tab of the organisation.
  2. Click Create New Role.
  3. Enter a name and select the permissions the role should grant.
  4. Click Create.

Editing a Role

Click the actions menu () next to a role and select Edit Role. Changes apply immediately to all members who hold that role.

Deleting a Role

Click the actions menu () next to a role and select Remove Role. Members who held the role will lose any permissions it granted.

Assigning Roles to Members

Members with the Modify Member Roles permission can assign or remove roles from other members. Click the actions menu () next to a member and select Assign Roles.


Settings

Organisation Owners can change the organisation name and configure default permissions from the Settings tab.

Organisation Name

The display name can be changed at any time. The organisation ID cannot be changed.

Default Permissions

Default permissions are automatically granted to every member of the organisation. Any permission enabled here applies to all members regardless of their roles. See Permissions for details.

Transferring Ownership

To transfer ownership of an organisation, promote another member to Owner via their role or permissions. Once the new Owner is in place, the previous Owner can remove their own Owner status or leave the organisation.

Only Owners can promote other members to Owner.