Skip to content

Commit

Permalink
Clarified private channel conversion requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
cwarnermm committed Feb 7, 2025
1 parent e9538d5 commit cb2fc9a
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 7 deletions.
13 changes: 9 additions & 4 deletions source/collaborate/convert-public-channels.rst
Original file line number Diff line number Diff line change
Expand Up @@ -53,13 +53,18 @@ 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.

.. note::

Team admins may be granted permissions to convert private channels to public channels via the `API <https://api.mattermost.com/#tag/channels/operation/UpdateChannelPrivacy>`_ or :ref:`mmctl channel modify command <manage/mmctl-command-line-tool:mmctl channel modify>` when configured in the :ref:`permission scheme <onboard/advanced-permissions:permissions structure>`.

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.
3. Under **Channel Management > Public channel or private channel**, select **Private**.
4. Select **Save**.

.. tip::
.. note::

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>`.
- If :ref:`Sync Group channel management <manage/team-channel-members:channel management>` is enabled, private channels can't be converted to public channels.
- System admins can also convert private channels to public channels using the `API <https://api.mattermost.com/#tag/channels/operation/UpdateChannelPrivacy>`_ or the :ref:`mmctl channel modify command <manage/mmctl-command-line-tool:mmctl channel modify>`.
Original file line number Diff line number Diff line change
Expand Up @@ -498,7 +498,6 @@ The following built-in roles and associated 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 and associated 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 and associated 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 cb2fc9a

Please sign in to comment.