A curated list of awesome things related to YOURLS
- Official Links - Official guides and tools
- Plugins - what makes YOURLS so versatile and powerful
- Themes - to customize how YOURLS looks
- Translations - YOURLS in your language
- Integrations - Third-party integrations and frameworks
- Guides & tutorials - Community resources
- Showcases - Inspiration and celebrity endorsements
Something missing or incorrect ? Want to get your work listed ? See how you can contribute !
Official material from the YOURLS team
- Official Readme
- GitHub Repo
- Release Notes
- YOURLS News
- Official Forum
- YOURLS using Docker
- YOURLS using Helm for Kubernetes
All known plugins - either from the community, or from the YOURLS team, marked with a
- 302-Instead - Send a 302 (temporary) redirect instead of 301 (permanent), for sites where shortlinks may change
- 302-Instead - A fork of previous plugin, with some more options
- 404 If Not Found
☑️- Give a 404 Not Found if the short URL is not found
- AAF Rapid Connect auth - AAF Rapid Connect authentication plugin for YOURLS
- Abuse Desk for YOURLS - A Google Safe Browsing implementation for YOURLS to avoid spam links
- Access Control Allow Origin - Prevents CORS issue with domain CNAMES and aliases for admin actions
- Additional Charsets - Define additional character sets for short URLs
- Admin Issue Diagnostic - A.I.D. - Collects YOURLS environmentals and formats a template to copy/paste into a YOURLS issue. Just fill in the blanks! Fantastic for newbies, great for experts!
- Admin NoReCAPTCHA - Protect logins with Google's No CAPTCHA reCAPTCHA (Google's ReCAPTCHA v2.0)
- Admin reCaptcha - Spam protection for private YOURLS admin interface with reCaptcha
- Advanced Reserved URLs - Extends the reserved word functionality, blocking short URLs containing reserved words, even if mixed case or written in leetspeak
- Allow Aliases - Allow YOURLS to work with alias hostnames for the server
- Allow Forward Slashes in Short URLs - Just as the name says.
- Always-302 - A newer alternative to 302-Instead, tested with YOURLS 1.7.x
- Amazon Affiliate - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection.
- Amazon Affiliate With Notice - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection with a notice of Amazon Affiliate link usage.
- Anonymise - Anonymise the log data that YOURLS captures.
☑️- Merciless antispam plugin using the 3 major domain blacklists
- YOURLS APC Cache - Add support for APC to reduce MySQL queries
- API Action
☑️- Example plugin for YOURLS 1.6+ to show how to implement custom API actions
- API Delete - Add a "delete" action to the API
- API Edit URL - Add an "update" action to the API to edit a URL, and a "geturl" action to get the long URL of a short URL
- Append Query String - Appends the query string to a long URL- as is
- Auth Manager - Assign users to roles like "Editor" and "Contributor" to limit the changes they are permitted to make (edit URLs, manage plugins...)
- Auth Manager Plus - Seperates user data & manages authorization with role-based access controls (RBAC)
- Blacklist Domains - A simple plugin to blacklist domains from shortening URLs
- Blacklist IPs - A simple plugin to blacklist IPs from shortening URLs
- Bulk Import and Shorten - Import links from a CSV file
- Bulk URL Shortening - Shortening of multiple URLs with one API request
- cAuth - Client side SSL certificate authentication for admin pages.
- Cache Stat Pages
☑️- Serve stat pages (
http://sho.rt/blah+) from cache
- CAS Plugin - Enable authentication through a CAS server
- Case Insensitive - Makes all keywords case insensitive (creates and calls all keywords lowercase)
- Case Insensitive - Make YOURLS case insensitive: if you create
http://sho.rt/MyLink, then variations like
MYLINKwill redirect to the same URL.
- Change Error Messages - Changes the error message when a keyword or URL already exists and displays the long URL.
- YOURLS GWall Change Logo - Allows you to change the image of the YOURLS logo and its alt and title tags.
- Change Password
☑️- Change your password from within YOURLS instead of editing the config file
- Change Password - Allow users to change their password via the administration interface.
- Check URL - Check if a long URL is reachable before creating a short URL
- API Concurrency Fix - A plugin to resolve concurrency issues with the API as described in Issue 765.
- Compliance - Anti-abuse plugin, designed to address link complaints from 3rd parties.
- Conditional Toolbar
☑️- A plugin to conditionally enable the toolbar:
http://sho.rt/blahfor normal redirect,
http://sho.rt/tb/blahfor a toolbar
- Conditional Advertisements - A plugin to conditionally send links through various link monetizing services:
http://your.site/a/shortredirects through AdFly
- Custom Header & Footer - A plugin administration page to add custom header and footer style and content
- Custom Protocol
☑️- If the user is known, this plugin adds custom protocol (eg
blah://) to authorized protocols, otherwise restricts to
- Disable JSONP - Disables JSONP access for the YOURLS API.
- DNSBL - Uses various DNSBLs to check the submitter's IP and prevent shortening URLs if any malicious activity has been detected.
- Domain Limit - Limit the domains that users can create shortlinks to
- Domain Limiter - Fork of Nic Waller's plugin with the addition of an admin panel to edit the white list from the admin area
- Do TLS - Always use SSL/TLS for a destination url if available
- Don't Log Bots
☑️- Ignore bot hits in your stats (both click count as seen in the main admin page and in detailed stats)
- Don't Log Crawlers - A fork of the
Don't Log Bots, with more bots filtered out.
- Don't Log Health Checker - A fork of
Don't Log Bots, with more bots filtered out.
- Don't Track Admin Clicks - Don't count clicks on short URL if user is logged in
- Edition Logger - Logs to a file every url insertion, deletion, or modification, to provide traceability of users' actions allowing an open edition policy.
- Email Notify - Sends you an email with identifying information whenever someone clicks the link they were sent.
- Enhanced Auth Cookies
☑️- Enhances the cookie based authentication, making each auth cookie name unique and time based.
- Every Click Counts - Click count include multiple clicks for the same client (ie there will be no browser caching of the redirection)
- Expiry - Defines optional conditions under which links will expire, able to set time and click limited links globally or per individual links.
- Fallback URL
☑️- Redirect to a custom URL when the short URL does not exist
☑️- Properly displayed favicon in all cases (home screen on iOS, Android, Chrome, Safari...)
- Filter Code - Allow to select 3XX Status Code to return per keyword
- Fix long URLs - Fix long URLs that contain %20 and other similar encodings
- Force Lowercase
☑️- Force lowercase so
- Fuzzy Keyword Suggestions - Handles typos and other "near-misses" for any shortened link (eg if you have
sho.rt/dh1ikbut someone types
sho.rt/dhlik, the 404 page will show suggestions for similar short URLs)
- GA MP - Track YOURLS link clicks with Google Analytics Measurement protocol in Real Time
- Git Version - Add version information from the git repository into the footer of the admin page
- Geo API - Plugin to look up country code from another 3rd party API (geoiplookup.net)
- GeoShortURL - Plugin to add per-country support to existing short URLs (use it with 302-Instead)
- Google Analytics Link Tagging - Add GA tags (utm_source and others) to your shortened links
- Google Auth - Enables Google Authentication for YOURLS
- Google Analytics YOURLS Plugin - Add your Google Analytics tags to admin and stat pages
- Google Safe Browsing
☑️- Check every new URL against Google's Safe Browsing Lookup service
- GTM for YOURLS - Google Tag Manager for every single click
- hexdec - Changes the sequential keywords from base36 to base16 (ie
- Hide Referrer - Hide referrer on all or some short links
- Hide Version String - Hide the version string in the footer
- HTTP:BL - Prevent spam using the black list from Project Honeypot.
- HTTP Proxy - Get remote content using an HTTP proxy, for instance when YOURLS is running behind a firewall (e.g. corporate intranet)
- HTTP status per link - Plugin to allow you to select
3XXStatus Code to return per keyword.
- HTTP status per link - Select
3XXStatus Code to return per keyword.
- Identi.ca for YOURLS - Share YOURLS links via identi.ca
- YOURLS IDN
☑️- Add IDN support to YOURLS
- Image Placeholder
☑️- Simple image placeholder service for YOURLS
- YOURLS Import Export - A plugin to import and export YOURLS URL
- Integrated QRCodes - Integrated QRCodes is an updated fork of Inline QRCode, but more compact, configurable, and just as efficient with more features.
- iOS URL - Adds support for URLs starting with
- iTunes-Affiliate - Adds your iTunes Affiliate-Token to all iTunes URLs before redirection
- Jappix - Adds a JappixMini chat on your YOURLS admin pages
- JSON Response - Add
.json(or a custom string/character) to the short URL to get info about it as a JSON response.
- Keep Query String - Adds the short URL's query string (if any) to the long URL
- Keywords, Charset & Length - Custom charset, custom link length and random short urls, all in one plugin, with an admin panel.
- Keyword not found - If keyword isn't found in the database, redirect to admin page and pre-populate the short URL field
- Keyword Prefix - Adds a defined prefix to your short URLs
- LDAP - Enables use of LDAP for user authentication.
- Link Anonymizer - Generate a link that will take you to an anonymizer service.
- Link List - List recent links added, in the admin interface or on a public page
- Limit keyword length - This plugin limits the number of characters allowed for the custom keyword.
- Limited Links
☑️-limit the number of redirections of a specific link.
- log-login - Logs login atempts to YOURLS. To be used with fail2ban.
- Login Timeout - Adds a timeout after a certain number of failed logins to mitigate brute force logins.
- Lookup keywords by long URL substring - Add a "lookup-url-substr" action to YOURLS API which searches keywords by long URL substring (implements
url LIKE %substr%SQL operation).
- lowercase username - Makes the username lowercase when logging in.
- Mailto - Adds a "mailto:" sharing option, next to Twitter and Facebook
- Mailto Bookmarklet - Adds a bookmarklet to share links by mail
- Mass Remove Link
⭐- Remove several links at once. Select by date, date range, IP or URL matching.
- Mass Update - Adds an API action to mass update links from
- Memcached - Memcached plugin for YOURLS
- Meta Redirect - Redirect using HTML meta tag when you prepend the short URL with an underscore (eg
- Multi User - Add support for multiple users
- Mobile Detect - Add ability to redirect by user device OS
- No Traking Admins - No loggin clicks for authenticated users (compatible with OIDC).
- OAuth Sign In - Enable OAuth sign in support (using GitLab as an example)
- OIDC - OpenID Connect authentication against a generic OpenID Connect server
- Open Graph Meta Scraper - Get Open Graph (OG) information for your shortened links
- Password Protection - Password protect any Short URL you want so that users are prompted for a password before redirection
- Phishtank - Prevent spam links using Phishtank's API
- Phishtank 2.0 - Functional rewrite of the old Phishtank plugin with more features
- Piwik-YOURLS - Piwik and a few other features
- Popular Clicks - Display the top of the most clicked links during past days
- Popular Clicks Extended - Shows which short links get clicked the most during a specific time frame
- Popular Links - Adds an admin page that displays your shortener's most popular links
- Preview URL
☑️- Add the character '~' to a short URL to display a preview screen before redirection
- Preview URL with QR Code - Add the character '~' to a short URL to display a preview screen & QR code before redirection
- Preview URL with QR Code And Thumbnail - Add the character '~' to a short URL to display a QR code and Thumbnail image before redirection
- Public "Prefix n' Shorten"
http://sho.rt/http://someurl.com/to a public interface instead of the admin area
- YOURLS Pseudonymize - This plugin "pseudonymizes" the IP addresses so that it is in line with the German privacy laws (the last 2 segments/bytes of a visitor's IP address are removed)
- PUNS - A Plugin Update Notification System: provides a report-generating page and an API with optional email notifications.
☑️- Add ".qr" to short URLs to display the shorturl's QR code
- QRCode - Creates and displays QR Codes within YOURLS
- QR Google Charts - Another QR Code plugin, using Google Charts API
- QRCode - Another QR Code plugin. Get the QR code by simply clicking on a button in the Admin area (or by adding ".qr" to the end of the keyword.)
- QueryString Forward - Forward the query string on short link to long URL (eg
- Query String Keeper - Pass the query string from the shortlink to the long URL (eg
- reCaptcha - YOURLS plugin implementing reCaptcha for unauthenticated users in your public interface
- Redirect Index - Redirect the user to another site if they go to the base directory of your YOURLS installation
- Regenerate URL - Regenerate a new keyword for a URL that has already been shortened.
- Remove The Share Function - Remove the Share button and box that toggles the sharing options on the Admin page
- Remove YouTube Play Indicator - Removes the triangle from the title of Youtube shortened URL
- Reset URLs
☑️- Deletes all URLs. For your test install needs.
- Reverse Proxy - Fixes the user IPs to point to the actual user instead of your cloud provider’s infrastructure IPs (Cloudflare, Heroku...)
- rscrub - An "HTTP referrer scrubbing swiss army knife for YOURLS" (evolution of the Hide Referrer plugin)
- Semantic Scuttle - Allows the sharing of the URL to a Semantic Scuttle installation.
- Separate Users - Adds a username to each created URL, and filters the admin interface.
- Shaarli - Allows the sharing of the URL to a Shaarli installation
- Share G+ - Adds Google+ to the Quick Share Box.
- Share LinkedIn - Adds LinkedIn to the Quick Share Box.
- Share with Tumblr
☑️- In the Quick Share box, add a one-click share to Tumblr link.
- Shibboleth - Enable authentication with Shibboleth
- ShortShort - Checks if a URL is already shortened (e.g. t.co, bit.ly, youtu.be) to avoid nested shortened links.
- Show Git Branch
☑️- Using YOURLS on a dev box under Git? Show the current branch in page footer.
- SimpleDB Clickqueue - Queue clicks to Amazon SimpleDB before processing. This allows using a regular MySQL store even in the face of a high frequency of writes, without concern of connection limit overflow. Clicks are inserted later into the database via an import job.
- Skimlinks - Push all links through Skimlinks to automatically embed affiliate codes
- Skip Click Count - Don't count clicks on short URLs
- SMTP Contact - Provides a public contact page using PHPMailer for outbound mail delivery
- Snapshot - Visual preview plugin with image caching powered by PhantomJS.
- YOURLS SQLite
☑️- SQLite driver for YOURLS. It is now considered outdated.
- YOURLS SQLite - A fork of the original SQLite driver for YOURLS, actively maintained.
- Static Titles - Provide two options to avoid the network traffic when retrieving URL titles.
- SSL for SSL - Generates SSL short links if the original link was SSL.
- Swap Short URL - A plugin to have
http://sho.rt/blahwhile having YOURLS installed in
- Telegram Quickshare - Quickly share a shortened URL via Telegram Messenger.
- Title Refetch - Refetch page titles
☑️- Tell YOURLS your time zone and how you'd like times and dates displayed
- Thumbnail URL image - Get the Thumbnail URL image (long URL) by adding
.ito the end of the keyword
- Time-Period Clicks - A simple API plugin for reporting URL clicks in a specific time period (e.g. the last week, January 1 - February 1, etc).
- Time Limit Link - Set a time limit for links
- Track Custom Keyword - Add a new field to YOURLS designed to track if a keyword was randomly assigned or manually specified
- Typer, a yourls prank plugin - Add an underscore * to your shortlink and the user will be shown a page where they have to type the shortlink themselves.
- Upload and Shorten - Upload and share files with YOURLS
- U-SRV - Provides secure links to files while obfuscating filesystem paths, allowing easy, secure access to files between plugins or from 3rd party scripts. Manual uploading of files is supported.
- Update 30X - An API plugin to test single, domain based, or all available links and update the URL in YOURLS if redirection occures at the destination.
- URL Health Check - Checks submitted URLs for validity, reachability, and redirection. In the case of redirection, the final destination URL will be stored avoiding nested redirects.
- wallabag - Allows the sharing of the URL to a Wallabag installation (previously named Poche)
- Whatsapp quickshare - Allows you to share your short URL via whatsapp
- Word Based Short URLs
☑️- Generate short URLs with adjectives and nouns, like
- YAPCache - YAPCache is an APC based cache designed to reduce the database load of YOURLS and increase performance
- YOURS-TN - Display thumbnails on YOURLS admin page and stats page, using thumbnail.ws
- YouTube Title Fix - Fetch YouTube page titles via Google API
This will be the next big thing when YOURLS fully support theming
- ∞² - Infinity Squared, a beautiful public page theme for YOURLS
- Air 66 - A responsive admin theme for YOURLS
- Sleeky - A sleek and simple frontend & backend theme for YOURLS with light and dark modes
YOURLS supports localization: this means if a language file for YOURLS in available in your language, YOURLS will speak your language!
- Brazilian: here and here (
- Bulgarian (
- Czech (
- Danish (
- Dutch (
- Farsi (
- Finnish (
- French (
- German (
- Hindi (
- Indonesian (
- Italian (
- Japanese (
- Korean (
- Norwegian (bokmål) (
- Polish (
- Portuguese (
- Russian (
- Simplified Chinese (
- Slovak (
- Spanish (
- Telugu (
- Turkish (
- Traditional Chinese (
- Viet Nam (
Make YOURLS work with other platforms, programming languages or tools
- Drupal - YOURLS for Drupal. Requires the title-refetch and API Concurrency Fix plugins to be installed in YOURLS. See this Drupal issue for details.
- CakePHP - Plugin to integrate YOURLS
- FreeBSD Freshport - a FreeBSD package
- Ruby - A Ruby wrapper for the YOURLS API
- Python 3 - A Python client for YOURLS, built for Python 3
- Python 2 - Alternative Python 2 client for YOURLS
- status.net - Plugin for status.net to use YOURLS
- VB .Net - A VB .Net 4.0 wrapper for the YOURLS API
- YOURLS API for nodejs
- Gnome Desktop - Gnome Shell extension to shorten links in the clipboard
- Telegram bot - A Telegram bot to shorten links
- aYourls - A dedicated app for YOURLS supporting server-side deletion (needs API Delete)
- URL Shortener - Supports various shortener, including YOURLS
- iC-YOURLS - A simple YOURLS app for Android, supports receiving links from other apps
- AutoAffiliate - Automatically convert someone's affiliate link to your affiliate link
- YOURLS on Windows - Run YOURLS as a Windows program
- Installing YOURLS on a Plesk-Hosted Domain
- How to Install YOURLS using Softaculous
- How to Install YOURLS on a VPS or shared hosting
- YOURLS on Azure
- YOURLS on Cloudron
- YOURLS on Installatron
- YOURLS on Fedora
- Guides for Ubuntu :
- http://oe.cd/ - Europe OECD's internal URL shortener with a neat interface and private features
- https://kiwi.gg/ - A sexy shortener home page with stats and details
- https://u.nu/ - Very neat public interface and their own command line tool
- http://yourwish.es/ - Easily share an Amazon wishlist
- http://vbly.us - YOURLS early adopter, once taken down by Libya! (story)
- Early review on Lifehacker
- http://mclrn.co/ by McLaren Cars
- http://smashed.by/ by Smashing Magazine
- http://cuny.is/ by the City University of New York
- http://dhurl.org/ by Dreamhost
YOURLS has also been used by the NASA, Virgin and Epic Games. Sweet :)
Contributions welcome! Read the contribution guidelines first.