Quickstart
You'll have a working short link and a QR code in about five minutes. By the end of this page you'll have:
- Signed up for a LinkSnap workspace.
- Shortened your first URL.
- Generated a QR code that resolves to it.
If you'd rather read about concepts first, jump to Concepts. If you'd rather install the SDK or CLI first, see Installation.
Prerequisites
You'll need:
- A working email address — we use Huudis SSO for sign-in, and verifying an email is part of sign-up.
- About five minutes.
- A browser. Everything in this page is portal-driven; the SDK/CLI walkthroughs come later.
You do not need a custom domain for this Quickstart. Short links will resolve from the default lksn.app shortener domain.
1. Sign up
Head to linksnap.com and click Get started. We use Huudis as our identity provider — you'll create one Huudis account and use it across every Forjio product (LinkSnap, Plugipay, Storlaunch, Fulkruma, and the rest).
Sign-up takes two clicks:
- Enter your email and choose a password.
- Click the verification link we send you.
If you'd rather sign up with Google or Apple, those buttons appear on the sign-up screen too — they're only shown when the corresponding provider is configured on the Huudis instance.
Once you're verified, you land in your first workspace's dashboard.
Workspaces are how LinkSnap isolates data. You get one workspace by default, and you can create more for different brands, products, or environments. Each workspace has its own links, QR codes, tags, domains, and API keys.
2. Shorten your first URL
In the dashboard, click New link (top-right). You'll see a form with three useful fields:
- Destination URL — the long URL you want to shorten. Required.
- Custom slug (optional) — the short part after the domain (e.g.
promobecomeslksn.app/promo). If you leave it blank we generate a six-character random slug. - Tags (optional) — comma-separated labels. Useful for organizing later.
Click Create. You're returned to the links list with your new entry on top. Copy the short URL from the link's row.
That's it — the short URL is live. Visit it in another tab to confirm.
Slugs are workspace-scoped. Two workspaces can each have
lksn.app/promo— they're routed by which domain owns the slug. On a custom domain, slugs only collide within that domain.
3. Generate a QR code
On the link's detail page (click the link row to open it), click Generate QR code. You'll get a preview and three controls:
- Foreground / background colors — defaults are black-on-white. PRO and BUSINESS plans unlock arbitrary colors.
- Logo — upload a square image to embed in the center. Requires PRO or BUSINESS.
- Format — PNG (everyone) or SVG (PRO and BUSINESS).
Click Download. The QR code resolves to your short link's URL, so anyone scanning it ends up on the destination URL — and the scan is counted in stats.
Free plan QR codes carry a small "LinkSnap" watermark. PRO and BUSINESS plans remove it. You can preview the watermark before downloading.
4. Verify it worked
Open Dashboard → Links and click your link. You'll see the Stats tab on the right:
- Total clicks
- Recent clicks (with country, device, referrer)
- Time-series chart for the last 7 days
Visit the short URL once more — the counter ticks up within a couple of seconds.
You did it — you've shipped your first LinkSnap link. 🎉
What's next
- Installation — install the SDK or CLI for programmatic access.
- Concepts — the data model behind links, QR codes, tags, and domains.
- Portal → Links — the full set of link-management features (bulk ops, import/export, expiry, click caps).
- Portal → QR codes — deeper QR customization.
- Portal → Custom domains — serve short links from your own domain.
- API reference — every endpoint, every parameter.