Get Real-Time YOURLS Notifications in Discord (YOURLS Discord Notify Plugin)
If you run your own URL shortener using YOURLS (Your Own URL Shortener), logging in constantly to check activity gets old fast. New links, clicks, failed logins, or suspicious behavior can easily go unnoticed.
That’s where YOURLS Discord Notify comes in.
This plugin sends real-time YOURLS activity alerts directly to your Discord server, giving you instant visibility into what’s happening with your links — without opening the admin panel.
What YOURLS Discord Notify Does
Once installed, the plugin connects your YOURLS instance to Discord using a webhook and delivers clean, readable notifications for key events.
Core Features
-
🔗 New Short URL Notifications
-
👆 Link Click Alerts (with optional cooldown to prevent spam)
-
✏️ Link Edit & Delete Alerts
-
🔐 Successful Login Notifications
-
🚨 Failed Login Alerts (great for security monitoring)
-
🌍 IP Geolocation Data
-
City, region, country
-
Country flag emoji
-
ISP information
-
-
📊 Daily & Weekly Summary Reports
-
⚙️ Per-Event Enable/Disable Controls
Everything is configurable, so you only get the alerts you actually care about.
Why Use Discord for YOURLS Alerts?
Discord is already where many developers and teams live day-to-day. Instead of email alerts or manually checking logs, you get:
-
Instant visibility
-
Centralized monitoring
-
Easy sharing with teammates
-
Clear audit trail of activity
It turns Discord into a real-time monitoring dashboard for your URL shortener.
Installation (Quick Start)
1. Download the Plugin
Upload the plugin into your YOURLS plugins directory:
2. Create a Discord Webhook
In your Discord server:
-
Go to Server Settings → Integrations → Webhooks
-
Create a new webhook
-
Choose the channel for notifications
-
Copy the webhook URL
3. Activate the Plugin
-
Log in to YOURLS Admin
-
Go to Plugins
-
Activate YOURLS Discord Notify
4. Configure Settings
-
Paste in your Discord webhook URL
-
Enable or disable specific events
-
Adjust click cooldown and display options
-
Save settings
You’re done — notifications will start immediately.
Example Discord Notifications
New Short URL Created
Failed Login Attempt
Daily Summary Report
Advanced Features Worth Noting
Click Rate Limiting
High-traffic links won’t spam your Discord channel. You can define a cooldown window so only meaningful click events are reported.
Geolocation Caching
IP lookups are cached for 24 hours to reduce API usage and improve performance.
Branded Domain Display
Notifications can show your custom YOURLS domain instead of generic system names.
Requirements
Before installing, make sure your server meets these requirements:
-
YOURLS v1.7+
-
PHP 7.0 or newer
-
PHP cURL extension enabled
-
Outbound HTTPS access (for Discord webhooks)
Who This Plugin Is For
-
Developers running private or public YOURLS installs
-
Self-hosters who want real-time monitoring
-
Teams managing marketing or affiliate links
-
Anyone who wants better security visibility
If you care about what your links are doing as it happens, this plugin fits perfectly.
Get the Plugin
You can download or contribute to the project here: