Help

How to use unfurl.

Getting started

unfurl works out of the box. There's nothing to configure.

  1. Invite unfurl to your server.
  2. Someone posts a link from a supported platform.
  3. unfurl replies with a fixed version that actually embeds. Done.

Admins can customize everything with /settings but it's completely optional.

Not your server? Add unfurl to your account instead and use /uf anywhere on Discord - see commands below.

How the bot works

Automatic processing

unfurl watches all channels it can see for links from supported platforms. When it finds one, it posts a fixed URL that shows a proper embed in Discord. It handles up to 5 URLs per message.

No commands needed. No prefixes. Just paste a link and the bot handles the rest.

Embed suppression

After posting the fix, unfurl hides Discord's broken embed on the original message so you don't see two previews. This is on by default but can be turned off with /settings embeds.

Undo and delete

Don't want the bot's reply? There are a few ways to remove it:

  • Undo reaction - When enabled, the bot adds an X reaction to its reply. The person who posted the link can click it to delete the bot's message. The reaction disappears after a timeout (default 2 minutes, configurable).
  • Trash reaction - The link author can react to the bot's reply with a trash emoji at any time to delete it. No timeout.
  • Admins - Anyone with Manage Messages can also use either reaction to remove bot replies.

Self-cleanup

unfurl keeps things tidy on its own:

  • If you edit your message and remove the link, the bot deletes its reply.
  • If you delete your message, the bot deletes its reply too.

DM forwarding

When enabled, anyone can react to a bot reply (with any emoji besides undo/trash) to get the fixed URLs sent to their DMs. Handy for saving links for later. Off by default - admins can enable it with /settings dm-forward.

Tweet translation

unfurl can automatically translate Twitter/X posts into your server's language. Non-English tweets show the translated text alongside the original, while same-language tweets are left untouched. This defaults to English and can be changed to any of 90+ languages - or turned off entirely - with /settings language (start typing a language name to search).

All 93 supported languages

Afrikaans, Albanian, Amharic, Arabic, Armenian, Azerbaijani, Basque, Belarusian, Bengali, Bosnian, Bulgarian, Catalan, Chinese, Corsican, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, Frisian, Galician, Georgian, German, Greek, Gujarati, Haitian Creole, Hausa, Hebrew, Hindi, Hungarian, Icelandic, Igbo, Indonesian, Irish, Italian, Japanese, Kannada, Kazakh, Khmer, Korean, Kurdish, Kyrgyz, Lao, Latin, Latvian, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Myanmar, Nepali, Norwegian, Pashto, Persian, Polish, Portuguese, Punjabi, Romanian, Russian, Samoan, Scots Gaelic, Shona, Sindhi, Sinhala, Slovak, Slovenian, Somali, Spanish, Sundanese, Swahili, Swedish, Tajik, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Uyghur, Uzbek, Vietnamese, Welsh, Xhosa, Yoruba, Zulu.

URL cleaning

Beyond fixing embeds, unfurl cleans up your links in several ways:

  • Tracking removal - Strips 150+ tracking parameters (UTM tags, fbclid, gclid, igshid, and many more) from URLs across all supported platforms.
  • AMP unwrapping - Converts Google AMP pages back to the original article URL.
  • Amazon cleaning - Reduces long Amazon URLs to a clean product link. No referral tags, no session IDs. Works across all Amazon domains.
  • eBay cleaning - Trims item and search links down to the essentials - search terms, seller and filters stay, the tracking blob goes. Works across all eBay marketplaces.
  • Share-link resolution - Share-sheet links (Reddit shares, TikTok short links, Facebook and Threads share links, and more) are followed to the real post before fixing.
  • Paywall bypass - Wraps 130+ paywalled news sites through archive.is so everyone can read the article.
  • Short URL expansion - Automatically expands shortened links (youtu.be, redd.it, vm.tiktok.com, etc.) before processing them.

Each of these can be toggled on or off individually per server.

Opt out for a single link

Prefix any URL with ! to skip it

