RoutingUXstable · v1.1.3★ 0released Jun 4, 2026
URL Fallback
Redirect visitors to a fallback URL when a short URL does not exist.
Overview
URL Fallback catches clicks on non-existing short URLs and visits to the YOURLS root, sending the user to a configurable page. Useful to avoid 404s, recover traffic and handle migrations.
Key features
- ●Configurable fallback for missing short URLs.
- ●Custom redirect for the YOURLS root page.
- ●Recover traffic that would otherwise be lost on 404 pages.
- ●Simple admin configuration.
Quick install
1cd user/plugins
2git clone https://github.com/gioxx/YOURLS-URLFallback
3# Set the fallback URL from the plugin panel
YOURLS min1.7.9+
PHP compat7.4 / 8.x
If YOURLS doesn't have write permissions on the plugins directory, Plugin Manager will show an error like “Automatic installation is not possible because YOURLS cannot write to …/user/plugins”. In that case you can install manually over SSH — run these commands inside your plugins directory:
SSH
1wget -O YOURLS-URLFallback-1.1.3.zip "https://api.github.com/repos/gioxx/YOURLS-URLFallback/zipball/1.1.3"
2unzip YOURLS-URLFallback-1.1.3.zip
3rm -rf YOURLS-URLFallback/
4mv gioxx-YOURLS-URLFallback-*/ YOURLS-URLFallback/
5rm YOURLS-URLFallback-1.1.3.zip
Alternatively, download the ZIP above, extract it locally and upload the folder via FTP/SFTP.
Changelog
What's changed
- Boot function consolidation: the two separate
plugins_loadedhooks (textdomain + page registration) have been merged into a singleurl_fallback_boot()function. The textdomain is now guaranteed to load beforeyourls_register_plugin_page(), so the plugin's menu label is correctly translated on first activation. - Update-check caching: the GitHub API is now called at most once every 24 hours. Only
checked_at,latest_version, andrelease_urlare persisted;update_availableis recalculated at runtime so the banner clears immediately after updating the plugin. - Italian translation (it_IT): full coverage of all 29 translatable strings. The plugin menu link shows "URL alternativo" in Italian; the page title and footer retain the brand name "URL Fallback".