Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarified private channel conversion requirements #7734

Merged
merged 5 commits into from
Feb 11, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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