Put an exclamation mark right before a URL (a space in between is fine) and unfurl will leave it alone. No fixed link, no tracking strip, nothing. Discord's native preview for that URL stays visible.

Example: !https://x.com/user/status/123

Useful when you want to keep Discord's built-in embed for a specific link, or share a raw URL without any processing. It works per-URL. If you have two links in the same message and only one is prefixed with !, the other gets fixed normally.

Commands

For everyone

/help

Shows supported platforms and features. Admins see additional settings info.

/privacy

Displays the privacy policy - what data is collected and how long it's kept.

/invite

Get the invite link to add unfurl to another server.

/uf <link>

Fix a link on demand and get the result right away.

Right-click → Apps → Fix links

Fixes every link in the selected message. Same result as /uf, no typing needed.

/status

A quick list of which platforms are working and which are down right now.

Use unfurl anywhere

Add unfurl to your account and /uf and the right-click action work everywhere you are on Discord: in DMs, group chats, and servers that don't have the bot. No permissions involved, it only responds when you invoke it.

For admins

These require Administrator permission or an authorized role/user.

/settings view

See all current settings at a glance - platforms, channel filter, modes, and more.

/settings platform <name> <on/off>

Toggle individual platforms or cleaning features on or off.

/settings channels <mode> [channel] [action]

Control where the bot operates. Modes: none (all channels, default), whitelist (only listed channels), or blacklist (everywhere except listed channels).

/settings embeds <on/off>

Toggle whether the bot suppresses Discord's native embed on the original message.

/settings reply-mode <mode>

Choose how the bot responds: new message (default) or reply (threaded under the original).

/settings undo <on/off> [timeout]

Enable/disable the undo reaction. Timeout is configurable from 10 to 600 seconds.

/settings dm-forward <on/off>

Enable/disable DM forwarding when users react to bot replies.

/settings language <code>

Set the language that Twitter/X posts are auto-translated into (English by default), or turn translation off.

/settings service

Switch between proxy services for platforms that have multiple options.

/settings authorize <role|user>

Grant a role or user permission to manage unfurl settings.

/settings deauthorize <role|user>

Revoke settings access from a role or user.

/settings exclude <role|user>

Stop fixing links posted by a role or user. Handy for opt-outs or other bots' announcement roles.

/settings unexclude <role|user>

Remove a role or user from the exclusion list.

/settings bot-messages <on/off>

Also fix links posted by other bots and webhooks. Off by default.

Permissions

unfurl asks for 7 permissions. It does not need Administrator.

Permission Why
View Channels See messages in channels
Send Messages Post fixed links
Send Messages in Threads Post fixed links in threads and forum posts too
Embed Links Include embeds in responses
Manage Messages Suppress broken embeds on original messages
Read Message History Handle reactions and edit/delete tracking
Add Reactions Add undo reaction to bot replies

All of these except Send Messages in Threads are required. If required permissions are missing when the bot joins, it will notify the server owner. If not fixed within 24 hours, the bot leaves automatically.

Common questions

The bot isn't responding to links

Check that the bot has the required permissions in the channel. Also check /settings view to make sure the platform isn't disabled and the channel isn't excluded by a filter. If a single platform stopped working everywhere, run /status - its fixer service might be down at the moment.

Can I use unfurl without adding it to a server?

Yes. Add it to your account and /uf plus the right-click action work in DMs, group chats, and any server you're in - even ones that don't have the bot. Account installs can't fix links automatically (Discord doesn't allow user-installed apps to read messages), so it's on-demand only.

Can I limit the bot to specific channels?

Yes. Use /settings channels whitelist to only allow specific channels, or /settings channels blacklist to exclude certain channels.

Can regular users delete the bot's replies?

Only the person who posted the original link can delete the bot's reply (via the undo or trash reaction). Admins and users with Manage Messages can also delete them.

Does the bot read my messages?

unfurl only looks at URLs from supported platforms. It does not store message content. See our privacy policy for full details.

How do I remove the bot?

Kick or ban it from your server like any other bot. All data collection stops immediately. For data deletion requests, join our support server.

Something else?

Join our support server and we'll help you out.