Back to Zulip

Mention a user or group

starlight_help/src/content/docs/mention-a-user-or-group.mdx

12.04.0 KB
Original Source

import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import ZulipTip from "../../components/ZulipTip.astro"; import MentionsExamples from "../include/_MentionsExamples.mdx"; import MentionsIntro from "../include/_MentionsIntro.mdx"; import RightSidebarUserCard from "../include/_RightSidebarUserCard.mdx"; import StartComposing from "../include/_StartComposing.mdx";

<MentionsIntro /> <ZulipTip> If you edit a message, adding or removing mentions will update message notifications. [Learn more](/help/edit-a-message#message-notifications). </ZulipTip>

Mention a user or group

From the compose box

<Tabs> <TabItem label="Desktop/Web"> <FlattenedSteps> <StartComposing />
  1. Type `@` followed by a few letters from a name.
  1. Pick the appropriate user or user group from the autocomplete.
</FlattenedSteps>

<ZulipTip>
  You can also type a user's email address or (when enabled) an external
  account username in a [custom profile field](/help/custom-profile-fields).
</ZulipTip>
</TabItem> <TabItem label="Mobile"> <Steps> 1. Tap the compose box at the bottom of the app. 1. Type `@` followed by a few letters from a name. 1. Pick the appropriate user or user group from the autocomplete. </Steps> </TabItem> </Tabs>

From the user list

<FlattenedSteps> <RightSidebarUserCard />
  1. Select Copy mention syntax to add it to your clipboard.
  2. Paste the user's mention syntax in the compose box. </FlattenedSteps>

Via a message

<Steps> 1. Click on a user's profile picture or name on a message they sent to open their **user card**. 1. Select **Reply mentioning user** to start a reply to the conversation with a mention inserted into the compose box. </Steps>

Silently mention a user

You can use a silent mention to refer to a user or group without drawing their attention. Silent mentions are displayed without an @ in the message feed.

<FlattenedSteps> <StartComposing />
  1. Type @_ (rather than just @), followed by a few letters from a name.
  2. Pick the appropriate user or user group from the autocomplete. </FlattenedSteps>
<ZulipTip> You can also type a user's email address or (when enabled) an external account username in a [custom profile field](/help/custom-profile-fields). </ZulipTip>

Mention all topic participants

Using the @**topic** mention, you can mention everyone who has previously participated in the topic by sending a message or reacting with an emoji. This lets you notify just those who have already engaged in the conversation.

Users can disable notifications for @**topic** mentions by:

Mention everyone on a channel

You can mention everyone on a channel with the @**all** mention (or, equivalently, @**everyone** or @**channel**). It's best to use these mentions only when your message requires timely attention from many channel subscribers. An organization can be configured to restrict wildcard mentions in large channels.

Users can disable notifications for @**all**, @**everyone**, and @**channel** mentions by:

Examples

<MentionsExamples />