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

# Starboard

> Repost your server's best messages to a dedicated channel.

## How it works

Members react to a message with your chosen emoji. Once enough of them do, confine reposts it to your starboard channel — a running highlight reel your server curates itself.

<Frame>
  <img src="https://mintcdn.com/confine/2973i9UGCY1FmSy5/images/Screenshot-2026-08-17-123004.png?fit=max&auto=format&n=2973i9UGCY1FmSy5&q=85&s=f71ff9afc58e428154d3765681f71903" alt="Screenshot 2026 08 17 123004" width="359" height="454" data-path="images/Screenshot-2026-08-17-123004.png" />
</Frame>

<Info>
  Every command here requires **Manage Server**.
</Info>

## Setup

<Steps>
  <Step title="Pick a channel">
    <CodeGroup>
      ```javascript Syntax theme={null}
      ,starboard set (channel)
      ```

      ```javascript Example theme={null}
      ,starboard set #starboard
      ```
    </CodeGroup>

    Confine needs **View Channel**, **Send Messages**, and **Embed Links** there.
  </Step>

  <Step title="Turn it on">
    ```javascript theme={null}
    ,starboard unlock
    ```

    Nothing gets reposted until you run this.

    <Info>
      You can't enable starboard before setting a channel — confine will tell you to do that first.
    </Info>
  </Step>
</Steps>

Pause it any time with `,starboard lock`. Your settings stay intact.

## Tuning it

### Reaction threshold

How many reactions a message needs before it gets reposted.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,starboard threshold (number)
  ```

  ```javascript Example theme={null}
  ,starboard threshold 5
  ```
</CodeGroup>

<Info>
  Minimum is **3** — low enough that a couple of friends can't spam the board.
</Info>

### The emoji

<CodeGroup>
  ```javascript Syntax theme={null}
  ,starboard emoji (emoji)
  ```

  ```javascript Example theme={null}
  ,starboard emoji 🤩
  ```
</CodeGroup>

Defaults to ⭐. Custom server emojis work as long as confine has access to them.

### Self-starring

Whether members can star their own messages.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,starboard selfstar (yes or no)
  ```

  ```javascript Example theme={null}
  ,starboard selfstar no
  ```
</CodeGroup>

## Customizing the post

<AccordionGroup>
  <Accordion title="Embed color">
    <CodeGroup>
      ```javascript Syntax theme={null}
      ,starboard color (color)
      ```

      ```javascript Example theme={null}
      ,starboard color #5865F2
      ,starboard color pink
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Jump link">
    Toggles whether the post includes a link back to the original message.

    ```javascript theme={null}
    ,starboard jumpurl no
    ```
  </Accordion>

  <Accordion title="Timestamp">
    Toggles the timestamp on the embed.

    ```javascript theme={null}
    ,starboard timestamp no
    ```
  </Accordion>

  <Accordion title="Attachments">
    Toggles whether images and files from the original message carry over.

    ```javascript theme={null}
    ,starboard attachments no
    ```
  </Accordion>
</AccordionGroup>

## Ignoring channels, roles, and members

Anything ignored never reaches the starboard, no matter how many reactions it gets.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,starboard ignore add (channel, role, or member)
  ```

  ```javascript Example theme={null}
  ,starboard ignore add #spam
  ,starboard ignore add @Muted
  ,starboard ignore add @financely
  ```
</CodeGroup>

| Command                             | What it does                                |
| ----------------------------------- | ------------------------------------------- |
| `,starboard ignore remove (target)` | Take something off the list                 |
| `,starboard ignore list`            | See everything ignored                      |
| `,starboard ignore reset`           | Clear the list behind a confirmation prompt |

## Checking your setup

`,starboard config` shows everything at once — channel, emoji, threshold, color, and all your toggles.

## Starting over

`,starboard reset` wipes your configuration back to defaults.
