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

# Starboard

> Repost the messages that get enough reactions in a highlight channel.

## Overview

The starboard reposts the best messages of your server. When a message gets enough ⭐ reactions, Petto copies it to the starboard channel, so people can find the funniest, kindest or most useful posts in one place.

It needs **Manage Server** to configure.

## Setting it up

<CodeGroup>
  ```javascript Syntax theme={null}
  !starboard set <channel>
  !starboard enable
  !starboard disable
  !starboard threshold <count>
  !starboard emoji <emoji>
  !starboard view
  ```

  ```javascript Example theme={null}
  !starboard set #starboard
  !starboard enable
  !starboard threshold 5
  !starboard emoji 💖
  ```
</CodeGroup>

* `set` chooses the channel where the reposts go. `enable` turns the starboard on with the current settings (you can set the channel first or after), and `disable` turns it off.
* `threshold` is how many reactions a message needs (default **3**).
* `emoji` is the reaction that counts, a Unicode or a custom emoji (default ⭐).
* `view` shows the current settings: channel, threshold, emoji, self-star, the saved embed and what is ignored.

## Self-star

<CodeGroup>
  ```javascript Syntax theme={null}
  !starboard selfstar <enabled>
  ```

  ```javascript Example theme={null}
  !starboard selfstar false
  ```
</CodeGroup>

By default the author's own reaction does not count (`selfstar` is off). Turn it on to let people star their own messages.

## Ignoring channels, roles and members

<CodeGroup>
  ```javascript Syntax theme={null}
  !starboard ignore <channel|role|member> <target>
  !starboard unignore <channel|role|member> <target>
  ```

  ```javascript Example theme={null}
  !starboard ignore channel #spam
  !starboard ignore role @Muted
  !starboard unignore channel #spam
  ```
</CodeGroup>

Messages from an ignored channel, or from someone with an ignored role, or from an ignored member, never reach the starboard. `target` is a mention or an ID. `unignore` removes it from the list.

## Changing how the reposts look

<CodeGroup>
  ```javascript Syntax theme={null}
  !starboard message <template>
  !starboard message none
  ```

  ```javascript Example theme={null}
  !starboard message star-repost
  !starboard message none
  ```
</CodeGroup>

By default Petto reposts with its usual message. Give the name of a [saved embed](/resources/scripting/embeds) to make the reposts look the way you want, with the `{star.*}` [variables](/resources/scripting/variables). `none` goes back to the usual message.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.