> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrumpbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Set Up a Discord Starboard with Scrump

> Set up a Discord Starboard channel that highlights popular messages, images, videos, stickers, author avatars, and jump links after enough reactions.

Scrump Starboard copies popular server messages into one highlight channel after they receive enough matching reactions. Each Starboard post keeps the original message text, author, supported media, current reaction count, and a **Jump to message** button.

## What Scrump posts to Starboard

Every Starboard entry uses Discord's Components V2 layout and can include:

* A title containing the configured emoji, current reaction count, and the author's `@username`.
* The original message content.
* The author's display avatar as a thumbnail.
* Supported image and video attachments, stickers, and media from message embeds.
* A **Jump to message** button that opens the original conversation.

When someone adds or removes the configured reaction, Scrump updates the existing Starboard post instead of creating a duplicate. The entry remains visible if its count later falls below the creation threshold. Deleting the original message deletes its Starboard entry too.

## Before you set up Starboard

You need the **Manage Server** permission to configure Starboard.

Scrump should have:

* **View Channel** and **Read Message History** in channels whose messages may reach Starboard.
* **View Channel** and **Send Messages** in the destination Starboard channel.

Create a public or staff-visible text channel such as `#starboard`, `#best-of`, or `#community-highlights` before starting.

## Set up Starboard with a slash command

Run:

```text theme={null}
/starboard setup
```

Choose the destination channel and the number of reactions needed. Free servers can select 3, 4, or 5 reactions and use the standard ⭐ emoji and Scrump colour.

Plus and Pro servers can also:

* Set any threshold from 1 to 50.
* Paste a Unicode emoji such as `🔥` or `💛`.
* Paste a custom emoji from the same Discord server.
* Choose the Components V2 side colour with a hexadecimal colour such as `#F5B942`.

<Note>
  Custom emoji must belong to the server where Starboard is being configured. Emoji from another server are rejected.
</Note>

## Set up Starboard from the dashboard

1. Open the [Scrump server dashboard](https://scrumpbot.com/servers).
2. Select the server you manage.
3. Open **Engagement**, then **Starboard**.
4. Enable Starboard and choose its destination text channel.
5. Select the reaction threshold.
6. On Plus or Pro, choose the emoji and side colour.
7. Save the changes.

Dashboard changes are checked again by the bot before they become active. This prevents hidden channels, invalid custom emoji, missing bot permissions, or plan-restricted settings from being applied.

## View the current settings

Run:

```text theme={null}
/starboard settings
```

Scrump shows the active channel, threshold, emoji, and side colour. Settings are evaluated against the server's current plan, so a Free server always uses the Free appearance and threshold range.

## Change an existing Starboard

Run `/starboard setup` again with the new values, or edit Starboard in the server dashboard. Scrump updates the server's saved configuration.

Messages already posted to Starboard update their count and appearance the next time the configured reaction changes. New qualifying messages use the current destination and settings.

## Disable Starboard

Run:

```text theme={null}
/starboard disable
```

You can also turn off **Enable Starboard** in the dashboard. Disabling stops new messages from being added. It does not delete the original messages in your server.

## Choose a good Starboard threshold

Use a threshold that represents real community agreement without making highlights too rare:

| Server activity                  | Suggested starting threshold |
| -------------------------------- | ---------------------------: |
| Small or quiet server            |                            3 |
| Medium community                 |                          4-6 |
| Busy community                   |                         7-12 |
| Very large or event-heavy server |                   15 or more |

Free servers can use 3, 4, or 5. Plus and Pro support the full 1-50 range. Review the channel after a week and adjust based on how many messages are being highlighted.

## Troubleshooting

### A message has enough stars but was not posted

Check that:

* The reaction matches the configured emoji exactly.
* Scrump can view the source channel and read its message history.
* Scrump can view and send messages in the Starboard channel.
* Starboard is still enabled for the server.
* The message was not sent by Scrump itself.

After correcting permissions, add or remove one matching reaction to make Scrump check the message again.

### A custom emoji is rejected

Use a custom emoji from the same server. You can also use a standard Unicode emoji. Custom emoji and custom colours require Plus or Pro.

### Images or videos are missing

Scrump includes supported media attachments, non-Lottie stickers, and supported embed media. Unsupported file types remain available through the original message's jump link.

### The reaction count went below the threshold

The threshold controls when an entry is first created. After that, Scrump keeps the entry and updates its displayed count when reactions are added or removed. Delete the original source message if the highlight should also be removed.

## Frequently asked questions

### Does Starboard work on Free?

Yes. Free servers can use the standard ⭐ reaction, the standard Scrump side colour, and a threshold of 3, 4, or 5.

### Can Starboard use a server emoji?

Yes on Plus and Pro. Paste the custom emoji into the emoji field or `/starboard setup` option. It must belong to the current server.

### Will the same message be posted more than once?

No. Scrump stores one Starboard entry per original message and updates that entry as the reaction count changes.

### What happens when the original message is deleted?

Scrump deletes the corresponding Starboard post and removes its saved entry.

## Related guides

<CardGroup cols={2}>
  <Card title="How to make a Discord Starboard" icon="star" href="/guidelines/how-to-make-a-discord-starboard">
    Learn how Starboards work, how to choose a threshold, and how to encourage useful community highlights.
  </Card>

  <Card title="Discord bot feature setup guides" icon="book-open" href="/guidelines/discord-bot-feature-guides">
    Compare Starboard with sticky messages, giveaways, quotes, levelling, and other community tools.
  </Card>
</CardGroup>
