PinPal Logo

PinPal Documentation

Your complete guide to creating, managing, importing, and exporting sticky messages on Discord. Everything explained step by step with examples and tips.

Need help? Join our support server anytime!

Overview

PinPal is the ultimate sticky message bot for Discord servers of all sizes. It allows you to keep your server’s most important messages, announcements, and guides visible by automatically reposting them at the bottom of the channel. Unlike other bots, PinPal combines simplicity, flexibility, and full control, all without forcing premium tiers or limits.

Whether you are managing rules, resource links, or welcome messages, PinPal ensures everything important stays visible. If you ever have questions while using PinPal, remember to join our support server for live help and tips.

  • 100 free pins per server with no premium restrictions.
  • All configuration happens inside Discord using /setup.
  • Supports text or embed messages with full customization.
  • Full control over your data with instant deletion options.

How Setup Works

Setting up PinPal is fast and easy. The /setup command opens a clean, interactive menu that guides you through every option.

  • Create a new Pin: Choose channels, message type (text or embed), content, optional buttons, and save to activate instantly.
  • Edit a Pin: Update any existing pin, including buttons, delay, or assigned channels.
  • Import: Load a preset stored in your server or use a share code from someone else.
  • Delete Pins: Remove pins from selected channels or clear all.
  • List Pins: View all active pins across the server.
  • Manage Presets: Save, import, or delete up to 25 templates for repeated use.

Need more guidance? Join our support server for setup tips and visual examples.

Creating & Editing Pins

After opening /setup, creating or editing pins is straightforward. You can fully customize your messages, ensuring they fit your server style.

  1. Open /setup and select Create a new Pin.
  2. Choose message type:
    • Text — a simple single message box.
    • Embed — allows title, description, footer, and hex color (e.g., #ECC3D).
  3. Select one or multiple channels where the pin will appear.
  4. (Optional) Add up to 5 custom buttons with labels and URLs.
  5. (Optional) Set a sticky delay (1–15 seconds) for how fast the message reposts.
  6. (Optional) Preview your pin to ensure it looks perfect before saving.
  7. Save or export your pin; it activates immediately in your server.

To edit a pin, select Edit a Pin in /setup, make your changes, and save. If you encounter issues, our support server is always ready to assist.

Import & Export

Share your pin setups or reuse templates across servers:

  • Server Presets: Save up to 25 reusable templates per server.
  • Share Codes: Export pins as codes that others can import. Codes expire after 365 days.
  • Maintain consistent layouts across multiple servers or share designs with moderators.
  • Imported pins open directly in the create/edit screen, ready for adjustments before saving.

Management & Permissions

  • Deleting Pins: Use /setup → Delete Pins and choose channels.
  • Listing Pins: Use /setup → List Pins to view all pins in the server.
  • Required Permissions: PinPal needs Send Messages, Manage Messages, Embed Links, and Read Message History. Run /debug for troubleshooting.
  • Data Deletion: Remove personal share codes or all server pins with /delete_data. This action is permanent.

If you ever have questions or need help understanding permissions, join our support server.

Commands Reference

Public Commands

  • /help — Learn about PinPal and how it works.
  • /ping — Check latency and bot performance.
  • /vote — Vote for PinPal on Top.gg.
  • /review — Leave a review on Top.gg.
  • /invite — Get the bot invite link for your server.
  • /delete_data — Remove your personal data (share codes).

Administrator Commands

  • /setup — Create, edit, delete, import, list, and manage presets.
  • /delete_data — Remove all server data (pins and presets).
  • /debug — Debug channel setup or permission issues.

Need extra help with any commands? Our support server is the fastest way to get assistance.

FAQ & Tips

Here are some common questions we receive from users:

  • Q: Can PinPal replace my pin archive bot? A: No, PinPal focuses on sticky messages, not pin storage. Use PinPal for visibility, not archiving.
  • Q: Can I remove the "Vote for Pinpal!" button? A: Yes! You can remove the button by managing the buttons attatched to a sticky message when setting up or editing! The vote for PinPal button is just a default button we add to help spread the word about PinPal, but you can remove it if you want.
  • Q: How many pins can I have? A: 100 per server, completely free.
  • Q: What if a pin doesn't appear? A: Check permissions and run /debug. Our support server can guide you.