Skip to main content

​
Activity timing

refresh_seconds defaults to 8 seconds and accepts 2–300 through .sticky interval or the Dashboard. Each message that is not ignored schedules or resets the wait. min_interval_seconds limits consecutive publications, defaults to 12 seconds, and accepts normalized values from 0–600; change it in the Dashboard Sticky settings. If the minimum has not elapsed, Headless schedules the refresh for later.

​
.sticky mode

​
.sticky interval

​
What refresh does

ignore_bots is enabled by default, so bot messages do not reset the timer. Headless also does not treat its own sticky as new activity. When the normal wait completes, it publishes a new notice and then attempts to delete the previous one when delete_previous is enabled (also the default). Configuration commands and refresh force an update of the existing message when available. Send/delete failures are recorded in status and may require a permission check.

​
.sticky refresh

​
Format, content, and permissions

Choose embed or plain text. Plain text is limited to 1,900 characters; normalized configuration limits title to 120, message to 1,800, footer to 180, and link label to 80. New defaults are Important notice and Review this information before continuing in the channel.; the button label defaults to Open link. When reading saved settings, Headless translates only former built-in values that match exactly and preserves customized text. Images accept HTTP(S) URLs; links accept HTTP(S) or discord://. Configuration commands require Manage Messages; the bot needs Send Messages, Embed Links for embeds, and Manage Messages to replace or delete its posts.

​
.sticky set

​
.sticky title

​
.sticky image

​
.sticky

remove deletes the channel record and attempts to delete the current post. off only disables it and keeps the configuration. Confirm the channel before clearing it.
Note: The refresh delay is a wait after activity, not a periodic send. When the channel is quiet, Sticky does not post again. refresh_seconds, min_interval_seconds, ignore_bots, and delete_previous are separate controls: one waits after activity, one spaces out publications, and the others decide which activity to ignore and whether to delete the previous notice.

​
Sticky variables

Title, message, and footer accept only , , , , , , and . Time is rendered in UTC. Mentions are disabled on sends; a token cannot trigger a ping.

​
Storage and channels

Settings are isolated per server and channel. set and here create or enable a sticky; off keeps it disabled; remove deletes the configuration and attempts to delete the current post. list shows saved channels and show checks the current or selected channel. When delete_previous is disabled, older notices may remain in the channel.

​
.sticky here

​
.sticky show

​
.sticky off

​
.sticky remove

​
Steps

1

Configure the notice

Run .sticky set #announcements text or .sticky here text in the current channel.
2

Customize the appearance

Choose embed/text and set a title, image, or URL link.
3

Test refresh

Post a human message in the channel, then check .sticky show or force an update with .sticky refresh.
The group alias is .stick. Commands: .sticky (current-channel status); .sticky set #channel message; .sticky here message; .sticky title #channel title; .sticky message #channel text; .sticky on [#channel]; .sticky off [#channel]; .sticky remove [#channel]; .sticky refresh [#channel]; .sticky mode embed|text [#channel]; .sticky image #channel URL; .sticky link #channel URL [label]; .sticky interval seconds [#channel]; .sticky list; .sticky show [#channel]. remove aliases: delete and clear; refresh aliases: repost and fix.
/sticky supports status, set, here, on, off, refresh, mode, interval, image, and link, with channel, message, mode, seconds, url, and label fields. It defaults to Manage Messages. It has no remove action; use the prefix command .sticky remove to delete a channel record.
The Sticky editor also exposes minimum interval, ignore bots, and whether to delete the previous post; there are no prefix subcommands for these settings. Ignore bots is enabled by default. If you disable previous-post deletion, older publications may remain in the channel after activity.

​
Use and content

Recommended use

Compact notices that stay easy to find without scheduling periodic posts.
  • Short rules.
  • Support notices.
  • Reminders about help channels.

Rich content

Choose text or an embed and add useful material for the community.
  • Add an HTTPS image.
  • Add a link or button.
  • Use plain text when the channel does not need an embed.

Dashboard

The Dashboard editor can change the message and its per-channel behavior.
  • Edit the message.
  • Change the channel.
  • Preview it before enabling.