Smol Links


A WordPress dashboard interface for managing a self-hosted Shlink URL shortener instance.

  • Create and edit Shlinks short links from a manager interface
  • Optionally generate new short URLs upon saving new posts
  • Manage multiple short URL domains, with an assigned default
  • Automatically tag each short link, configurable with a filter hook
  • Customize long URLs automatically using a filter hook (e.g., to add query arguments)
  • Integrates with WordPress Sentry plugin, if installed

Filter hooks

  • smol_links_tags – assigns tags to each saved short link (default: ["smol-links-server:$hostname", "smol-links-user:$username"])
  • smol_links_long_url – automatically adjust the long URL redirect
  • smol_links_manager_tabs – customizes the manager tabs (array: [«Tab label» => [Shlink API query]])

Developer setup

Developer dependencies:

Build and start:


Running tests:

docker compose exec web composer --working-dir="/var/www/html/wp-content/plugins/smol-links" test


  • Create and manage Shlink short links from WordPress.
  • Configure your self-hosted Shlink server and optionally generate a short URL whenever a post is published.
  • The post editor includes the short URL in the sidebar.


  1. Upload smol-links folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Configure the Smol Links settings from your WordPress dashboard


There are no reviews for this plugin.

Contributors & Developers

“Smol Links” is open source software. The following people have contributed to this plugin.


Translate “Smol Links” into your language.

Interested in development?

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



  • Validate and sanitize settings


  • Add search to manager interface
  • URL validation on form inputs


  • Remove Composer from installation


  • Add pagination to Smol Links manager interface


  • Update to Shlink v3 API


  • Fix a bug with the Short Links manager
  • Upgrade dependencies


  • Release to WordPress plugin directory
  • Security improvements


  • Generate short URLs upon saving a post
  • Create/edit short URLs from a manager