llms.txt
Compare with other sites' llms.txt files →# Lua - Open Source Link Shortener with Analytics
> Lua turns a long URL into a short one on a domain you control, then records what happens on every click: country, device, browser, referrer and UTM parameters, kept for as long as the link exists. Self-host it free, or use the cloud plans. REST API and MCP server included from the first paid tier.
## About Lua
Lua is an open source link shortener. The short link is the mechanism; the click record is the product. Every plan (including the free one) gets the full analytics field set, not a metered or gated subset. Two ways to run it: self-hosted with your own database and domain, or on Lua's cloud.
### Value proposition
- Every analytics field on every plan: country, region, city, device, browser, OS, language, referrer, and UTM parameters
- Click history kept for as long as the link exists, over any date range, no rolling window
- Custom domains, live in minutes after a CNAME
- QR codes on every link, with scans counted separately from clicks
- Link expiry, password protection, and per-platform destinations (iOS, Android)
- Tags and workspaces with team members
- REST API and MCP server, reaching the same actions the dashboard does
- Self-hostable, open source, AGPL
### What Lua does NOT do
- No conversion or revenue tracking. Lua measures the click and stops there; it cannot tell you what a link sold.
- No link-in-bio pages, no campaign manager, no A/B split testing.
- No identity across links. No cookie is set at the redirect, so the same visitor clicking two links is two unrelated rows.
## Pricing
Five tiers, monthly or yearly (yearly is always ten months' worth, two months free):
- **Free** — $0. 5 links, 100 tracked events, 1 tag, 1 user, no custom domain.
- **Starter** — $19/month or $190/year. 1,000 links, 50,000 events, 10 domains, 25 tags, 2 users. REST API and MCP server access.
- **Pro** — $49/month or $490/year. 5,000 links, 150,000 events, 50 domains, 100 tags, 5 users.
- **Growth** — $149/month or $1,490/year. 20,000 links, 500,000 events, 200 domains, 400 tags, 10 users.
- **Scale** — $349/month or $3,490/year. 100,000 links, 2,000,000 events, 500 domains, 1,000 tags, 20 users.
Every tier gets the full analytics field set. Nothing is held back for a higher plan. Full details at https://www.lua.sh/pricing.
## Free tools
In-browser utilities, no login required, hosted at /tools:
- **Link checker** — follows a redirect chain and reports each hop, run entirely server-side with SSRF guards (private ranges refused on every hop)
- **QR code generator** — runs entirely in the browser, generates a QR code for any URL, nothing is sent to a server
- **UTM builder** — runs entirely in the browser, builds a tagged URL from campaign parameters, nothing is sent to a server
Index at https://www.lua.sh/tools.
## Blog
Editorial articles on links, redirects, and click analytics. Index at https://www.lua.sh/blog.
## Glossary
Plain-English definitions of link-shortening and analytics terms. Index at https://www.lua.sh/glossary.
Terms covered: UTM parameters, referrer, referrer policy, redirect, 301 vs 302, short link, back-half, custom domain, CNAME record, QR code, link rot, open redirect, geolocation, user agent, bot traffic, unique clicks, attribution, query string.
## Alternatives comparison
Per-competitor comparisons under /alternatives/, each weighing Lua's tiers against the competitor's:
- vs **Bitly** — https://www.lua.sh/alternatives/bitly
- vs **Dub** — https://www.lua.sh/alternatives/dub
- vs **Rebrandly** — https://www.lua.sh/alternatives/rebrandly
- vs **TinyURL** — https://www.lua.sh/alternatives/tinyurl
Each comparison states, honestly, who the competitor still suits, not just where Lua wins. Hub: https://www.lua.sh/alternatives.
## Use cases
Landing pages for specific audiences and workflows, each with a stated caveat naming where Lua stops helping. Hub: https://www.lua.sh/use-cases.
- Marketing campaigns — https://www.lua.sh/use-cases/marketing-campaigns
- Agencies — https://www.lua.sh/use-cases/agencies
- Creators — https://www.lua.sh/use-cases/creators
- Print and QR codes — https://www.lua.sh/use-cases/print-and-qr
- Developers — https://www.lua.sh/use-cases/developers
- Newsletters — https://www.lua.sh/use-cases/newsletters
## Privacy and security
- No conversion, revenue, or cross-link identity tracking, see "What Lua does NOT do" above
- The link checker resolves and re-checks every hop's address against private, loopback, link-local and reserved ranges before fetching it, and never reads the response body
- Open source, self-hostable if you would rather the click data never left your own server
## Frequently asked questions
Full list at https://www.lua.sh/faq. A few that come up first:
**What does Lua actually do?**
It turns a long URL into a short one on a domain you control, then records what happens when someone opens it: which country, which device, which browser, which referrer, and any UTM parameters on the link. The short link is the mechanism. The record is the product.
**Do I need a domain of my own?**
No. Links work on the shared domain from the moment you sign up. A domain of your own is worth adding when you start publishing links somewhere permanent.
**How long does a custom domain take to set up?**
Point a CNAME at Lua and wait for the certificate, usually minutes.
## Open source
Lua's source is available on GitHub: https://github.com/luadotsh/lua
## Links
- **Website**: https://www.lua.sh
- **App and short links**: https://lua.sh
- **Pricing**: https://www.lua.sh/pricing
- **Blog**: https://www.lua.sh/blog
- **Glossary**: https://www.lua.sh/glossary
- **Tools**: https://www.lua.sh/tools
- **Use cases**: https://www.lua.sh/use-cases
- **Alternatives**: https://www.lua.sh/alternatives
- **FAQ**: https://www.lua.sh/faq
- **Terms**: https://www.lua.sh/terms
- **Privacy**: https://www.lua.sh/privacy
- **GitHub**: https://github.com/luadotsh/lua
- **X**: https://x.com/luadotsh
---
**Lua** — Open source link shortener with analytics on every plan. Self-host it free, or use the cloud.