PinPalPinPal docs
Search for anything, or open a topic. Most topics have a Show me button that plays the exact clicks in Discord.
Getting started
Make your first pinAbout a minute, start to finish
- Add PinPal to your server.
- Run
/setupand press New pin (or Templates). - Write your message, choose channels, press Save.
PinPal reposts it after new messages and removes the old copy. New here? The getting started guide walks you through it.
TemplatesReady-made rules, welcome and support pins
/setup → Templates: server rules, welcome, support guide, no advertising, media only and suggestions. Live welcome needs PinPal+. Pick one, change anything, save.
CommandsEverything you can run
/setup | Pins, templates, presets, imports and stats |
| Apps → Create Pin | Turn any message into a pin |
/debug | Check a channel's pin and permissions |
/server | Manager role, timezone, DMs, activity log, data |
/plus | PinPal+, trial and billing |
/help | Every guide, searchable, inside Discord |
/personal | Your share codes and data |
/ping /vote /review /invite | Status, voting, reviews, invite link |
/setup, /debug and Create Pin need Manage Server or the pin manager role. /server needs Manage Server.
PermissionsWhat PinPal needs in each channel
View Channel, Send Messages, Embed Links and Read Message History (plus Send Messages in Threads for threads). PinPal only deletes its own messages, so it never needs Administrator or Manage Messages.
PinPal+ pins with a custom name and avatar also need Manage Webhooks in that channel. /debug checks the real permissions, including channel overrides. How this compares.
Building a pin
The pin editorEdit, preview, export or delete a pin
/setup lists every pin; pick one to open the editor. It has the message, up to 25 channels, timing, buttons, name and avatar, and expiry. Save posts it, Preview shows it only to you, Export makes a preset or share code.
Custom emojis: type \:emoji: in chat and paste the <:name:id> it shows.
Text, embeds & buttonsMarkdown, embeds and up to 20 link buttons
Text: normal Discord Markdown, up to 2,000 characters. Embeds: title, description, footer and colour. Pins never ping anyone.
Buttons: next to Link buttons press Edit and write one per line, like Rules | example.com/rules.
Repost timingHow long PinPal waits after new messages
Each new message pushes the repost back so chat can settle; busy channels still get the pin at least every 30 seconds. Free: 1 to 15 seconds. PinPal+: up to 30 minutes, a message count (up to 500), or both. Bot messages never trigger a repost.
Create Pin from a messageRight-click any message
Right-click a message (long-press on mobile) → Apps → Create Pin. PinPal copies it into a new pin for that channel.
Presets & share codesReuse a pin, or copy it to another server
Presets save a pin's setup in your server (Export → Save as preset; use from /setup → Presets). Free keeps 3, PinPal+ 50.
Share codes copy a pin to any server (Export → Create share code, then /setup → Import). They last a year. Neither includes channels or avatars.
PinPal+
What PinPal+ addsPer server, from $4.99 a month, 7-day free trial
Rotating messages, variables, a custom name and avatar, images, expiry, longer delays and message-count reposting, 90 days of stats, unlimited pins and 50 presets. Run /plus to start a trial or upgrade; it switches on about a minute after checkout. If it ends, nothing is deleted: PinPal+ features pause until you renew. See pricing.
Rotating messages PinPal+Up to 10 messages, one per repost
In the editor open the message menu → Add another message. Order switches between in order and random. Clear a message's text to remove it.
Variables PinPal+Live values like {member_count}
Filled in each time the pin posts, in text, titles, descriptions and footers: {server_name} {member_count} {channel} {channel_name} {boosts} {boost_tier} {date} {time} {day} {weekday} {month} {year} {unix}.
Countdowns: <t:{unix+3600}:R> shows "in an hour" in each reader's timezone. Dates use the timezone set in /server.
Name & avatar PinPal+Post with your own name and picture
Name and avatar → a name plus a PNG, JPG, GIF or WebP (up to 2 MB) or a Discord image link. Needs Manage Webhooks in that channel. PinPal never stores the picture.
Images PinPal+A picture in any pin
Open a message and paste a link into Image link (starting with https://). Tip: post the picture anywhere in Discord, right-click → Copy Link.
Pin expiry PinPal+Pins that remove themselves
Expiry → a number and unit, up to 12 months. PinPal deletes the posted message and the pin within a minute of it expiring.
LimitsFree vs PinPal+ at a glance
| Free | PinPal+ | |
|---|---|---|
| Pins | 10 | Unlimited |
| Presets | 3 | 50 |
| Repost delay | 1–15 seconds | Up to 30 minutes |
| Messages per pin | 1 | 10 |
| Stats history | 7 days | 90 days |
| Buttons · channels | 20 · 25 | 20 · 25 |
Your server
Server settingsManager role, timezone, DMs, data
/server (Manage Server): pick a pin manager role so moderators can use /setup, set the timezone, turn DMs on or off, open the activity log, or delete server data.
Stats & activityHow pins are doing, and who changed what
/setup → Stats: posts per pin, last post and any problem (7 days free, 90 on PinPal+). /server → Activity log: 90 days of changes. If a pin keeps failing, whoever saved it gets one DM a day.
About this pin (🔍)The button on every pin, and removing it
🔍 tells members the pin comes from your server, not PinPal. To ask for its removal, click 🔍 on the pin (or open it in /setup) → Request removal. Editing an approved pin brings it back. Free servers' pins must be in English to be reviewed.
Something wrong?
TroubleshootingStart with /debug in the channel
- Not reposting: run
/debug; usually a missing permission. - ⏸️ Paused: over the free plan's 10 pins. Delete some or upgrade.
- Custom name not used: give PinPal Manage Webhooks there.
- Reposts too often: raise the delay, or use a message count.
- Pin disappeared: it expired, was deleted, or the channel was recreated.
- Can't use /setup: you need Manage Server or the pin manager role.
Common questions
Why isn't my pin reposting?
Run /debug in the channel. The most common causes are missing permissions (View Channel, Send Messages, Embed Links, Read Message History), a pin paused because a free server has more than 10 pins, or a repost delay longer than you expected. If a pin keeps failing, whoever last saved it also gets a DM.
Can I have more than one pin in a channel?
Each channel has one pin. On PinPal+, that pin can rotate between up to 10 messages, which covers most reasons to want several.
Who can use /setup?
Anyone with the Manage Server permission, plus members with the pin manager role you choose in /server.
Do variables work on the free plan?
You can type them on any plan, but they're only filled in on PinPal+. On the free plan they show exactly as typed.
What happens to my pins if PinPal+ ends?
Nothing is deleted. PinPal+ features pause (only the first message shows, custom names switch back to PinPal, delays are capped, expiry timers stop) and pins over the free limit of 10 pause. Renew with /plus and everything resumes.
Does PinPal store the custom avatar I upload?
No. The picture is sent straight to Discord for the pin's webhook. PinPal only keeps a short fingerprint so it can tell when the picture changes. Images in pins are links, so PinPal never stores those either.
Does it work in threads?
Yes. Public threads and announcement threads show up in the channel picker. Private threads aren't supported.
No matches. Try another word, run /help in Discord, or ask in our support server.
Still stuck? Our support server is the fastest way to get help.