# Discord panel

Keep a pinned panel in a Discord channel with the button to the rules website and shortcuts to the most-read pages.

Source: https://fivedash.fivex.gg/docs/en/rules/discord-panel

The rules panel is the sign on the city hall's door: a fixed message the server's bot keeps in a Discord channel, with a button to the rules website and up to four shortcuts to pages. When you publish the rules again, the panel updates on its own. This page is for whoever handles the server's Discord and rules.

## Before you start

* **Discord bot:** the panel is posted by this server's bot. Finish setting it up in the Discord module. See [Bot](https://fivedash.fivex.gg/docs/en/discord/bot).
* **Website live and published:** the panel takes people to the website, so it must be **Live** with its pages published. See [Website](https://fivedash.fivex.gg/docs/en/rules/site) and [Pages](https://fivedash.fivex.gg/docs/en/rules/pages).
* **Access level:**

| What to do                                      | Level needed                         |
| ----------------------------------------------- | ------------------------------------ |
| See the panel and its status                    | **Discord** (Rules) at **View**      |
| Channel, texts, shortcuts and posting the panel | **Discord** (Rules) at **Configure** |

## The "To publish" list

In **Rules → Discord**, the **To publish** list shows what's missing:

| Item                     | Action                       |
| ------------------------ | ---------------------------- |
| **Discord bot set up**   | **Set up**                   |
| **Rules website live**   | **Open Website**             |
| **Pages published**      | **Publish**                  |
| **Panel channel chosen** | Pick the channel in the form |

## Post the panel

### Open the page

In the panel, go to **Rules → Discord**.

### Turn on the panel

Turn on the **Turn on the Discord panel** switch (it shows **On**).

### Pick the channel

In **Panel → Channel**, pick the **Rules panel channel**.

### Adjust the texts

Edit **Title**, **Text**, **Button** and **Button emoji** if you want. The **Discord preview** shows the result alongside.

### Pick the shortcuts

In **Shortcuts**, pick up to 4 published pages. Use **Move … up** to change the order and **Remove** to take one out.

### Save

Click **Save** in the bottom bar. **Panel posted** shows up ("It's in #channel").

## Fields

### Panel

| Field            | What it does                                                               | Default                                                                                                                                                                         |
| ---------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Channel**      | The channel where the panel stays. Changing the channel moves the message. | None                                                                                                                                                                            |
| **Title**        | The panel's title. Up to 120 characters.                                   | `{{info}} City rules` (the info icon from the bot's emoji pack + "City rules")                                                                                                  |
| **Text**         | The panel's text. Up to 1,500 characters.                                  | "Before joining the city, read the rules: they apply to everyone, in and out of character." and, in small print, "Not knowing a rule doesn't spare anyone from the punishment." |
| **Button**       | The text of the button that opens the rules website. Up to 60 characters.  | "Read the rules"                                                                                                                                                                |
| **Button emoji** | The emoji next to the button's text.                                       | 📜                                                                                                                                                                              |

The title or the text must have something written, and the button needs text. The default texts follow the city's language.

### Shortcuts

| Field         | What it does                                                                                            | Default |
| ------------- | ------------------------------------------------------------------------------------------------------- | ------- |
| **Shortcuts** | Up to 4 pages get their own button next to the main one, in the order you choose. Published pages only. | None    |

The buttons sit in one row: the website's first, then the shortcuts. Each shortcut opens `https://<address>.fivedash.site/<page-address>`.

### Appearance

| Field                         | What it does                                                                                     | Default         |
| ----------------------------- | ------------------------------------------------------------------------------------------------ | --------------- |
| **Color**                     | The panel's stripe color.                                                                        | The bot's color |
| **Server at the top**         | The server's name and icon above the panel.                                                      | On              |
| **Server icon in the corner** | The thumbnail next to the text.                                                                  | On              |
| **Website image**             | The website's share image (or the first page's cover), under the text.                           | On              |
| **Last update date**          | Shows when the rules were last published. Publishing again updates the panel on its own.         | On              |
| **Footer**                    | The footer text. Up to 100 characters. Empty shows "Última atualização" (or the website's name). | Empty           |

## Panel status

| Status                                    | What it means                                                                           |
| ----------------------------------------- | --------------------------------------------------------------------------------------- |
| **Posted in #channel** · **posted … ago** | The panel is in the channel. **Open in Discord** opens the message.                     |
| **Not posted yet**                        | The panel hasn't gone to Discord yet.                                                   |
| **Saved, but the panel wasn't posted**    | The settings were saved, but Discord refused the message. The reason shows on the page. |

## Remove the panel from Discord

Turn off **Turn on the Discord panel** and click **Save**. **Panel removed from Discord** shows up ("The message left the channel.").

## Common errors

| Message                                                                                      | What to do                                                     |
| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| "Put the rules website live and publish it first: the panel takes people there."             | Publish the pages and turn on **Live** in **Rules → Website**. |
| "Set up this server's Discord bot first."                                                    | Set up the bot in **Discord → Bot**.                           |
| "Discord rejected the bot's token. Change it in the bot module."                             | Change the token in **Discord → Bot**.                         |
| "The bot can't send or edit messages in this channel. Check its permissions in the channel." | On Discord, check the bot's permissions in that channel.       |
| "This channel no longer exists. Choose another one."                                         | Pick another **Channel**.                                      |
| "Discord asked us to wait. Save again in a moment."                                          | Wait a few seconds and save again.                             |

## FAQ

**I published new rules. Do I need to post the panel again?**
No. Publishing the rules updates the panel on its own: the shortcuts and the last update date.

**I changed the website's address. Does the panel's button break?**
No. When you save the new address in **Rules → Website**, the panel switches to it.

**Why doesn't a page show up in the shortcuts?**
Only published pages show. Publish in **Rules → Pages** and come back.

## Next steps

[Website](https://fivedash.fivex.gg/docs/en/rules/site)Put the website live.
[Pages](https://fivedash.fivex.gg/docs/en/rules/pages)Write and publish the pages.
[Bot](https://fivedash.fivex.gg/docs/en/discord/bot)Set up the bot that posts the panel.
[Rules overview](https://fivedash.fivex.gg/docs/en/rules/overview)How the Rules module works.
