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.

Sign up for GitHub

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

Clarified private channel conversion requirements #7734

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
cb2fc9a
Clarified private channel conversion requirements
cwarnermm Feb 7, 2025
eee8ead
Merge branch 'master' into convert-channel-permissions-update
cwarnermm Feb 10, 2025
dd17e85
Incorporated reviewer updates
cwarnermm Feb 10, 2025
214395c
Merge branch 'convert-channel-permissions-update' of https://github.c…
cwarnermm Feb 10, 2025
c1123ae
Merge branch 'master' into convert-channel-permissions-update
cwarnermm Feb 11, 2025
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
13 changes: 9 additions & 4 deletions source/collaborate/convert-public-channels.rst
View file
Open in desktop
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>`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cwarnermm checking the implementation, this is not entirely the case.

Convertion from private to public can happen from team admins, sysadmins, and users with delegated granular administration roles with write access to User Management Channels and Groups. (PermissionSysconsoleWriteUserManagementChannels and PermissionSysconsoleWriteUserManagementGroups).

Teams admins are granted this permission by default but a system admin can configure to restrict this from team admins

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cc. @JulienTant to verify

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yea you are correct @esarafianou


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>`.
3 changes: 0 additions & 3 deletions source/onboard/advanced-permissions-backend-infrastructure.rst
View file
Open in desktop
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