Files
zulip/help/create-a-stream.md
Ujjawal Modi 449febf036 streams: Make stream settings and create stream UI more consistent.
This commit make changes in create stream panel by moving
announce stream option below stream description and adds a
"Stream permissions" section heading just above
"Who can access the stream?" and also rewords the text
"Announce stream".

Also now announce stream option is only shown if the user creating
stream have access to the announcement stream name. When option
is not shown, default behaviour is to announce public and
web-public streams.

Fixes #23327.
2023-04-24 17:02:33 -07:00

61 lines
2.2 KiB
Markdown

# Create a stream
By default, all users other than guests can create streams. Administrators can
[restrict the ability to create a stream](/help/configure-who-can-create-streams) to specific
[roles](/help/roles-and-permissions).
If you are an administrator setting up streams for the first time, check out our
[guide to setting up streams for a new organization](/help/create-streams).
## Create a stream
{start_tabs}
{relative|stream|all}
1. Click **Create stream** on the right.
1. Fill out the requested info, and click **Create**.
!!! warn ""
**Note**: You will only see the **Create stream** button if you have
permission to create streams.
{end_tabs}
## Stream options
There are several parameters you can set while creating a stream. All but
**Announce stream** you can change later.
* **Stream name**: Appears in the left sidebar for subscribed users. The
stream name can be in any language, and can include spaces and other
punctuation.
* **Stream description**: Helps users decide whether to subscribe when they
are browsing streams.
* **Announce new stream in the [stream configured by your organization](/help/configure-notification-bot#new-stream-announcements)**:
Posts a message in the "new streams" topic advertising the new stream.
* **Who can access the stream?**: See [Stream permissions](/help/stream-permissions).
* **Who can post to the stream?**: See [Stream permissions](/help/stream-permissions).
* **Who can unsubscribe others from this stream?**: See
[Add or remove users from a stream](/help/add-or-remove-users-from-a-stream#configure-who-can-remove-users).
* **Message retention period**: See
[Message retention policy](/help/message-retention-policy#configure-message-retention-policy-for-individual-streams).
* **Choose subscribers**: You can copy the membership from an existing stream or
[user group](/help/user-groups), add all users, or enter users one by one.
## Related articles
* [Create streams for a new organization](/help/create-streams)
* [Stream permissions](/help/stream-permissions)
* [Set default streams for new users](/help/set-default-streams-for-new-users)
* [Browse and subscribe to streams](/help/browse-and-subscribe-to-streams)