Back to Zulip

User roles

starlight_help/src/content/docs/user-roles.mdx

12.03.9 KB
Original Source

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

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import NavigationSteps from "../../components/NavigationSteps.astro"; import AdminOnly from "../include/_AdminOnly.mdx"; import ManageThisUser from "../include/_ManageThisUser.mdx"; import ManageUserTabTip from "../include/_ManageUserTabTip.mdx"; import UserRolesIntro from "../include/_UserRolesIntro.mdx"; import ViewUsersByRole from "../include/_ViewUsersByRole.mdx";

import UserCogIcon from "~icons/zulip-icon/user-cog";

<UserRolesIntro />

You can also manage permissions with custom user groups.

Roles

  • Organization owner: Can manage users, public channels, organization settings, and billing. Organization owners can do anything that an organization administrator can do.
  • Organization administrator: Can manage users, public channels, and organization settings. Cannot make someone an owner, or change an existing owner's role.
  • Moderator: Can do anything that members can do, plus additional permissions configured by your organization.
  • Member: This is the default role for most users. Members have access to all public channels. You can configure different permissions for new members and full members, which is especially useful for moderating open organizations. New members automatically become full members after a configurable waiting period.
  • Guest: Can view and send messages in channels they have been subscribed to. Guests cannot see other channels, unless they have been specifically subscribed to the channel. See guest users documentation for additional details and configuration options.

View users by role

<ViewUsersByRole />

Review and remove permissions assigned to a role

You can review which permissions are assigned to a role, and remove permissions as needed.

<Tabs> <TabItem label="Desktop/Web"> <FlattenedSteps> <NavigationSteps target="relative/group/roles" />
  1. Select a role.
  1. Select the **Permissions** tab on the right.
  1. Toggle the checkboxes next to any permissions you'd like to remove.
  1. Click **Save changes**.
</FlattenedSteps>
</TabItem> </Tabs>

Change a user's role

<AdminOnly />

An organization owner can change the role of any user. You can make yourself no longer an owner only if there is at least one other owner for your organization. An organization administrator cannot make someone an owner, or change an existing owner's role.

<Tabs> <TabItem label="Via user profile"> <FlattenedSteps> <ManageThisUser />
  1. Under **User role**, select a [role](#roles).
  1. Click **Save changes**. The new permissions will take effect immediately.
</FlattenedSteps>

<ManageUserTabTip />
</TabItem> <TabItem label="Via organization settings"> <FlattenedSteps> <NavigationSteps target="settings/users" />
  1. Find the user you would like to manage. Click the **manage user**
     (<UserCogIcon />) icon to the right of their name.
  1. Under **User role**, select a [role](#roles).
  1. Click **Save changes**. The new permissions will take effect immediately.
</FlattenedSteps>
</TabItem> </Tabs>

Change your role

<AdminOnly />

Organization owners and administrators can change their own roles, with the restriction that administrators cannot make themselves owners.

<FlattenedSteps> <NavigationSteps target="settings/account-and-privacy" />
  1. Under Account, select a role from the Roles dropdown. </FlattenedSteps>