> For the complete documentation index, see [llms.txt](https://discortics.com/llms.txt). A consolidated single-file corpus is available at [llms-full.txt](https://discortics.com/llms-full.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://discortics.com/guides/starboard.md).

# Starboard

When a message gets enough ⭐ reactions, Discortics copies it to your starboard channel with its author and a link to the original.

## Before you begin

- You need **Manage Server**.
- Create a `#starboard` channel.
- Discortics needs **View Channel**, **Send Messages**, **Embed Links**, and **Read Message History** there.

## Set up Starboard

### Dashboard Setup

1. Open **Dashboard → Settings → Starboard**.
2. Select `#starboard`.
3. Set the threshold. Start with `3` for a small server.
4. Add private or noisy channels to **Ignored Channels**.
5. Enable Starboard and save.
6. Add ⭐ reactions to a test message.

### Discord Command Setup

1. Run `/settings starboard`.
2. Select **Channel** and choose `#starboard`. This also enables Starboard.
3. Select **Threshold** and enter `3`.
4. Add private or noisy channels to **Ignored Channels**.
5. Check that the status shows Starboard as enabled.
6. Add ⭐ reactions to a test message.

## Settings

| Setting              | What it does                                         | Limit       |
| -------------------- | ---------------------------------------------------- | ----------- |
| **Status**           | Turns Starboard on or off and keeps your settings    |             |
| **Channel**          | Where highlights are posted. Applies to future posts | One channel |
| **Threshold**        | Stars needed. The default is 3                       | 2 to 999    |
| **Ignored Channels** | Messages here are never highlighted                  | 25 channels |

Limits are the same on every plan. To exclude a category, add each of its channels. To remove one ignored channel, use the Dashboard, since Discord can only clear the whole list.

## What gets posted

Text, images, other attachments, and the first embed on a message.

## Limitations

- Only the standard ⭐ emoji counts. Custom emoji and bot reactions don't.
- A message is posted once, when it first reaches the threshold.
- Later stars, or removing stars, don't update or remove the post.
- Very old messages may not be highlighted.

## Reset

Select **Reset** in `/settings starboard` and confirm. This turns it off, sets the threshold to 3, and clears the channel and ignored list.

> [!WARNING]
> Reset can't be undone. Posts already in the channel stay.

## Commands

| Command               | What it does             | Permission    |
| --------------------- | ------------------------ | ------------- |
| `/settings starboard` | Open the Starboard panel | Manage Server |

## Troubleshooting

**A message didn't appear.** Check that Starboard is on, a channel is selected, the source channel isn't ignored, members used the standard ⭐, and Discortics can post in the channel.

Prefer one-line commands? See [Direct Commands](/guides/command-arguments).