Skip to content

Commit

Permalink
Clarified private channel conversion requirements (#7734)
Browse files Browse the repository at this point in the history
* Clarified private channel conversion requirements

* Incorporated reviewer updates
  • Loading branch information
cwarnermm authored Feb 11, 2025
1 parent 60c7446 commit 886df77
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 10 deletions.
16 changes: 9 additions & 7 deletions source/collaborate/convert-public-channels.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <manage/team-channel-members: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 <https://api.mattermost.com/#tag/channels/operation/UpdateChannelPrivacy>`_ or :ref:`mmctl channel modify command <manage/mmctl-command-line-tool:mmctl channel modify>` 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 <onboard/advanced-permissions:permissions structure>`.
- If :ref:`Sync Group channel management <manage/team-channel-members: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 <manage/mmctl-command-line-tool:mmctl channel modify>`.
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**.
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down

0 comments on commit 886df77

Please sign in to comment.