zulip/templates/zerver/help/create-a-stream.md

# Create a stream

By default, all users other than guests can create streams. Administrators can
[restrict the ability to create a stream](/help/stream-permissions) 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.

* **Who can access the stream?**: See [Stream permissions](/help/stream-permissions).

* **Announce stream**: Posts a message to `#general` advertising the new
  stream. Organization administrators can change the stream used for stream
  creation announcements.

* **Who can post to the stream?**: See [Stream permissions](/help/stream-permissions).

* **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)
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00			`# Create a stream`
user docs: Use subscriptions macro in Create a stream doc. 2017-01-02 05:13:35 +01:00
help center: Remove list of roles from create-a-stream.md. Also adds links to related articles. 2022-03-14 18:42:54 +01:00			`By default, all users other than guests can create streams. Administrators can`
			`[restrict the ability to create a stream](/help/stream-permissions) to specific`
			`[roles](/help/roles-and-permissions).`
help: Wrap a bunch of very long lines. Now there are no lines longer than 140 characters here. 2017-01-05 23:35:54 +01:00
user docs: Rewrite "Setting up your organization" guide. This change depends on #19783, which hasn't been merged yet, to avoid some broken rendering. 2021-09-17 16:50:49 +02:00			`If you are an administrator setting up streams for the first time, check out our`
help center: Remove list of roles from create-a-stream.md. Also adds links to related articles. 2022-03-14 18:42:54 +01:00			`[guide to setting up streams for a new organization](/help/create-streams).`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`## Create a stream`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
help: Update Streams & topics articles to conform to style guide. 2019-03-30 19:00:24 +01:00			`{start_tabs}`

user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`{relative\|stream\|all}`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`1. Click Create stream on the right.`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`1. Fill out the requested info, and click Create.`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`!!! warn ""`
help: Add newline after admonition header for Prettier compatibility. Signed-off-by: Anders Kaseorg <anders@zulip.com> 2021-09-10 00:44:29 +02:00
help: Update Streams & topics articles to conform to style guide. 2019-03-30 19:00:24 +01:00			`Note: You will only see the Create stream button if you have`
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`permission to create streams.`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
help: Update Streams & topics articles to conform to style guide. 2019-03-30 19:00:24 +01:00			`{end_tabs}`

user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`## Stream options`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`There are several parameters you can set while creating a stream. All but`
			`Announce stream you can change later.`
docs: Add macros to the Create a stream doc. 2017-01-05 19:58:42 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`* 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.`
docs: Add macros to the Create a stream doc. 2017-01-05 19:58:42 +01:00
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`* Stream description: Helps users decide whether to subscribe when they`
			`are browsing streams.`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
create streams: Remove "Stream permissions" header. The header was more confusing than helpful, and we want the create-stream UI to be less cluttered. We don't really need the help-center text here, since we already have ? icons next to the relevant headings for the sub-sections. We kill off some CSS, but we won't kill off stream-title until the big upcoming changes for stream pills. 2022-03-03 23:11:03 +01:00			`* Who can access the stream?: See [Stream permissions](/help/stream-permissions).`

help: Update Streams & topics articles to conform to style guide. 2019-03-30 19:00:24 +01:00			* Announce stream: Posts a message to `#general` advertising the new
user docs: Update create-a-stream. 2018-09-16 07:28:43 +02:00			`stream. Organization administrators can change the stream used for stream`
help: Update Streams & topics articles to conform to style guide. 2019-03-30 19:00:24 +01:00			`creation announcements.`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
create streams: Remove "Stream permissions" header. The header was more confusing than helpful, and we want the create-stream UI to be less cluttered. We don't really need the help-center text here, since we already have ? icons next to the relevant headings for the sub-sections. We kill off some CSS, but we won't kill off stream-title until the big upcoming changes for stream pills. 2022-03-03 23:11:03 +01:00			`* Who can post to the stream?: See [Stream permissions](/help/stream-permissions).`
docs: Add user guide for Create a stream 2016-12-05 03:29:48 +01:00
help_docs: Update create stream doc for choosing subscribers. As the different settings are described in the help center doc for creating a new stream, we need to update the final setting name from 'People to add' to the new 'Choose subscribers' that is in the UI. Also, updates that setting description to include adding users via user groups or the new add all users option. 2022-03-09 19:20:02 +01:00			`* 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.`
help center: Remove list of roles from create-a-stream.md. Also adds links to related articles. 2022-03-14 18:42:54 +01:00
			`## 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)`