From 886df770f474a37445a08c0f48514f2ad5b7ae97 Mon Sep 17 00:00:00 2001 From: "Carrie Warner (Mattermost)" <74422101+cwarnermm@users.noreply.github.com> Date: Tue, 11 Feb 2025 09:27:05 -0500 Subject: [PATCH] Clarified private channel conversion requirements (#7734) * Clarified private channel conversion requirements * Incorporated reviewer updates --- source/collaborate/convert-public-channels.rst | 16 +++++++++------- ...vanced-permissions-backend-infrastructure.rst | 3 --- 2 files changed, 9 insertions(+), 10 deletions(-) diff --git a/source/collaborate/convert-public-channels.rst b/source/collaborate/convert-public-channels.rst index 1a00cbe9a9f..75e3a7af88d 100644 --- a/source/collaborate/convert-public-channels.rst +++ b/source/collaborate/convert-public-channels.rst @@ -53,13 +53,15 @@ You must be a system admin or team admin to convert public channels to private c Convert private channels to public channels ------------------------------------------- -Due to potential security concerns with sharing private channel history, only system admins can convert private channels to public channels. +Due to potential security concerns with sharing private channel history, only system admins can convert private channels to public channels using the System Console. -1. Go to **System Console > Channels**. -2. Select **Edit** for an existing private channel. You can also filter the list of channels to private channels only. -3. Under **Channel Management > Public channel or private channel**, select **Private**. If :ref:`Sync Group channel management ` is enabled, private channels can't be converted to public channels. -4. Select **Save**. +.. note:: -.. tip:: + - The ability to convert private channels to public channels using the `API `_ or :ref:`mmctl channel modify command ` is limited to system admins, team admins, and users with specific granular admin roles. Team admins have this permission by default, but system admins can restrict it or assign it to other roles. + - Granular roles require permissions for managing User Management Channels and Groups, including ``sysconsole_write_user_management_channels`` and ``sysconsole_write_user_management_groups``. Manage permissions through the :ref:`permission scheme `. + - If :ref:`Sync Group channel management ` is enabled, private channels can't be converted to public channels. - Alternatively, system admins can convert private channels to public channels using the :ref:`mmctl channel modify command `. +1. Go to **System Console > Channels**. +2. Select **Edit** for an existing private channel. You can also filter the list of channels to private channels only. +3. Under **Channel Management > Public channel or private channel**, select **Private**. +4. Select **Save**. \ No newline at end of file diff --git a/source/onboard/advanced-permissions-backend-infrastructure.rst b/source/onboard/advanced-permissions-backend-infrastructure.rst index df37de85990..a6fc66435ad 100644 --- a/source/onboard/advanced-permissions-backend-infrastructure.rst +++ b/source/onboard/advanced-permissions-backend-infrastructure.rst @@ -498,7 +498,6 @@ The following built-in roles with default permissions are available: - read_public_channel - manage_team - read_channel -- convert_private_channel_to_public - sysconsole_read_integration - read_public_channel_groups - list_public_teams @@ -596,7 +595,6 @@ The following built-in roles with default permissions are available: - convert_public_channel_to_private - manage_channel_roles - sysconsole_read_user_management_teams -- convert_private_channel_to_public - read_public_channel_groups - delete_public_channel - remove_user_from_team @@ -618,7 +616,6 @@ The following built-in roles with default permissions are available: - manage_others_incoming_webhooks - manage_channel_roles - read_public_channel_groups -- convert_private_channel_to_public - remove_reaction - delete_post - manage_outgoing_webhooks