Skip to content

armgit / zulip

Public Imported from GitHub
0

Zulip server and web application. Open-source team chat that helps teams stay productive and focused.

4.0 KB
Raw Blame
---
title: User roles
---

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](/help/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](/help/manage-permissions) by
  your organization.
* **Member**: This is the default role for most users. Members have access to
  all public channels. You can [configure different
  permissions](/help/restrict-permissions-of-new-members) for **new members**
  and **full members**, which is especially useful for [moderating open
  organizations](/help/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](/help/guest-users) 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](#roles) from the **Roles** dropdown.
</FlattenedSteps>

## Related articles

* [Guest users](/help/guest-users)
* [User groups](/help/user-groups)
* [Manage permissions](/help/manage-permissions)
* [Manage a user](/help/manage-a-user)
* [Deactivate or reactivate a user](/help/deactivate-or-reactivate-a-user)