starlight_help/src/content/docs/user-groups.mdx
import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";
import FlattenedSteps from "../../components/FlattenedSteps.astro"; import NavigationSteps from "../../components/NavigationSteps.astro"; import CloudPaidPlansOnly from "../include/_CloudPaidPlansOnly.mdx"; import UserGroupsApplications from "../include/_UserGroupsApplications.mdx"; import UserGroupsIntro from "../include/_UserGroupsIntro.mdx";
import SubscriberCheckIcon from "~icons/zulip-icon/subscriber-check"; import SubscriberPlusIcon from "~icons/zulip-icon/subscriber-plus";
<CloudPaidPlansOnly /> <UserGroupsIntro /> <UserGroupsApplications />You can add a group to another user group, making it easy to express your organization's structure in Zulip's permissions system.
1. Scroll through the list of user groups. You can use the **search box** near
the top of the menu to filter the list by group name or description.
1. Click the **join group** (<SubscriberPlusIcon class="zulip-unplugin-icon subscriber-plus-icon" />) icon to the left of a user group to
join the group, if you have
[permission](/help/manage-user-groups#configure-group-permissions) to do so.
</FlattenedSteps>
1. Click the **leave group** (<SubscriberCheckIcon class="zulip-unplugin-icon subscriber-check-icon" />) icon to the left of a user group to leave the
group, if you have
[permission](/help/manage-user-groups#configure-group-permissions) to do so.
</FlattenedSteps>