> For the complete documentation index, see [llms.txt](https://docs.asagi.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.asagi.xyz/community-interaction/starboard.md).

# Starboard

Starboard highlights popular community messages by copying them to a dedicated channel after they receive enough reactions.

Everything on this page is configured from **Dashboard → Community Interaction → Starboard**.

### Set Up Starboard

1. Open **Starboard**.
2. Turn **Active** on.
3. Choose the **Channel** where Starboard posts should appear.
4. Choose the Starboard emoji or keep the default ⭐.
5. Set the **Star Limit** — the number of valid reactions required before a message appears on Starboard.
6. Configure any optional behavior you want to use.
7. Save your changes.

The reaction limit can be set from **1 to 25**. The default is **3**.

> 🎬 **Set up Starboard**
>
> See how to choose the Starboard channel, reaction emoji, and reaction limit.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FaYqABzzGA21bzSwq5Cwc%2Fstarboard%20set%20up.mp4?alt=media&token=285c7865-c8b5-42f5-b93a-ce3089fa25ce>" %}

> 🖼️ **Starboard message**
>
> A Starboard post keeps the original author and message content while showing the current reaction count.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FKefcm7kdVnw6leFTNdP7%2Fmarriage_message_padded_lossless.webp?alt=media&amp;token=90128146-812a-4e65-a005-7d897181122f" alt=""><figcaption></figcaption></figure>

### How Starboard Works

Asagi watches the configured Starboard emoji on regular text-channel messages. When the number of valid reactions reaches the configured limit, the message is copied to the Starboard channel.

The Starboard entry updates as the reaction count changes. If the count falls below the required limit, the Starboard entry is removed.

Reactions from bots are not counted. The original message's author is only counted when **Self-Reaction** is enabled.

Messages already containing embeds are not processed by Starboard, and messages in the Starboard channel itself are ignored.

### Starboard Options

The main behavior switches are:

| Option                 | What it does                                                                           |
| ---------------------- | -------------------------------------------------------------------------------------- |
| **Show Jump Link**     | Adds a link back to the original Discord message                                       |
| **Self-Reaction**      | Counts the original author's Starboard reaction                                        |
| **Automatic Reaction** | Automatically adds the configured Starboard emoji to eligible messages                 |
| **Attachment Request** | Only allows messages with an attachment to qualify for Starboard                       |
| **1 image — 1 embed**  | Displays additional images as separate embeds instead of grouping attachments as links |

**Automatic Reaction** requires Premium.

### Custom Emoji

Use **Set Custom Emoji** to replace the default star with another standard or custom emoji.

The selected emoji becomes the reaction Asagi watches for and the symbol shown with Starboard reaction counts.

### Ignore Channels

Enable **Ignore Channels** when some channels should never contribute messages to Starboard.

Select the channels you want to exclude and save the changes. Reactions in those channels are ignored by the Starboard system.

### Assign Roles

**Assign Roles** is a Premium feature that rewards the author of a message after it reaches a separate reaction threshold.

1. Enable **Assign Roles**.
2. Select one or more roles.
3. Set the **Reaction Limit for Role Assignments** from **1 to 25**.
4. Save your changes.

When the message reaches that threshold, Asagi adds the selected roles to the original message author. These roles are not automatically removed if the reaction count later drops.

Asagi needs **Manage Roles**, and its highest Discord role must be above every role it needs to assign.

> 🖼️ **Assign Roles setup**
>
> Choose which roles message authors receive and how many reactions are required.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FeXvxClxJPUXHltTnE8Lt%2Fassign_roles_transparent_clean.webp?alt=media&amp;token=33c06597-47e3-47e4-a313-5af9770a1faf" alt=""><figcaption></figcaption></figure>

### Create Threads

**Create Threads** is a Premium feature that creates a public discussion thread when a new message is added to Starboard.

You can configure:

* the thread name, up to **50 characters**;
* an optional first thread message;
* a custom message or one of your saved Embed Messages templates;
* whether that first thread message should be pinned.

If the Starboard entry is later removed because its reaction count falls below the Starboard limit, its Starboard thread is removed as well.

> 🎬 **Create a Starboard thread**
>
> See how a Starboard post can open a discussion thread with a custom first message.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FS6DnhL2nAYfVD8uFjbTO%2FCreate%20a%20Starboard%20thread.mp4?alt=media&token=006cd8d0-0c11-4b44-8c90-e6d0e7d4c509>" %}

### Attachments

Starboard can preserve attachments from the original message. The first attachment is shown on the main Starboard embed when possible.

With **1 image — 1 embed** enabled, additional images are displayed in separate embeds. Without it, attachment links are included with the copied message instead.

If **Attachment Request** is enabled, messages without attachments do not qualify for Starboard even if they receive enough reactions.

### Permissions and Troubleshooting

If messages do not appear on Starboard, check that:

* **Active** is enabled;
* the selected Starboard channel still exists;
* Asagi can view and send messages in that channel;
* the message is not in an ignored channel;
* the correct emoji is being used;
* the reaction count reaches the configured limit;
* **Attachment Request** is not excluding a message without attachments.

For **Automatic Reaction**, Asagi must also be able to add reactions in the source channel.

For **Assign Roles**, check **Manage Roles** and Discord role hierarchy.

For **Create Threads**, Asagi needs the permissions required to create and manage public threads, send the optional thread message, and pin it when pinning is enabled.

If a configured Starboard channel or role becomes unavailable, the dashboard can surface a notification for the affected feature.

### Where to Go Next

You have now covered **Community Interaction**. Continue with the next documentation category to configure more Asagi features.