Billboard BotOpen dashboard

Getting started with Billboard Bot

From inviting the bot to a live rotating billboard — five short steps. Everything below can be done either with slash commands in Discord or from the web dashboard.

1

Invite the bot

Click the button below (or the one in the dashboard) and pick your server. The invite asks for exactly the permissions the bot needs in the channels where billboards will live:

  • View Channel— see the channel the billboard lives in
  • Send Messages— post the billboard message itself
  • Embed Links— render rich embeds in your frames
  • Attach Files— attach images to frames
  • Read Message History— find its own message again and snapshot frames from message IDs
  • Manage Messages— clean up its own message when a fast billboard needs a refresh
  • Pin Messages— pin the billboard and re-pin it after a refresh

You can restrict these to a single channel after inviting — the bot only needs them where a billboard is active.

Add to Discord
2

Create your first billboard

In any channel the bot can see, run:

/billboard create name:welcome interval:60s channel:#lobby pin:true

This creates a billboard named "welcome" that will rotate every 60 seconds in #lobby and stay pinned. It starts as a draft — nothing is posted yet.

Prefer clicking? Open the dashboard, pick your server and hit "New billboard" — same result, with a form instead of a command.

3

Add frames

A frame is one "page" of your billboard — markdown text, embeds, images. The quickest way is snapshotting an existing message by its ID:

/billboard frames add billboard:welcome message_id:1380491624571212845 duration:30s

Right-click any message → "Copy Message ID" (enable Developer Mode in Discord settings if you do not see it). The optional duration overrides the billboard interval for that single frame.

Snapshotting messages written by other users requires the Message Content toggle to be enabled for the bot in the Discord Developer Portal. Messages posted by the bot itself always work. If a snapshot comes back empty, this toggle is the reason.

Or skip message IDs entirely: the dashboard has a full editor with embeds, images and a live preview that renders exactly like Discord.

4

Activate and verify

Once you have at least one frame, switch the billboard on:

/billboard activate billboard:welcome

The bot posts the billboard message in the configured channel (and pins it, if enabled). Watch it for a minute — you should see the content swap to the next frame on your interval, edited in place with no new messages appearing.

Check rotation health, last edit time and any permission problems at a glance with:

/billboard status billboard:welcome
5

Pro tips

  • Per-frame durations

    Give an important frame 120 seconds and a minor one 30 — each frame can override the billboard interval with its own duration.

  • Dynamic variables

    Write {server.name}, {date} or {time} anywhere in a frame and it renders live on every rotation. Pro adds {server.membercount} and {server.boosts} — great for growth milestones.

  • Pin it

    A pinned billboard is always one tap away in the channel header. The bot re-pins automatically whenever the message has to be reposted.

  • Schedule windows (Pro)

    Limit rotation to specific weekdays and hours — an event billboard that only runs Friday to Sunday, or office-hours support info. Outside the window the billboard pauses quietly.