[Help](https://revise.io/help)›Team Folder & Mentions

# Team Folder & Mentions

Last updated November 18, 2026

Every [team](https://revise.io/articles/teams) has one shared folder, and every member can mention teammates in comments. Documents outside the folder stay private to the person who created them until that person shares them.

## The team folder

The team folder is in the sidebar of the documents list, under My Documents. It has the team's name. Every member can open and edit everything in it, including documents inside its subfolders. Seat and role make no difference.

![The documents list with the team folder selected in the sidebar and three documents in it, one of them shared by a teammate](https://revise.io/articles/team-collaboration/team-folder-light.png)

A team folder with documents from two members

A document in the folder keeps its owner, the person who created it. A teammate's document shows Shared by with their picture on its card.

## Add documents to the team folder

| To | Do this |
| --- | --- |
| Create a document in the folder | Open the folder and click New Document. |
| Import a file into it | Open the folder and click Import File. See [Importing & Exporting](https://revise.io/articles/import-export). |
| Share a document you already have | Drag it from your documents onto the team folder in the sidebar. |
| Organize the folder | Open it and click New Folder. Everything in a subfolder is shared with the team too. |
| Stop sharing a document | Drag your document out of the folder, back to My Documents. |

Teammates open the document from the folder and edit it with you in real time. See [Edit together in real time](https://revise.io/articles/sharing#real-time-collaboration).

Note: The team folder cannot be renamed, moved, or deleted. A subfolder that holds a teammate's documents cannot be deleted or moved out of the team folder until those documents are moved out of it.

## Mention a teammate in a comment

1. Select text in a document. In the Review tab, click Add Comment.
2. Type @. A list opens with the agent, the people on the document, and then everyone on your team.
3. Keep typing to narrow the list. Click a name or press Enter to insert the mention.
4. Finish the comment and post it.

![A new comment with an at sign typed and a list below it showing the Revise agent and two teammates with their email addresses](https://revise.io/articles/team-collaboration/mention-menu-light.png)

The mention list in a new comment

Mentions work the same way in replies. The person you mention gets an email with the comment, the text it is on, and a link that opens the document at that comment. A mention of you is highlighted in yellow. Other mentions are blue.

The list also includes people outside the team who you have shared documents with. Mentions need a document that is saved to your account.

## Mentions and document access

A mention gives access when it is needed. If the teammate cannot open the document yet, Revise adds them to it as an [Editor](https://revise.io/articles/sharing#roles). The comment then shows Invited with their name. The document's owner also sees Manage sharing, which opens the share dialog.

![A posted comment that starts with a mention of a teammate, with a line under it saying the teammate was invited to the document](https://revise.io/articles/team-collaboration/mention-invited-light.png)

A comment whose mention added a teammate to the document

| The person you mention | What happens |
| --- | --- |
| Can already open the document | They get the email. Their access does not change. |
| Cannot open it, and you own it or can edit it | They are added as an Editor and get the email. |
| Cannot open it, and you can only suggest or view | They are not added. The comment shows that the invite failed. Ask the owner to share the document. |

To take access back, the owner opens Share and removes the person. See [Change or remove access](https://revise.io/articles/sharing#change-or-remove-access).

## The agent in team documents

In a document other people can open, a comment goes to the agent only when it mentions @Revise. In a document only you can open, the agent answers every comment. See [Ask for changes in a comment](https://revise.io/articles/ai-reviewing-changes#ask-for-changes-in-a-comment).

Each member's AI usage counts against their own seat: the team's shared allowance for a Pro seat, the daily allowance for a Free seat. See [The shared AI allowance](https://revise.io/articles/team-billing#shared-ai-allowance).

## Limits

- A comment can mention up to 20 people.
- Each person gets one email per comment, however many times it mentions them.
- An account with an unverified email address can only add teammates by mention, not people outside the team.
