# Pinning a stream

Pinning a stream will put that stream at the top of your streams sidebar.
If you are subscribed to a lot of streams,
pinning your favorite streams can be a good way to keep things organized.

## How to pin a stream

There are two easy ways to pin a stream:

### Pinning a stream using the sidebar

The quickest way to pin a stream is by using the
**Pin stream ... to top** feature on the sidebar.

1) On the sidebar, hover over the stream you want to pin and press the
arrow to the right of the stream name.

![Arrow](/static/images/help/streams-arrow.png)

2) A menu will pop up. Press **Pin stream ... to top**.

![Sidebar menu](/static/images/help/streams-pin-sidebar.png)

### Pinning a stream using the stream settings

The other way to pin a stream is by ticking the **Pin stream to top of
left sidebar** box in the stream settings.

1) Open your subscription settings by pressing the gear at the top of
the left sidebar.

![Browse streams](/static/images/help/streams-1.png)

2) Now select the stream you want to pin and tick the box **Pin stream
to top of left sidebar**.

![Stream settings](/static/images/help/streams-pin-settings.png)

### Result

The stream you just pinned will now be at the top of your streams list:

![Result](/static/images/help/streams-pin-result.png)

## How to unpin a stream

Unpinning a stream works the same way as pinning a stream. You can:
- Press the arrow to the right of the stream you want to unpin and
select **Unpin stream ... from top**, or
- Open your subscription settings, select the stream you want to unpin
and untick the box **Pin stream to top of left sidebar**

# Pinning a stream

If you are subscribed to a lot of streams, pinning important streams to the top
of the **Streams** section on your left sidebar can be a good way to organize
streams.

## Pinning a stream using the left sidebar

If you want to quickly pin a single stream, you can do so through the stream sidebar.

{!stream-actions.md!}

2. Click on the {!down-chevron.md!} Select the **Pin stream (stream name) to top**
option from the actions dropdown.

3. Upon selecting the **Pin stream (stream name) to top** option, the selected
stream will be pinned the top of the **Streams** section, confirming the success
of your pinning.

### Pinning a stream using the [Subscriptions](/#subscriptions) page

If you want to pin multiple streams at once, you should pin streams through the [Subscriptions](/#subscriptions) page.

{!subscriptions.md!}
{!filter-streams.md!}

2. Select the stream you want to pin in the [Subscriptions](/#subscriptions) page; {!stream-settings.md!}

3. Select the **Pin stream to top of left sidebar** option in **Stream Settings**.

4. Once you close the [Subscriptions](/#subscriptions) page, the selected stream
will be pinned the top of the **Streams** section, confirming the success of
your pinning.

Add macros to the *Pin a stream* doc.
docs: Add macros to the *Pin a stream* doc.

