---
tags: tutorials
disqus: hackmd
---
{%hackmd KghC_AJ7Rui37eDW5PVl9Q %}

Create and manage Team
===
{%hackmd @docs/base-theme %}

## Create a new Team

 **▲ Create a team from the sidebar**
Find the <i class="fa fa-angle-down fa-fw"></i> icon at the top-right corner of your dashboard sidebar, then click <i class="fa fa-plus fa-fw"></i>**Create new team**. Enter your team name, description (optional), URL, and choose the privacy type that fits your needs.

Team owner and admin can change the name, description, and URL later at <i class="fa fa-gear"></i> **Team settings** next to the team name on the sidebar.

## Team privacy types
There are two types of HackMD teams: private team is good for team collaboration, whereas public team is great for engaging with the open community.

| | Public Team (Free) | Private Team (Free) | Private Team (Paid) |
| --------------- | ------------------ | ------------------- | ------------------- |
| **Publishing** | ==Notes are public== | Optional | Optional |
| **Note privacy** | ==Everyone== | Team members | Team members |
| **Image storage** | imgur | imgur | ==Private S3 bucket== |
| **Member limit** | Unlimited | ==3 members== | Unlimited |

Choose the team privacy type that fits your needs.

:::info
:bulb: **Hint:** [Detailed plan comparison can be found here. <i class="fa fa-angle-right"></i>](/pricing)
:::

## Manage Team

### 1. Add a member

 **▲ Add team member in team settings**
Enter the **Team settings** page by clicking the <i class="fa fa-gear"></i> next to your team name on the sidebar. Switch to the **Members** tab to add a new member by their username or email.

### 2. Manage member permission

 **▲ Manage member permission in team settings**

You can adjust the role of each team member. See below for what each role could do:

| | Owner | Admin | Writer | Reader |
| ------------------ | ------------------ | ------------------ | ------------------ | ------------------ |
| Delete the team | :heavy_check_mark: | | | |
| Manage team member | :heavy_check_mark: | :heavy_check_mark: | | |
| Delete team note | :heavy_check_mark: | :heavy_check_mark: | | |
| Transfer team note ownership | :heavy_check_mark: | :heavy_check_mark: | | |
| Sync team note to GitHub | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | |
| Edit team note | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | |
| Read team note | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |

> :heavy_check_mark: Role has privilege.

### 3. Remove a member

 **▲ Remove team member in team settings**

Click the <i class="fa fa-times-circle"></i> icon at the far right of the member row to remove that member.

### 4. Leave the team
 **▲ Leave a team from the sidebar**

If you are NOT the team owner, click the <i class="fa fa-gear"></i> icon next to your team name on the sidebar to leave the team.

If you are the team owner, you cannot leave the team without deleting the team.

## Delete Team
 **▲ Delete a team in team settings**

At the bottom of the **Team settings** page, you will find in the **Danger zone** the button to delete the team.

:::danger
:warning: **Warning:** When a team is deleted, all team notes will be deleted as well - and it is unrecoverable. Please make sure to export or transfer the ownership of your team notes first.
:::

## View all my teams
 **▲ View all my teams from the settings**

You could view all your teams at once. Click on your name at the bottom of the sidebar and select **My teams** from the list of options. You will see all the teams you're in and your roles in them.

## Team profile page

 **▲ View team profile page from the sidebar**

Each team has its profile page at `https://hackmd.io/@<team_name>`.
Filter team notes by tags with <i class="fa fa-tag"></i>**Tags** at the top of the page. Search by note title and tag in the search bar next to the tags filter.

If you are a member of the team, you could switch between viewing either all the team notes or only published notes on the team's profile page.

The sidebar will show information about the team. Team members and contributors are visible for public teams, but **hidden from outsiders for private teams**.

## Read next

<a href="/@docs/what-is-team" class="link-card">
<i class="fa fa-angle-left" aria-hidden="true"></i>
What is Team?
</a>

<a href="/@docs/manage-team-notes" class="link-card ml-3">
Manage team notes
<i class="fa fa-angle-right" aria-hidden="true"></i>
</a>

###### tags: `tutorials`