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

# Starboard

Allow members to repost interesting messages to a starboard channel.

## What is Starboard?

The starboard is a channel where members can react to messages and after a certain number of reactions, the message will be reposted to the starboard channel.

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-29-at-11.52.30-PM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=4ecc44330125bb9ba07f365de75bcfdb" alt="Screenshot 2026 04 29 At 11 52 30 PM" width="522" height="458" data-path="images/Screenshot-2026-04-29-at-11.52.30-PM.png" />
</Frame>

<Info>
  You can create two starboards, both `starboard` and `clownboard` use the same structure.
</Info>

### Getting started

Before you run any commands, it’s important to use the `starboard unlock` command. Otherwise, messages will not be reposted to the starboard channel. You can use `starboard lock` to temporarily stop messages from being reposted.

## Setting the starboard channel

You can use the `starboard set` command to set which channel messages will be reposted to.

<CodeGroup>
  ```typescript Syntax theme={null}
  .starboard set (channel)
  ```

  ```typescript Example theme={null}
  .starboard set #starboard
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-29-at-11.59.14-PM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=f92f55efa1addbfc00525fe0066e0bb7" alt="Screenshot 2026 04 29 At 11 59 14 PM" width="1076" height="358" data-path="images/Screenshot-2026-04-29-at-11.59.14-PM.png" />
</Frame>

## Ignoring channels, roles, or members

You can ignore certain channels, roles, or members within your server to prevent their messages from appearing on the starboard.

<Info>
  If you no longer want to ignore the channel, role, or member, you can re-run the command. Alternatively, you can run `starboard ignore list` to view all ignored channels, roles, and members.
</Info>

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

  ```typescript Example theme={null}
  .starboard ignore #giveaways
  .starboard ignore @h.azard
  .starboard ignore @Member
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.01.54-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=579cb5b38208f2e2c56754c15b7687d5" alt="Screenshot 2026 04 30 At 12 01 54 AM" width="1088" height="1072" data-path="images/Screenshot-2026-04-30-at-12.01.54-AM.png" />
</Frame>

### Customizing the starboard

## Changing the reaction threshold

You can change the minimum number of reactions a message needs to be reposted.

<CodeGroup>
  ```typescript Syntax theme={null}
  .starboard threshold (amount)
  ```

  ```typescript Example theme={null}
  .starboard threshold 3
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.03.14-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=5c71865a9aabdd7f1020cbe7584e9f58" alt="Screenshot 2026 04 30 At 12 03 14 AM" width="950" height="372" data-path="images/Screenshot-2026-04-30-at-12.03.14-AM.png" />
</Frame>

## Changing the emoji to watch for

You can set the emoji that members need to react with for a message to be reposted.

<Info>
  By default, this emoji is set as `⭐` for the starboard and `🤡` for the clownboard.
</Info>

<CodeGroup>
  ```typescript Syntax theme={null}
  .starboard emoji (emoji)
  ```

  ```typescript Example theme={null}
  .starboard emoji 🤩
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.04.23-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=cf35650b5d7d078e75aefda7b58cef26" alt="Screenshot 2026 04 30 At 12 04 23 AM" width="882" height="344" data-path="images/Screenshot-2026-04-30-at-12.04.23-AM.png" />
</Frame>

## Allowing self-starring messages

You can allow members to star their own messages with the `starboard selfstar` command.

<CodeGroup>
  ```typescript Syntax theme={null}
  .starboard selfstar (true or false)
  ```

  ```typescript Example theme={null}
  .starboard selfstar true
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.05.19-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=cc0abc45d7594c0d9d69a1a85bfc1706" alt="Screenshot 2026 04 30 At 12 05 19 AM" width="860" height="358" data-path="images/Screenshot-2026-04-30-at-12.05.19-AM.png" />
</Frame>

## Customizing the message displayed

You can customize the message that is sent to the starboard channel.

<AccordionGroup>
  <Accordion title="Changing the embed color">
    Use the `starboard color` command to change the color of the embed.

    <CodeGroup>
      ```typescript Syntax theme={null}
      .starboard color (color)
      ```

      ```typescript Example theme={null}
      .starboard color #cf7c08
      .starboard color pink
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Toggling the embed timestamp">
    Use the `starboard timestamp` command to toggle the timestamp in the embed.

    <CodeGroup>
      ```typescript Syntax theme={null}
      .starboard timestamp (true or false)
      ```

      ```typescript Example theme={null}
      .starboard timestamp false
      ```
    </CodeGroup>

    <Frame>
      <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.11.24-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=e2b68046ab6990c0656bfa8db5786754" alt="Screenshot 2026 04 30 At 12 11 24 AM" width="512" height="446" data-path="images/Screenshot-2026-04-30-at-12.11.24-AM.png" />
    </Frame>
  </Accordion>

  <Accordion title="Toggling the message jump URL">
    Use the `starboard jumpurl` command to toggle if the message jump URL is included.

    <CodeGroup>
      ```typescript Syntax theme={null}
      .starboard jumpurl (true or false)
      ```

      ```typescript Example theme={null}
      .starboard jumpurl false
      ```
    </CodeGroup>

    <Frame>
      <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.14.03-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=748753dada092ca7e943b02b60558db6" alt="Screenshot 2026 04 30 At 12 14 03 AM" width="512" height="454" data-path="images/Screenshot-2026-04-30-at-12.14.03-AM.png" />
    </Frame>
  </Accordion>

  <Accordion title="Toggling the message attachments">
    Use the `starboard attachments` command to toggle if attachments are included.

    <CodeGroup>
      ```typescript Syntax theme={null}
      .starboard attachments (true or false)
      ```

      ```typescript Example theme={null}
      .starboard attachments false
      ```
    </CodeGroup>

    <Frame>
      <img src="https://mintcdn.com/drown/F_wyqLiVIQWwLMUn/images/Screenshot-2026-04-30-at-12.17.57-AM.png?fit=max&auto=format&n=F_wyqLiVIQWwLMUn&q=85&s=761bdb50e4f5b16db7e43517cf34b711" alt="Screenshot 2026 04 30 At 12 17 57 AM" width="1034" height="838" data-path="images/Screenshot-2026-04-30-at-12.17.57-AM.png" />
    </Frame>
  </Accordion>
</AccordionGroup>
