Skip to content

Configuration

Glue Stick decides when to refresh a message using two triggers you can tune per channel.

How refreshing works#

Every glued message has two thresholds, and whichever fires first wins:

  • Message count (messagecount, default 5) — as soon as this many new messages arrive, the glue immediately refreshes to the bottom.
  • Time (refreshtime, default 15 seconds) — if fewer messages than that arrive, the glue refreshes this many seconds after the first new message since the last refresh.

So with defaults, a burst of chat refreshes the glue almost instantly, while a single stray message refreshes it within 15 seconds. If nothing is posted, no refresh happens at all — and if the glued message is already the last message in the channel, the bot skips the refresh entirely rather than bumping it redundantly.

What a refresh actually does#

A refresh isn't Discord moving your message — that isn't something Discord allows. Glue Stick posts a fresh copy at the bottom and deletes the old one, in that order, so a hiccup can never leave the channel with no glue at all.

The practical consequences:

  • The glued message gets a new message link every refresh. Reactions, replies and pins on the previous copy don't carry over.
  • Because of that, don't pin a glued message or ask members to react to it — point them at a normal message instead.
  • If the glue is already the newest message in the channel, the refresh is skipped entirely rather than reposting redundantly.

Tuning with /refreshconfig#

View the current settings for a channel:

/refreshconfig

Or change one or both thresholds:

/refreshconfig messagecount:10 refreshtime:60
  • messagecount accepts 5–500 messages.
  • refreshtime accepts 15–86400 seconds (15 s to 24 hours).
  • The optional channel argument lets you configure another glued channel without leaving the one you're in.

Changes apply to the cycle already in progress, so shortening the time on a glue that's already waiting can make it refresh right away. If the channel has already passed the new message count and the glue is buried, it refreshes immediately — but a quiet channel is left alone rather than being bumped just to prove the setting took. Full option details are in the command reference.

Per-channel settings#

  • Settings belong to the channel's glued message, not the server — every glued channel can have its own thresholds.
  • Each channel holds exactly one glued message; gluing again replaces it and keeps the channel's thresholds — you don't need to re-tune.
  • Editing with /editglue keeps the channel's thresholds.
  • Threads count as their own channels, with their own glue and settings.

Recommended settings#

  • Busy general chat — raise both (e.g. messagecount:15, refreshtime:60) so the glue isn't refreshing constantly.
  • Announcements / rules channels — the defaults are fine; traffic is low, so the glue rarely moves.
  • Event or support channels — keep messagecount low so the key message snaps back quickly during activity spikes.
  • Very quiet channels — because refreshtime goes up to 24 hours and messagecount up to 500, you can set a glue that only resurfaces once a day, or only after a real conversation has happened.