Help

1. Open the page in Safari, or any app that can share a link.
2. Tap the Share button.
3. Choose Slug. Your short link is created right away.

Add a Slug widget to your Home Screen to open your most recent links with a tap, or to create a new link without opening the app.

Slug can connect to several YOURLS installations, which helps when you manage links for different projects or clients.

1. Download Slug from the Mac App Store.
2. Open Slug from your Applications folder.
3. Connect your YOURLS server with the same endpoint and signature token you use on iPhone.

Links you create or edit on your Mac sync with your YOURLS server. If a recent change doesn’t appear, refresh or reopen Slug and make sure your Mac is online.

Use the QR code tools for links you share in person, in presentations, or in print. Each code is generated from the selected short link.

• If Slug can’t connect, check your YOURLS hostname, signature token, and the server’s SSL certificate.
• If links don’t refresh, confirm your Mac is online and your YOURLS admin panel opens in a browser.
• If sharing doesn’t work, restart Slug and check any macOS privacy or extension permissions it asks for.
• If the app doesn’t open after installing, update macOS and reinstall Slug from the Mac App Store.

A clean hostname like short.yourdomain.com works best, though Slug also accepts full URLs, protocols, and common YOURLS API paths. Double-check the signature token, too.

In your YOURLS admin panel, open Tools and copy the signature token. That’s the API key Slug asks for.

Open Slug at least once after installing so iOS grants it the permissions it needs, then try the Share Sheet again.

This is a known iOS issue. Restart your device and the new icon should appear.