StickyPro Documentation
Welcome to StickyPro, the premium Discord sticky message bot that's completely free and gives you total control over your server's important messages.
Getting Started
Adding StickyPro to Your Server
- Click the Add Bot button
- Select the server you want to add StickyPro to
- Authorize the required permissions
- You're ready to start using StickyPro!
Required Permissions
StickyPro requires the following permissions to function properly:
- View Channels - To see the channels where sticky messages are posted
- Send Messages - To post sticky messages
- Manage Messages - To delete old sticky messages and keep the latest one visible
First Steps
Once added to your server:
- Use
/dashboardto open the StickyPro control panel - Click "Create New Pin" to create your first sticky message
- Choose between a Text Message or Embed Message
- Configure your channels and posting mode
- Your sticky message is now active!
Features
Completely Free
Every feature is available to all servers at no cost. No paywalls, no premium tiers, no limits.
Multiple Pin Types
Text Messages
- Simple plain text sticky messages
- Up to 2,000 characters
- Perfect for quick announcements
Embed Messages
- Rich, formatted messages with colors and styling
- Support for titles, descriptions, and footers
- Add images, thumbnails, and footer icons
- Full customization with hex color codes
Advanced Configuration
- Up to 100 sticky messages per server
- Up to 5 channels per sticky message
- Four posting modes: Always on Top, Every X Messages, Every X Minutes, After Inactivity
- Customizable delay: Set delay between 0.1 and 3600 seconds before posting
- Dashboard control: Manage everything through an intuitive interface
Multi-Channel Support
Deploy the same sticky message across multiple channels simultaneously. Perfect for:
- Server-wide announcements
- Category-specific rules
- Multi-channel events
Commands
StickyPro uses Discord's slash commands for easy access.
/dashboard
Opens the StickyPro control panel where you can:
- Create new sticky messages
- Manage existing pins
- View help information
/help
Displays detailed help information about StickyPro features and usage.
Creating Sticky Messages
Step 1: Choose Message Type
When creating a new pin, you'll first choose between:
Text Message
A simple plain text message. Best for:
- Quick announcements
- Simple rules
- Server information
Embed Message
A rich formatted message. Best for:
- Eye-catching announcements
- Detailed rules with sections
- Professional-looking information
Step 2: Configure Content
For Text Messages:
- Enter your message content (up to 2,000 characters)
- Click submit
For Embed Messages:
- Description (Required): Main content of your embed (up to 4,096 characters)
- Title (Optional): Embed title (up to 256 characters)
- Color (Optional): Hex color code (e.g., #5865F2 or #FFF)
- Footer (Optional): Small text at bottom (up to 2,048 characters)
- Images (Optional): Large image URL, Thumbnail URL, Footer icon URL
http:// or https://
#5865F2(Blue/Purple)#FF0000(Red)#FFF(White)
Step 3: Select Channels
Choose which channels will display your sticky message:
- Select up to 5 channels from the dropdown
- Each channel can only have one sticky message
- Channels already in use will not appear in the list
Step 4: Configure Mode
Choose how your sticky message will be posted:
Always on Top
- Reposts after every message in the channel
- Keeps your message at the bottom of the chat at all times
- Best for active channels with important information
Every X Messages
- Reposts after a specified number of messages (1-100)
- Less frequent than "Always on Top"
- Good for moderately active channels
Every X Minutes
- Reposts at a set time interval (1-1440 minutes)
- Time-based posting regardless of chat activity
- Perfect for periodic reminders or low-activity channels
After Inactivity
- Reposts after X minutes of no messages in the channel (1-1440 minutes)
- Only triggers when the channel goes quiet
- Perfect for channels that need reminders during inactivity
Step 5: Set Delay (Optional)
Configure the delay before the sticky message is posted:
- Default: 1 second
- Range: 0.1 to 3,600 seconds (1 hour)
- Prevents rapid reposting and spam
- Gives time for conversations to flow naturally
Step 6: Create Pin
Review your configuration and click "Create Pin" to activate your sticky message.
Managing Sticky Messages
Accessing Pin Management
- Use
/dashboard - Click "Manage Pins"
- Select the pin you want to manage
Available Management Options
Preview
View how your sticky message will appear in channels without posting it.
Edit Content
Modify the text or embed content of your sticky message:
- For text messages: Update the message text
- For embed messages: Change title, description, color, etc
Changes take effect immediately in all channels.
Edit Images
Modify the images of your sticky message (embed messages only):
- Update the large image URL (main embed image)
- Update the thumbnail URL (small image in top-right)
- Update the footer icon URL (small icon next to footer text)
- Leave fields empty to remove images
Changes take effect immediately in all channels.
Edit Channels
Add or remove channels where the sticky message appears:
- Select new channels from the dropdown
- Deselect channels to remove them
- Changes update automatically
Edit Mode
Change how the sticky message is posted:
- Switch between Always on Top, Every X Messages, Every X Minutes, or After Inactivity
- Update the frequency value for message count, interval, or inactivity modes
Edit Delay
Adjust the delay before sticky messages are posted:
- Set a new value between 0.1 and 3,600 seconds
- Helps control posting frequency
Pause/Resume
Temporarily disable or re-enable a sticky message:
- Paused - Sticky message won't post
- Active - Sticky message is posting normally
Useful for temporary events or maintenance.
Delete
Permanently remove a sticky message:
- Deletes the configuration
- Removes the last posted message from all channels
- Frees up the channels for new pins
Pin Modes
Always on Top
How it works: Posts the sticky message after every single message in the channel.
Best for:
- Very active channels
- Critical information that must always be visible
- Rules channels
- Important announcements
Considerations:
- Can be overwhelming in very active channels
- Use delay settings to prevent rapid posting
Every X Messages
How it works: Counts messages in the channel and reposts the sticky after X messages.
Configuration: Set the message count (1-100)
Best for:
- Moderately active channels
- Periodic reminders
- Channels where you want visibility without constant posting
Considerations:
- Won't post if channel is inactive
- Resets count each time it posts
Every X Minutes
How it works: Posts the sticky message at regular time intervals, regardless of chat activity.
Configuration: Set the interval in minutes (1-1440 minutes / 24 hours)
Best for:
- Time-sensitive information
- Low-activity channels
- Scheduled reminders
- Event countdowns
Considerations:
- Posts even if no one is chatting
- Good for ensuring visibility over time
After Inactivity
How it works: Starts a countdown when the channel goes quiet. If no messages are sent for X minutes, the sticky is reposted. Every new message resets the timer.
Configuration: Set the inactivity timeout in minutes (1-1440 minutes)
Best for:
- Channels that go quiet between bursts of activity
- Reminders that should appear when conversations die down
- Support or help channels where rules should reappear after silence
- Event channels between activity periods
Considerations:
- Won't post while the channel is active — timer resets on every message
- Unlike "Every X Minutes", this only triggers during genuine quiet periods
Permissions
User Permissions
To use StickyPro commands and manage sticky messages, users need:
Manage Server permission on the Discord server
This ensures only trusted members can create and manage sticky messages.
Bot Permissions
StickyPro requires the following permissions in channels where sticky messages are posted:
View Channel
Allows the bot to see the channel and read messages.
Send Messages
Allows the bot to post sticky messages.
Manage Messages
Allows the bot to delete old sticky messages to keep only the latest one visible.
Permission Issues
If you see a warning about missing permissions:
- Check the channel's permission settings
- Ensure StickyPro has the three required permissions
- Check both role permissions and channel-specific overrides
- If using channel categories, check category permissions
Fixing permissions:
- Go to Server Settings → Roles
- Find the StickyPro role
- Enable View Channel, Send Messages, and Manage Messages
- Or, edit individual channel permissions for the bot
Troubleshooting
Sticky Message Not Posting
Problem: The sticky message isn't appearing in the channel.
Solutions:
- Check that the pin is active (not paused)
- Verify bot permissions in the channel (View Channel, Send Messages, Manage Messages)
- Ensure the channel is correctly selected in pin settings
- For "Every X Messages" mode, make sure enough messages have been sent
- For "Every X Minutes" mode, wait for the interval to elapse
- For "After Inactivity" mode, ensure no messages have been sent during the configured quiet period
"Session Expired" Error
Problem: You see "Session expired. Please start over" when creating a pin.
Solutions:
- Sessions expire after 15 minutes of inactivity
- Start over by using
/dashboardand creating a new pin - Complete the setup process without long pauses
"Pin Not Found" Error
Problem: Can't edit or manage a specific pin.
Solutions:
- The pin may have been deleted by another administrator
- Refresh the dashboard by closing and reopening with
/dashboard - Ensure you're on the correct server
Channel Already in Use
Problem: Can't select a channel when creating or editing a pin.
Solutions:
- Each channel can only have one sticky message
- Edit or delete the existing pin in that channel first
- Or choose a different channel
Maximum Pins Reached
Problem: Can't create new pins - "maximum 100 pins per server" message.
Solutions:
- Delete unused or outdated pins
- Consider combining similar pins
- Manage your pins through the Manage Pins menu
Old Messages Not Deleting
Problem: Previous sticky messages remain in the channel.
Solutions:
- Ensure bot has "Manage Messages" permission
- Messages older than 14 days cannot be deleted by bots (Discord limitation)
- Manually delete old sticky messages if needed
Rate Limiting Error
Problem: "You are being rate limited" message appears.
Solutions:
- You've used too many commands too quickly
- Wait 1 minute before trying again
- Rate limit: 30 requests per minute per user
Command Cooldown
Problem: "Please wait X seconds before using this command again."
Solutions:
- Commands have a 3-second cooldown
- Wait the specified time before using the command again
- This prevents spam and ensures smooth operation
FAQ
General Questions
Q: How many sticky messages can I create?
A: You can create up to 100 sticky messages per server.
Q: Can I use the same sticky message in multiple channels?
A: Yes! Each sticky message can be posted in up to 5 channels simultaneously.
Q: Does StickyPro work in DMs?
A: No, StickyPro only works in servers, not in direct messages.
Technical Questions
Q: What happens to sticky messages when the bot goes offline?
A: Interval and inactivity-based sticky messages will resume their timers when the bot comes back online. "Always on Top" and "Every X Messages" modes will work normally once the bot is online.
Q: What happens if multiple admins edit the same pin simultaneously?
A: The last edit submitted will take effect. StickyPro processes edits in the order they're received, and changes are applied immediately to all channels.
Q: Are there any Discord API rate limits I should know about?
A: StickyPro automatically handles Discord's rate limits with smart retry logic. If you're posting in very active channels with "Always on Top" mode, the bot may occasionally delay posts by 1-2 seconds to avoid hitting limits.
Q: Can I customize the appearance of sticky messages?
A: Yes! Embed messages support full customization including colors, titles, footers, images, and thumbnails.
Q: How long can my sticky message be?
A: Text messages can be up to 2,000 characters. Embed descriptions can be up to 4,096 characters.
Q: Can other members delete sticky messages?
A: Members with "Manage Messages" permission can delete sticky messages manually, but the bot will repost them according to the configured mode.
Feature Questions
Q: Can I pause a sticky message temporarily?
A: Yes! Use the "Pause" button in the pin management menu. You can resume it anytime.
Q: Will sticky messages be deleted if I remove the bot?
A: The sticky messages will remain in your channels, but the bot won't manage or repost them.
Q: Can I schedule sticky messages for specific times?
A: Currently, StickyPro supports interval-based posting (Every X Minutes) but not specific time scheduling.
Q: What's the difference between delay and interval?
A: Delay is the pause before posting after a trigger (default 1 second). Interval is the time between automatic posts in "Every X Minutes" mode.
Support Questions
Q: How do I report a bug?
A: Join our Support Server and report the issue in the appropriate channel.
Q: Can I suggest new features?
A: Absolutely! We welcome suggestions in our Support Server.
Q: Is there a status page?
A: Yes! Check stickypro.xyz/status for real-time uptime information.
Q: How do I get help with setup?
A: Join our Support Server for assistance from our team and community.
Quick Reference
Limits at a Glance
| Feature | Limit |
|---|---|
| Pins per server | 100 |
| Channels per pin | 5 |
| Text message length | 2,000 characters |
| Embed description | 4,096 characters |
| Embed title | 256 characters |
| Embed footer | 2,048 characters |
| Delay range | 0.1 - 3,600 seconds |
| Message count (Every X Messages) | 1 - 100 messages |
| Interval range (Every X Minutes) | 1 - 1,440 minutes (24 hours) |
| Inactivity timeout (After Inactivity) | 1 - 1,440 minutes (24 hours) |
Required Permissions
| Permission | Purpose |
|---|---|
| View Channel | See the channel |
| Send Messages | Post sticky messages |
| Manage Messages | Delete old sticky messages |
Command Cooldowns
| Command | Cooldown |
|---|---|
| /dashboard | 3 seconds |
| /help | 3 seconds |