ContextQMD
Back to Zulip

Invite new users

starlight_help/src/content/docs/invite-new-users.mdx

12.05.1 KB
Original Source

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import NavigationSteps from "../../components/NavigationSteps.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import InviteUsers from "../include/_InviteUsers.mdx";

import SendDmIcon from "~icons/zulip-icon/send-dm"; import TrashIcon from "~icons/zulip-icon/trash";

You can invite users to join your organization by sending out email invitations, or creating reusable invitation links to share.

Prior to inviting users to your organization, it is recommended that administrators:

When you invite users, you can:

  • Set the role that they will have when they join.
  • Configure which channels they will be subscribed to. The organization's default channels will be preselected.
  • Configure which groups they will be added to.
  • Customize the welcome message.

Organization administrators can configure who is allowed to invite users to the organization. You will only see an Invite users menu option if you have permission to invite users.

Send email invitations

<FlattenedSteps> <InviteUsers />
  1. Enter a list of email addresses.
  2. Toggle Send me a direct message when my invitation is accepted, to receive a notification when an invitation is accepted.
  3. Select when the invitations will expire.
  4. Select what role the users will join as.
  5. Configure which channels they will be subscribed to.
  6. Configure which groups they will be added to.
  7. (optional; administrators only) Customize the welcome message.
  8. Click Invite. </FlattenedSteps>
<ZulipNote> **Note**: As an anti-spam measure, the number of email invitations you can send in a day is limited on the Zulip Cloud Free plan. If you hit the limit and need to invite more users, consider creating an [invitation link](#create-a-reusable-invitation-link) and sharing it with your users directly, or [contact support](/help/contact-support) to ask for a higher limit. </ZulipNote> <ZulipNote> **Warning**: When an account is created by accepting an email invitation, the user is immediately logged in to their new account. Any restrictions on [allowed authentication methods](/help/configure-authentication-methods) are not applied. </ZulipNote>

Example email invitation

<FlattenedSteps> <InviteUsers />
  1. Select Invitation link.
  2. Select when the invitation will expire.
  3. Select what role the users will join as.
  4. Configure which channels they will be subscribed to.
  5. Configure which groups they will be added to.
  6. (optional; administrators only) Customize the welcome message.
  7. Click Create link.
  8. Copy the link, and send it to anyone you'd like to invite. </FlattenedSteps>

Manage pending invitations

Organization owners can revoke or resend any invitation or reusable invitation link. Organization administrators can do the same except for invitations for the organization owners role.

Revoke an invitation

<FlattenedSteps> <NavigationSteps target="settings/invitations" />
  1. Select the Invitations tab.
  2. Find the invitation you want to revoke.
  3. Click the revoke (<TrashIcon />) icon next to the invitation. </FlattenedSteps>

Resend an invitation

<FlattenedSteps> <NavigationSteps target="settings/invitations" />
  1. Select the Invitations tab.
  2. Find the invitation you want to resend.
  3. Click the resend (<SendDmIcon />) icon next to the invitation. </FlattenedSteps>
<ZulipNote> **Note:** You can **revoke** both email invitations and invitation links, but you can **resend** only email invitations. </ZulipNote>