Your Own URL Shortener - the 𝑑𝑒 𝑓𝑎𝑐𝑡𝑜 standard self hosted URL shortener in PHP 🔗
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
yourls-bot[bot] f1ae0efd7a
Update GeoIP DB (#3571)
5 days ago
.github Bump shivammathur/setup-php from 2.25.1 to 2.25.2 2 weeks ago
admin Fixes bookmarklets with URL containing special chars (#3527) 3 months ago
css SVG icons (#2822) 2 years ago
images Fix SVG for IE 11 (#2864) 2 years ago
includes Update GeoIP DB (#3571) 5 days ago
js When adding URLs, new HTML rows should have unique HTML IDs. (#3431) 8 months ago
tests Use sandbox for all included files (#3478) 4 months ago
user No hyphen in random keywords (#3353) 1 year ago
.editorconfig Fix that fucking encoding problem (#2690) 3 years ago
.gitattributes Mark vendor files as generated 1 year ago
.gitignore Add nonce to the logout link (#3264) 1 year ago Update CHANGELOG 3 months ago
LICENSE license meta tweaks 6 years ago Promote (#3291) 1 year ago
composer.json List required/suggested PHP extensions in composer.json (#3339) 1 year ago
composer.lock Bump dependencies 5 months ago
phpunit.xml.dist Revert 3090 & fix tests (#3188) 1 year ago
readme.html Promote (#3291) 1 year ago
sample-public-api.txt Fix end of line 10 years ago
sample-public-front-page.txt Typofixes 8 months ago
sample-remote-api-call.txt Smarter domain convention in examples and source 8 years ago
sample-robots.txt Move /pages into /user (#2648) 3 years ago
yourls-api.php Add jsonp parameter in API as a fallback to match documentation (#2567) 4 years ago
yourls-go.php Smarter keyword sanitization (#2682) 3 years ago
yourls-infos.php Explicitely exit after redirection where needed (#3257) 1 year ago
yourls-loader.php Fix that fucking encoding problem (#2690) 3 years ago


Your Own URL Shortener

CI Scrutinizer Code Quality PHP Version Support Packagist OpenCollective OpenCollective

YOURLS is a set of PHP scripts that will allow you to run Your Own URL Shortener, on your server. You'll have full control over your data, detailed stats, analytics, plugins, and more. It's free and open-source.

Quick Start


  • Download the latest release
  • Using Composer? You can simply composer create-project yourls/yourls . in an empty directory.

Install YOURLS:

  • Read for starters
  • The complete documentation is on and contains everything from beginners to experts.

Community news, tips and tricks


Feature suggestion? Bug to report?

Before opening any issue, please search for existing issues (open and closed) and read the Contributing Guidelines.


Do you use and enjoy YOURLS? Become a backer and show your support to our open source project.


Does your company use YOURLS? Ask your manager or marketing team if your company would be interested in supporting our project. Your company logo will show here. Help support our open-source development efforts by becoming a sponsor.


Free software. Do whatever the hell you want with it.
YOURLS is released under the MIT license.