# Org, members and teamspaces

Set up your org, invite members by email or link, give them roles, and group them into teamspaces that own products.

Your org is where your team's products, repos, library, knowledge and work live. This page covers the people side:
who is in the org, what they can do, and how you group them. You need to be an owner or admin for most of it.

## How does my org get created?

When your team joins EasyCode, the org is created for you and its first admin gets an invitation email. Open the
link, sign in with the address it was sent to, and you land on the org's home.

The home shows a setup checklist to owners and admins: **Install the GitHub App**, **Register your repos** (or
**Create products**), **Create teamspaces** and **Invite people**. Each step opens the page that does it. Dismiss a
step you don't need; the checklist goes away when every step is done or dismissed.

## Which roles are there?

| Role       | What they can do                                                             |
| ---------- | ---------------------------------------------------------------------------- |
| **Owner**  | Everything an admin can, and make someone an owner or change an owner's role |
| **Admin**  | Manage members, invitations, teamspaces, products, repos and org settings    |
| **Member** | Work in the products they can reach, join teamspaces, see members            |
| **Guest**  | See what they are given; can't join teamspaces or manage anything            |

Org settings show each person only the sections their role allows. **General** (name, slug and logo) and **Repos**
are for owners and admins. The [roles and access](/overview/roles-and-access) page explains how roles combine with
product access.

## Invite people by email

Open **Settings → Members** and click **Invite people**.

Enter up to 20 email addresses, separated by commas or new lines.

Pick a **Role**, **Member** or **Admin**. Optionally pick a **Persona** (dev, pm, qa, designer, devops, marketer or
lead) and the **Teamspaces** they join.

Click **Send invitations**. Each address shows **Invitation sent**, **Already a member**, **Already invited** or
**Not sent**. Invite a _Not sent_ address again to retry.

Pending invitations are listed under the members table until they are accepted.

## Invite people with a link

A link lets anyone who has it join as a member, until it expires. Under **Invite links**, click **Create link**,
set **Expires in (days)** (1 to 30) and, optionally, **Max uses**, then click **Create link** and copy it.

A link shows **Active**, **Expired** or **Used up**. **Reset** gives it a new address and the old one stops working.
**Revoke** ends it.

> **Warning**
>
> Anyone who has an active link can join your org. Share it only in a channel your team controls, and revoke it when
> you are done.

## Change a role or remove someone

In the members table, open the **⋯** menu on a person's row. Under **Role**, pick the new role. **Remove from org**
takes away their access. Search by name or email, or filter by role, teamspace or persona to find someone.

To leave an org yourself, open the menu on your own row and click **Leave org**.

## Group people into teamspaces

A teamspace is a group of people, such as _Checkout_ or _Platform_. A product is granted to a teamspace, so its
members get that product. Every org has an **Everyone** teamspace that all members are in; it always stays open.

Open **Settings → Teamspaces** and click **New teamspace**.

Enter a **Name**, an optional **Slug** and **Description**, and choose a **Visibility**:
**Open** (anyone in the org can join), **Closed** (anyone can see it; people ask to join) or **Private** (only its
members see it).

Click **Create teamspace**, then open it and use **Add member** to add people as **Lead** or **Member**.

Admins and a teamspace's leads manage its members and details. Members see **Join** on an open teamspace and
**Ask to join** on a closed one; asking notifies its leads.

**Archive teamspace** takes it out of the lists and removes its product grants. Use **Show archived** to find it
again.

## Next

- [Products and repos](/setup/products-and-repos): connect GitHub and grant products to your teamspaces.
- [Quickstart for org admins](/setup/quickstart-admins): the whole setup in order.
