πŸ“š StickyBot Knowledge Base

Everything you need to master StickyBot

From first-time setup to advanced rotations, this documentation covers every command, premium workflow, and troubleshooting scenario for StickyBot. Build unforgettable server experiences with confidence.

StickyBot embed preview
Getting Started

Install & Invite

Add StickyBot to your server with the recommended permissions for channel management, webhooks, and message posting.

Free Tier Essentials

Start with `/sticky set` to configure your first sticky message. Free servers can keep one sticky active with message templates.

  • `/sticky set` β†’ choose a channel and configure timing
  • `/message create` β†’ build reusable message templates
  • `/sticky status` β†’ verify active stickies per channel

Upgrade to Premium

Enable embed templates, lower rate limits, rotations, and webhook customization by upgrading through the dashboard or `/premium` command.

  • Start a 7-day trial from the dashboard
  • Premium servers unlock up to 5 stickies
  • Category-based stickies apply across entire channel groups
Command Reference
Command Purpose Notes
/sticky set Create or update a sticky for a channel or category. Premium unlocks category selection, rotations, and webhook templates.
/sticky disable Interactive menu to disable multiple stickies at once. Includes manual input for channel/thread IDs.
/sticky status Check active sticky configuration for a channel. Displays category inheritance, excluded channels, and webhook usage.
/message create Save simple text templates for free-tier stickies. Collects message content, optional buttons, and attachments.
/embed create Launch the live embed builder with real-time preview. Free users can build & save templates, premium required to deploy.
/template list & /template edit Manage saved templates. Edit embeds with converted Discord channel links. Templates show `[Msg]` or `[Embed]` prefixes for easy filtering.
/premium View premium status, benefits, and upgrade links. Highlights 14-day trial, lower rate limits, and webhook perks.
Webhook Automation

Create Webhook Templates

`/webhook create` now saves reusable templates without needing a channel. Configure the avatar, name, and branding once.

  • Select template when saving stickies in `/sticky set`
  • StickyBot auto-creates channel-specific webhooks on demand
  • Forum threads use parent channel webhooks with `thread_id` routing

Category Stickies + Webhooks

Premium servers can apply a sticky to entire categories. Exclude specific channels and StickyBot manages webhook posting everywhere else.

  • Channel overrides take priority over category stickies
  • Disable a channel sticky β†’ auto-excludes from category posting
  • Logs capture webhook creation errors for quick debugging

Troubleshooting Tips

Enable `ADVANCED_STICKY_DEBUG=true` in your environment to log category detection, webhook usage, and posting attempts.

  • Look for `WebhookError: 400` when thread IDs are missing
  • Check `ChannelSticky` records for excluded channel IDs
  • Use `/sticky status` to verify the active configuration

Premium Feature Checklist

Ensure your premium experience runs smoothly with these quick diagnostics.

  • Invite StickyBot using the latest permission set.
  • Confirm the inviter or owner receives onboarding DMs when the bot joins/leaves.
  • Use `/help` to verify the premium feature list reflects the 14-day trial and category stickies.
  • Check the dashboard β†’ My Subscriptions for live status after cancel/resume actions.
  • Invite Service runs every 24 hours; ensure audit logging is enabled if links fail to regenerate.

Frequently Asked Questions

How can free users explore embeds without paying?
Free-tier servers can run `/embed create`, build a complete embed, and save it as a template. A premium upsell message explains how to unlock deployment with the 14-day risk-free trial.
What happens if my premium payment fails?
Premium status checker disables embed-based stickies, notifies the inviter/owner, and keeps message templates active. Update the payment method to restore premium features instantly.
Can I migrate sticky data between servers?
Yes. If StickyBot leaves a guild, configs are retained for 48 hours. Re-invite within that window to restore stickies, templates, and rotation sets automatically.
Where do I edit welcome or goodbye messages?
Inside the codebase, see `src/core/events/guildCreate.ts` for welcome messaging and `src/core/events/guildDelete.ts` for goodbye messages. Both reference the new family-focused copy and discords.bot branding.

Need extra help or bespoke features?

We’re building more premium, feature-rich bots at discords.bot. Share your ideas and maybe it becomes our next launch.

Chat with Support