Official Readme
YOURLS is a set of PHP scripts that will allow you to run Your Own URL Shortener. Features include password protection, URL customization, bookmarklets, statistics, API, plugins, jsonp. (Source Code) MIT PHP
🎉 A curated list of awesome things related to YOURLS
This page lists names, links and short descriptions. The original list on GitHub is the source and belongs to its authors.
YOURLS is a set of PHP scripts that will allow you to run Your Own URL Shortener. Features include password protection, URL customization, bookmarklets, statistics, API, plugins, jsonp. (Source Code) MIT PHP
🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP
Adds 2FA support to YOURLS.
Send a 302 (temporary) redirect instead of 301 (permanent), for sites where shortlinks may change.
A fork of previous plugin, with some more options.
Send a 308 (permanent) redirect instead of 301 (permanent) so the HTTP method is preserved (forked from EpicPilgrim's 302-Instead)
☑️ - Give a 404 Not Found if the short URL is not found.
AAF Rapid Connect authentication plugin for YOURLS.
A Google Safe Browsing implementation for YOURLS to avoid spam links.
Prevents CORS issue with domain CNAMES and aliases for admin actions.
Define additional character sets for short URLs.
Collects YOURLS environmentals and formats a template to copy/paste into a YOURLS issue.
Protect logins with Google's No CAPTCHA reCAPTCHA (Google's ReCAPTCHA v2.0).
Spam protection for private YOURLS admin interface with reCaptcha.
Protect Admin login with reCaptcha v3.
Protect Admin login with Cloudflare Turnstile!
Implements Cloudflare Turnstile on the admin login form for added protection.
Extends the reserved word functionality, blocking short URLs containing reserved words, even if mixed case or written in leetspeak.
Allow YOURLS to work with alias hostnames for the server.
Have YOURLs return success when shortening an existing URL with YOURLS_UNIQUE_URLS=true.
☑️ - Allow colon (:) in short URLs (https://sho.rt/abc:def).
Transform the unused YOURLS root page into a Linktree-style profile page with social links and custom branding.
A newer alternative to 302-Instead.
Adds your Amazon Affiliate Tag to all Amazon URLs before redirection.
Adds your Amazon Affiliate Tag to all Amazon URLs before redirection with a notice of Amazon Affiliate link usage.
Anonymise the log data that YOURLS captures.
☑️ - Antispam plugin using the major DNS blacklists.
Add support for APC to reduce MySQL queries.
☑️ - Example plugin for YOURLS 1.6+ to show how to implement custom API actions.
API action opposite to "expand": check if a URL has been shortened before
Add a "delete" action to the API.
Add an "update" action to the API to edit a URL, and a "geturl" action to get the long URL of a short URL.
Add a "list" action to the API to show all keywords.
Add a "list" action to the API to show all keywords & URLs. This is a fork of the previous plugin and therefore incompatible with it.
Add a "list" action to the API with advanced options, such as shorting, pagination and field selection.
Add a "shorturl_analytics" action to the API to get the statistics of a specific shortURL in a range of dates.
Appends the query string to a long URL.
Seperates user data & manages authorization with role-based access controls (RBAC).
☑️ - Automatically populate login/password with test/test (for test installs).
Set link expiry and automatically delete expired links.
Automatically adds Awin affiliate parameters to URLs from configured merchants.
Batch generation of short URLs.
Rewrite short URLs such that they point to alternative (base) URLs.
A simple plugin to blacklist domains from shortening URLs.
A better plugin to blacklist domains from shortening URLs.
A simple plugin to blacklist IPs from shortening URLs.
A simple plugin to blacklist User-Agent from shortening URLs.
Blocks access to the details page when not logged in.
Semi-automatically audits links already in your database and banishes the broken ones.
Import links from a CSV file.
Shortening of multiple URLs with one API request.
Client side SSL certificate authentication for admin pages.
☑️ - Serve stat pages (http://sho.rt/blah+) from cache.
☑️ - Send no-cache headers with shorturl redirects.
Fixes the lowercase "i" in "Admin interface" to avoid inconsistencies.
Enable authentication through a CAS server.
Makes all keywords case insensitive (creates and calls all keywords lowercase).
Make YOURLS case insensitive: if you create http://sho.rt/MyLink, then variations like mylink or MYLINK will redirect to the same URL.
Makes YOURLS case insensitive, for 1.9+.
Changes the error message when a keyword or URL already exists and displays the long URL.
Stay informed about every change to your YOURLS short URLs with instant email notifications.
☑️ - Change your password from within YOURLS instead of editing the config file.
Allow users to change their password via the administration interface.
Check if a long URL is reachable before creating a short URL.
Anti-abuse plugin, designed to address link complaints from 3rd parties.
☑️ - A plugin to conditionally enable the toolbar: http://sho.rt/blah for normal redirect, http://sho.rt/tb/blah for a toolbar.
A plugin to conditionally send links through various link monetizing services: http://your.site/short is normal, http://your.site/a/short redirects through AdFly.
A plugin that forks Conditional URLAds, but it's more elegant and convenient in terms of setting parameters, For example, directly within a WebPage.
Custom error page for unknown short URLs.
This plugin allows the addition of a custom header to the generated URL, enabling compliance with specific regulatory requirements in certain countries, such as India, for bulk SMS services.
🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP
Add configurable custom fields to short links and receive customisable webhook notifications when clicked.
☑️ - If the user is known, this plugin adds custom protocol (eg blah://) to authorized protocols, otherwise restricts to http|s.
Contains a one-click utility to reset auto increment and synchronize click counts.
Manage your YOURLs users in the admin menu instead of the config file! Allows users to set their own password. Create admin users that can reset passwords and create other users.
☑️ - Simple plugin to view all options stored in the DB.
Display charts showcasing information about browsers, platforms, and devices used by visitors.
Display click details, including IP/location, device information, user-agent, and more.
Disables JSONP access for the YOURLS API.
Restrict shortening to an allowlist of domains, with an admin page (one-click-allow rejected domains) and throttled Telegram alerts. No extra DB table, no cron.
Limit the domains that users can create shortlinks to.
Fork of Nic Waller's plugin with the addition of an admin panel to edit the white list from the admin area.
Always use SSL/TLS for a destination url if available.
☑️ - Ignore bot hits in your stats (both click count as seen in the main admin page and in detailed stats).
A fork of Don't Log Bots, with more bots filtered out.
☑️🧪 - Don't count clicks on short URL if user is logged in.
Allows you to directly download or delete other plugins from the admin panel.
Download and install YOURLS plugins from the admin panel.
Logs to a file every url insertion, deletion, or modification, to provide traceability of users' actions allowing an open edition policy.
Create an emoji-only short link, like http://sho.rt/✨ or http://sho.rt/😎🆒🔗
☑️ - Enhances the cookie based authentication, making each auth cookie name unique and time based.
Click count include multiple clicks for the same client (ie there will be no browser caching of the redirection).
Defines optional conditions under which links will expire, able to set time and click limited links globally or per individual links.
Redirect to a custom URL when the short URL does not exist.
Plugin to create cool short URLS like https://sho.rt/SwiftCrimsonBullfrog
Plugin to create cool short URLS like https://sho.rt/QuirkyHisuianNuzleaf
☑️ - Properly displayed favicon in all cases (home screen on iOS, Android, Chrome, Safari...).
Allow to select 3XX Status Code to return per keyword.
Fix long URLs that contain %20 and other similar encodings.
☑️ - Get correct video title, not "Before you continue to YouTube"
☑️ - Force lowercase so http://sho.rt/ABC → http://sho.rt/abc.
Forwards query params to the destination URL. Can exclude params by domain.
Handles typos and other "near-misses" for any shortened link (eg if you have sho.rt/dh1ik but someone types sho.rt/dhlik, the 404 page will show suggestions for similar short URLs).
Link-in-bio page served directly by YOURLS. Manage sections, links, profile and custom icons from the admin panel. Includes branded redirect interstitial with OG metadata, custom 404 page, and full subdirectory support.
Track YOURLS link clicks with Google Analytics Measurement protocol in Real Time.
Shows a customizable QR code generator upon link generation and afterwards.
Plugin to look up country code from another 3rd party API (geoiplookup.net).
☑️ - Update the GeoIP database
Plugin to add per-country support to existing short URLs (use it with 302-Instead).
Add version information from the git repository into the footer of the admin page.
Add GA tags (utm_source and others) to your shortened links.
Enables Google Authentication for YOURLS.
☑️ - Check every new URL against Google's Safe Browsing Lookup service.
Google Tag Manager for every single click.
Changes the sequential keywords from base36 to base16 (ie [0-9a-f]).
Hide referrer on all or some short links.
🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP
☑️ - Experimental plugin for YOURLS installs with high volume of data (millions of links).
Prevent spam using the black list from Project Honeypot.
Get remote content using an HTTP proxy, for instance when YOURLS is running behind a firewall (e.g. corporate intranet).
Select 3XX Status Code to return per keyword.
☑️ - Add IDN support to YOURLS.
☑️ - Simple image placeholder service for YOURLS.
A plugin to import and export YOURLS URL.
Integrated QRCodes is an updated fork of Inline QRCode, but more compact, configurable, and just as efficient with more features.
☑️ - Insert fake links (for test installs)
Adds support for URLs starting with itms-apps:// and itms-services://.
Adds your iTunes Affiliate-Token to all iTunes URLs before redirection.
A multi-language switching system for YOURLS
Adds a JappixMini chat on your YOURLS admin pages.
Add .json (or a custom string/character) to the short URL to get info about it as a JSON response.
Adds the short URL's query string (if any) to the long URL.
Custom charset, custom link length and random short urls, all in one plugin, with an admin panel.
Add several conditions to check whether submitted keyword is allowed or not.
If keyword isn't found in the database, redirect to admin page and pre-populate the short URL field.
Adds a defined prefix to your short URLs.
Switch the YOURLS admin interface language from the Plugins page, without editing config.php.
Enables use of LDAP for user authentication.
Generate a link that will take you to an anonymizer service.
Generate a personal landing page with a Linktree-style link list, an Instagram-style image grid, and an About-me block with social-media icons.
List recent links added, in the admin interface or on a public page.
This plugin limits the minimum and maximum number of characters for custom keyword.
This plugin limits the number of characters allowed for the custom keyword.
☑️ -limit the number of redirections of a specific link.
Logs login atempts to YOURLS. To be used with fail2ban.
Adds a timeout after a certain number of failed logins to mitigate brute force logins.
Customize the YOURLS admin panel with your own logo and title.
Add a "lookup-url-substr" action to YOURLS API which searches keywords by long URL substring (implements url LIKE %substr% SQL operation).
Makes the username lowercase when logging in.
Adds a "mailto:" sharing option, next to Twitter and Facebook.
Adds a bookmarklet to share links by mail.
Manage allowed URL protocols in the admin panel.
☑️ - Uses a Master/Slave DB setup
☑️ - Remove several links at once. Select by date, date range, IP or URL matching.
Adds an API action to mass update links from old_domain to new_domain.
Provide backwards compatibility for those still using md5 in their passwordless API calls.
Memcached plugin for YOURLS.
Redirect using HTML meta tag when you prepend the short URL with an underscore (eg http://sho.rt/_bleh).
Add ability to redirect by user device OS.
Click log viewer with GeoLite2 and user agent parsing.
No loggin clicks for authenticated users (compatible with OIDC).
🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP
Create and share text or Markdown notes as short URLs, with inline editing, search integration, and click tracking.
Sends notifications when actions occurs, like creating a new shortened url.
Enable OAuth sign in support (using GitLab as an example).
OpenID Connect authentication against a generic OpenID Connect server.
Get Open Graph (OG) information for your shortened links.
Enables to allow and block (original) URLs not just with domain names like related plugins, but with regular expressions for more precise policies.
Protect URL creation on your public interface with a Time-based One-Time Password (TOTP)
Password protect any Short URL you want so that users are prompted for a password before redirection.
A Google Safe Browsing implementation for YOURLS to avoid spam links.
Functional rewrite of the old Phishtank plugin with more features.
Piwik and a few other features.
Install, update and manage YOURLS plugins directly from the admin interface.
Adds API action to list enabled plugins and their status with filtering and health checks.
Display the top of the most clicked links during past days.
Shows which short links get clicked the most during a specific time frame.
Adds an admin page that displays your shortener's most popular links.
☑️ 🧪 - Add support for PostgreSQL.
☑️ - Add the character '~' to a short URL to display a preview screen before redirection.
Add the character '~' to a short URL to display a preview screen & QR code before redirection.
Add the character '~' to a short URL to display a QR code and Thumbnail image before redirection.
Automatically delete old links with no recent clicks.
☑️ - Redirect http://sho.rt/http://someurl.com/ to a public interface instead of the admin area.
Cloudflare Turnstile protected public shortener homepage.
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).
A Plugin Update Notification System: provides a report-generating page and an API with optional email notifications.
A Plugin that allows you to purges all YOURLS logs
☑️ - Add ".qr" to short URLs to display the shorturl's QR code.
Creates and displays QR Codes within YOURLS.
Another QR Code plugin, using Google Charts API.
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).
Add ".qr" to short URLs to display the shorturl's QR code in SVG, PDF, PNG or JPG (local generation with JS).
QR Code plugin, using Quickchart. Combatible with a self-hosted Quickchart instance. Default suffix /qr.
Forward the query string on short link to long URL (eg http://sho.rt/kk?a=1 to http://long.url/somepage/?a=1).
Pass the query string from the shortlink to the long URL (eg http://sho.rt/kk?hey forwards to http://long.url/bleh/?hey).
Pass the query string from the shortlink to the long URL (tested on YOURLS version 1.8.3 and php version 8.0.12).
Redirects specific keywords to randomly selected URLs from predefined lists with customizable probability weights.
YOURLS plugin implementing reCaptcha for unauthenticated users in your public interface.
Redirect the user to another site if they go to the base directory of your YOURLS installation.
Redirect based on User-Agent, all blacklisted user agents won't be redirected to target URL but instead shown a custom page.
Referer is used to restrict access from which domain names are allowed.
Regenerate a new keyword for a URL that has already been shortened.
Remove the Share button and box that toggles the sharing options on the Admin page.
Removes the triangle from the title of Youtube shortened URL.
Replace URL or tokens in URL based on keyword, regex pattern matching, or script.
☑️ - Deletes all URLs. For your test install needs.
Fixes the user IPs to point to the actual user instead of your cloud provider’s infrastructure IPs (Cloudflare, Heroku...).
An "HTTP referrer scrubbing swiss army knife for YOURLS" (evolution of the Hide Referrer plugin).
A security reminder is displayed before redirecting long links, and custom ads can be inserted on the reminder page.
Sign in via SAML-based single sign-on.
API action to update the long URL of an existing keyword, or creates a new short URL.
Allows the sharing of the URL to a Semantic Scuttle installation.
Adds a username to each created URL, and filters the admin interface.
Allows the sharing of the URL to a Shaarli installation.
Upload and share files with YOURLS.
Adds LinkedIn to the Quick Share Box.
Lets you fully customize the Quick Share Box. (Also supports QR Codes, Custom links and disabling the Share Box enitely)
☑️ - In the Quick Share box, add a one-click share to Tumblr link.
Enable authentication with Shibboleth.
Checks if a URL is already shortened (e.g. t.co, bit.ly, youtu.be) to avoid nested shortened links.
☑️ - Using YOURLS on a dev box under Git? Show the current branch in page footer.
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.
Push all links through Skimlinks to automatically embed affiliate codes.
Don't count clicks on short URLs.
Send a notification to a Slack channel whenever a new short URL is created.
Provides a public contact page using PHPMailer for outbound mail delivery.
Visual preview plugin with image caching powered by PhantomJS.
☑️ - SQLite driver for YOURLS. It is now considered outdated.
A fork of the original SQLite driver for YOURLS, actively maintained.
Provide two options to avoid the network traffic when retrieving URL titles.
Generates SSL short links if the original link was SSL.
A plugin to have http://sho.rt/blah while having YOURLS installed in http://sho.rt/yourls/
Get a notification via Telegram whenever a new shortlink is created.
Quickly share a shortened URL via Telegram Messenger.
Refetch page titles.
☑️ - Tell YOURLS your time zone and how you'd like times and dates displayed.
Get the Thumbnail URL image (long URL) by adding .i to the end of the keyword.
A simple API plugin for reporting URL clicks in a specific time period (e.g. the last week, January 1 - February 1, etc).
Set a time limit for links.
Add a new field to YOURLS designed to track if a keyword was randomly assigned or manually specified.
Extended click analytics with device, browser, language and UTM campaign data, bot filtering, and downloadable CSV, JSON and PDF reports. Interface available in Spanish (default) and English.
Add an underscore * to your shortlink and the user will be shown a page where they have to type the shortlink themselves.
The most advanced and feature-rich redirect plugin for YOURLS with customizable ads, countdown timer, and comprehensive analytics.
Upload and share files with YOURLS.
Enhanced version with advanced file management, multiple storage locations, expiration settings, frontend uploads, CSRF protection, and comprehensive admin interface.
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.
An API plugin to test single, domain based, or all available links and update the URL in YOURLS if redirection occures at the destination.
Redirect visitors to a configurable fallback URL when they hit a non-existent short URL or the YOURLS root page.
Checks submitted URLs for validity, reachability, and redirection. In the case of redirection, the final destination URL will be stored avoiding nested redirects.
Reads users from a database table instead of a config file. Currently does not provide an interface for adding/editing users though.
Allows the sharing of the URL to a Wallabag installation (previously named Poche).
Sends a JSON POST webhook notification when a new link is created.
Allows you to share your short URL via whatsapp.
Allows you to brand YOURLS with your own custom logo, fonts and title.
Adds login audit logs, automatic IP and user lockouts, allowlists and blocklists, plus optional per-user TOTP two-factor authentication.
☑️ - Generate short URLs with adjectives and nouns, like http://sho.rt/FluffyArrogantUnicorn.
🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP
Prevent spam/phishing links using ipqualityscore's API. Fork of Phishtank-2.0 (+some extra features)
YAPCache is an APC based cache designed to reduce the database load of YOURLS and increase performance.
Role-Based Access Control: database-backed users, roles and permissions with a full admin UI, replacing the single-user config.php login.
Display thumbnails on YOURLS admin page and stats page, using thumbnail.ws.
Fetch YouTube page titles via Google API.
Infinity Squared, a beautiful public page theme for YOURLS.
A responsive admin theme for YOURLS.
A sleek and simple frontend & backend theme for YOURLS with light and dark modes.
A simple React based frontend for YOURLS.
A UI Kit 3 based restyling of Yourls to bring it a nice modern feel in 2026.
(bg_BG)
(ca_ES)
(cs_CZ)
(da_DK)
(nl_NL)
(en_AU)
(fa_IR)
(fi_FI)
(fr_FR)
(de_DE)
(de_CH)
(hi_IN)
(id_ID)
(it_IT)
(ja_JP)
(ko_KR)
(nb_NO)
(pl_PL)
(pt_PT)
(ru_RU)
(zh_CN)
(sk_SK)
(es_ES)
(te_IN)
(tr_TR)
(zh_TW)
(uk)
a simple BASH script to shorten URLs with YOURLS.
a advanced BASH script to shorten URLs with YOURLS.
A simple bash script to shorten URLs using the YOURLS API with diffent path config.
Plugin to integrate YOURLS.
a YOURLS image with several integrated plugins.
YOURLS for Drupal.
a FreeBSD package.
Gnome Shell extension to shorten links in the clipboard.
Populate a YOURLS database via GitHub Actions.
JavaScript bindings to leverage JSONP support.
A Perl module to shorten URLs using YOURLS.
Amazon affiliate management.
Integration of YOURLS with a PrivateBin instance.
A Prometheus exporter to monitor a YOURLS instance.
A Python client for YOURLS, built for Python 3.
Alternative Python 2 client for YOURLS.
pip install yourls for Python 2 or 3
A Ruby wrapper for the YOURLS API.
Plugin for status.net to use YOURLS.
A Telegram bot to shorten links.
Open source code base for hosting your own Telegram bot to shorten links via your own YOURLS instance. Includes access control by default, so suitable for non-public YOURLS instances.
A VB .Net 4.0 wrapper for the YOURLS API.
Fetch and display YOURLS links and a QR code in a widget.
Model Control Protocol (MCP) server for YOURLS URL shortening and information.
Create a minimal patch package to update your YOURLS installation without downloading and uploading the full release ZIP.
A dedicated app for YOURLS supporting server-side deletion (needs API Delete).
A simple YOURLS app for Android, supports receiving links from other apps.
An elegant YOURLS client for iPhone.
YOURLS support requires a one-time in-app purchase of about $2 USD (See also: Setup instructions).
Available for $6 from the App Store or directly from the developer (See also: Setup instructions).
System tray app to automatically shorten clipboard links for Windows and Linux (x11/Wayland).
Run YOURLS as a Windows program.
a video presentation that includes API examples with Keyboard Maestro
a collection of scripts and a how-to guide for migrating your data
The OECD's internal URL shortener with a neat interface and private features.
Very neat public interface using Sleeky theme. Also a neat domain hack :)
Easily share an Amazon wishlist.
by McLaren Cars.
by Smashing Magazine.
by the City University of New York.
by Dreamhost.
by the Raspberry Pi Foundation.
veggiemonk/awesome-docker
:whale: A curated list of Docker resources and projects
chentsulin/awesome-graphql
Awesome list of GraphQL
ramitsurana/awesome-kubernetes
A curated list for awesome kubernetes sources :ship::tada:
wilsonfreitas/awesome-quant
A curated list of insanely awesome libraries, packages and resources for Quants (Quantitative Finance)
wsvincent/awesome-django
A curated list of awesome things related to Django
shuaibiyy/awesome-tf
Curated list of resources on HashiCorp's Terraform and OpenTofu