# Starboard

Thanks for coming to Starboards docs! The point of this is to answer any questions you might have about what a starboard is, and how to use this bot. If you ever have any questions, feel free to join [the support server.](https://discord.gg/3gK8mSA)

Click [here](https://discord.com/api/oauth2/authorize?client_id=700796664276844612\&permissions=275683339328\&scope=bot%20applications.commands) to invite starboard.

The source code for Starboard is available [here](https://github.com/circuitsacul/starboard-4). You're welcome to self-host it if you like.

## Quick Start

To get a working starboard, see [basic-starboard](https://docs.starboard.best/tutorials/basic-starboard "mention"). See [starboards](https://docs.starboard.best/docs/starboards "mention") for more detailed info on how to use starboards.

## What is a Starboard?

A starboard is a discord bot that essentially allows users to "vote" to "pin" messages, but instead of pinning them to the channel using Discord's pins, they are sent to your starboard. Usually, it works like this:

* You create a channel called #starboard.
* If someone sends a funny message, people can react to that message with ⭐.
* Once the message receives a certain number of :star: reactions, the message is sent to the #starboard.

## Why this Starboard?

It would be easy to create a simple Starboard bot that can just do the basics, where you set a channel and a number, and you're done. But with this bot, you can do so much more - from having multiple starboards all the way to setting specific permissions for each role.

This bot is sometimes confusing to new users, but once you figure out how to use it, you can customize the bot to fit your servers needs perfectly.

## Key Features

* Multiple starboards per server
* Multiple upvote and downvote emojis per starboard
* 25+ configurable options per starboard
* Per-channel settings overrides
* Per-role permissions
* Autostar channels


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.starboard.best/about/starboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.