This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



This widget lets you embed your YOURLS installation (or someone else’s through API) to have a short URL service into your sidebar.
It’s pretty simple as for now and it does its work.

I will implement more options as inserting the password directly into the widget options menu (instead of via text-editor) in a few days. If you are using a passworded admin menu you have to edit yourls-widget-config.php. Further info in FAQ section.


  1. Upload the folder yourls-widget (keep the name intact) to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add the widget to your sidebar via the Appearance/Widgets menu.
  4. Insert the URL to the API into the widget options. Example:
  5. If the YOURLS installation is in “private” configuration (with password to access admin) you have to enter the username and password in the yourls-widget-config.php file. Further info in FAQ section.


The widget gives an “Invalid username or password” notice/ I have a private configuration of YOURLS (admin access needs password).

This happens because your YOURLS installation is private configuration.
To fix this you have to edit the yourls-widget-config.php and add user and password in the fields.

Example with username “user and password “password:


Let any website use my API even if I have password protected admin

To do this you have to edit your YOURLS API (yourls-api.php) and remove these lines:

This will disable the password protection on the API, but will keep your admin menu passworded.

Contributors & Developers

“YOURLS Widget” is open source software. The following people have contributed to this plugin.


Translate “YOURLS Widget” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



Fixed a mistake in the code not making jQuery work.


  • First simple yet stable release.