zulip/help/move-content-to-another-cha...

3.7 KiB

Move content to another channel

Zulip makes it possible to move messages, or an entire topic, to another channel. Organizations can configure which roles have permission to move messages between channels.

To help others find moved content, you can have the notification bot send automated notices to the source topic, the destination topic, or both. These notices include:

  • A link to the source or destination topic.
  • How many messages were moved, or whether the whole topic was moved.
  • Who moved the content.

Move a topic to another channel

To move a topic, you must have access to both the source and destination channels.

{start_tabs}

{!topic-actions.md!}

  1. Select Move topic. If you do not see this option, you do not have permission to move this topic.

  2. Select the destination channel for the topic from the channels dropdown list.

  3. (optional) Change the topic name.

  4. Toggle whether automated notices should be sent.

  5. Click Confirm to move the topic to another channel.

!!! warn ""

**Note**: When a topic is moved to a private channel with protected history,
          messages in the topic will be visible to all the subscribers.

{end_tabs}

Move messages to another channel

{start_tabs}

{!message-actions-menu.md!}

  1. Select Move messages. If you do not see this option, you do not have permission to move this message.

  2. Select the destination channel from the channels dropdown list. If the channel input is disabled, you do not have permission to move this message to a different channel.

  3. (optional) Change the topic name.

  4. From the dropdown menu, select which messages to move.

  5. Toggle whether automated notices should be sent.

  6. Click Confirm to move the selected content to another channel.

!!! warn ""

**Note**: You cannot edit content of a message while changing its channel.

{end_tabs}

Moving content to private channels

Access to messages moved to another channel will immediately be controlled by the access policies for the destination channel. Content moved to a private channel will thus appear to be deleted to users who are not subscribers of the destination channel.

Content moved to a private channel with protected history will only be accessible to users who both:

  • Were subscribed to the original channel when the content was sent.
  • Are subscribed to the destination channel when the content is moved.

Moving content out of private channels

In private channels with protected history, Zulip determines whether to treat the entire topic as moved using the access permissions of the user requesting the topic move. This means that the automated notices sent by the notification bot will report that the entire topic was moved if the requesting user moved every message in the topic that they can access, regardless of whether older messages exist that they cannot access.

Similarly, muted topics will be migrated to the new channel and topic if the requesting user moved every message in the topic that they can access.

This model ensures that the topic editing feature cannot be abused to determine any information about the existence of messages or topics that one does not have permission to access.