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

# Starboard

> Repost the messages your community reacts to most, with thresholds, multiple boards, moderation controls and star role rewards.

A message collects enough ⭐ reactions and Vetox reposts it to a highlights channel.

<Note>
  Starboard must be enabled in [Server Setup](/en/server-management/setup). With the module off, this page shows only a banner — the starboard list is hidden entirely.
</Note>

## Limits

|                     | Starter | Basic | Max       | Black     |
| ------------------- | ------- | ----- | --------- | --------- |
| Starboards          | 1       | 5     | Unlimited | Unlimited |
| Emoji per starboard | 1       | 5     | Unlimited | Unlimited |
| Custom embed        | —       | Yes   | Yes       | Yes       |

## Creating one

<Warning>
  **Create Starboard creates it immediately** — there is no dialog to fill in first. A default starboard appears and you are taken straight to its settings.
</Warning>

Defaults: named "Starboard", ⭐, a threshold of 3, an embed layout, a jump button, and removal when the count falls back below the threshold.

## General

* **Name** and **channel** — the destination. Messages posted *in* the starboard channel are never themselves starboarded
* **Reactions needed** — 1 to 100
* **Emoji** — which reactions count
* **Display emoji** — what is shown on the reposted message
* **Ping role** — pinged on each new entry
* **Allowed channels**, **ignored channels**, **ignored roles**, and **roles allowed to give stars**

## Behaviour

| Setting                         | Notes                                              |
| ------------------------------- | -------------------------------------------------- |
| Count the author's own reaction | Off stops self-starring                            |
| Allow bot messages              |                                                    |
| Allow NSFW channels             |                                                    |
| Remove when below threshold     | Un-stars a message if reactions are removed        |
| Show jump button                | A link back to the original                        |
| Ping the author                 |                                                    |
| Require an image                | Image-only highlights                              |
| Minimum message age             | Up to 7 days                                       |
| Maximum message age             | Up to a year                                       |
| Count refresh interval          | 1–60 seconds                                       |
| Exclusive group                 | Stops several starboards claiming the same message |
| Remove invalid reactions        |                                                    |
| Auto-react                      | **Needs at least one allowed channel**             |

<Tip>
  **Turn off "count the author's own reaction."** Otherwise the threshold is effectively one lower for anyone willing to star their own post.
</Tip>

<Note>
  Two starboards sharing an **exclusive group** will never both claim the same message — the first to reach its threshold wins.
</Note>

## Appearance

An embed or a plain message. The template supports `{author}`, `{stars}`, `{channel}`, `{link}`, `{content}` and `{emoji}`.

<Warning>
  **On Starter, custom embed edits are accepted, saved, and then silently replaced with the default template.** The change appears to vanish. Custom embeds require Basic.
</Warning>

## Star rewards

Give a role at a star total — up to 10 mappings, from 1 to 1000 stars.

<Note>
  Star totals only ever go up. Losing reactions later never takes a reward role away.
</Note>

## Leaderboard

The most-starred messages, with per-entry controls:

* **Force** — add any message by pasting its link, even below the threshold
* **Freeze** — stop the star count updating
* **Remove** — take it off the starboard and block it from returning

<Warning>
  **Removing an entry is effectively permanent from the dashboard.** Once removed, the entry disappears from this list and there is no way to restore it here.
</Warning>

## After a downgrade

Starboards over your tier's limit are **disabled, not deleted** — shown dimmed with a "Tier limit" marker and an explanation. Emoji lists are trimmed. Custom embeds revert to the default below Basic.

<Warning>
  **Deleting a starboard also deletes its entry history.** Messages already posted to the channel stay there, but the starboard's record of them is gone.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing is being starred">
    Check the module is on in Server Setup, the starboard is enabled and has a channel, the emoji matches what members are actually using, and the source channel is not ignored.
  </Accordion>

  <Accordion title="The count on the starboard post is stale">
    Counts refresh on an interval you set — up to a minute. It will catch up.
  </Accordion>

  <Accordion title="Auto-react will not turn on">
    It requires at least one allowed channel. Add one.
  </Accordion>

  <Accordion title="My custom embed keeps reverting to the default">
    Custom embeds require Basic. On Starter the default is re-applied on every save.
  </Accordion>

  <Accordion title="A message is stuck and will not return">
    It was removed via the leaderboard, which blocks it permanently. Post the content again as a new message.
  </Accordion>
</AccordionGroup>

<Card title="Counting" icon="hashtag" horizontal href="/en/engagement/counting">
  Another shared-channel activity.
</Card>