Skip to content
URX

urx.si/docs

URX documentation

Everything you need to create a Smart Link, route visitors and read the results. URX is in early access — this guide grows with the product.

Quickstart

  1. Claim your slug, e.g. urx.si/acme. Slugs are free on every plan.
  2. Add destinations: your App Store URL for iPhone and iPad, your Google Play URL for Android, and a fallback (usually your website) for everyone else.
  3. Share the link, or download its QR code.
  4. Open Analytics to see clicks by platform, country, source and destination.

Want to see routing before you sign up? Open urx.si/demo on your phone and your laptop.

Concepts

Smart Link
A URL on a URX domain that resolves to a different destination depending on who opens it.
Slug
The part after the domain, like acme in urx.si/acme. Unique per domain.
Destination
Where a visitor lands: a store listing, an in-app screen or a web page.
Routing Rule
An IF/THEN condition on device, country or source that overrides the default destination.
Fallback
The destination used when no rule or platform default applies.
Project
One product — an app, a site or both. Links belong to a project.
Workspace
Your team and billing boundary. It can hold many projects.
Click
One visit to a link. A Scan is a click that came from a QR code.
Conversion
An outcome after a click, like an install or purchase, reported back to URX.

How routing works

Every visit is resolved in the same order:

  1. Routing rules, top to bottom. The first rule whose conditions all match wins.
  2. Platform defaults — iOS and Android destinations.
  3. Fallback — everyone else.

Rules can check device, country (ISO code, e.g. IN) and source (referrer or utm_source). Rules are available from the Pro plan.

Slug rules

  • 3–48 characters: lowercase letters, numbers and single hyphens.
  • Can't start or end with a hyphen. Case-insensitive: Acme and acme are the same slug.
  • Some slugs are reserved because URX uses those paths itself, such as pricing, docs and login.
  • Trademark concerns about a slug? See the Acceptable Use Policy.

Direct deep links (Pro and up) open a screen in your installed app using its URI scheme. Anything after your slug is passed through:

Path mapping
urx.si/acme/shoes/123  →  acme://shoes/123        (app installed)
                       →  App Store / Google Play  (no app)
                       →  https://acme.com/shoes/123 (desktop)

Universal Links and App Links on custom domains are coming soon. Deferred deep linking — opening a screen after a fresh install — is on the roadmap and will need an SDK.

QR codes

Every link has a QR code that encodes the link itself, not its destination — so you can change the destination after printing. Download PNG or SVG, choose colours and error correction (L, M, Q, H), and add a logo. Scans appear in Analytics as clicks with source qr.

Custom domainsSoon

On Growth and Business, connect a subdomain such as links.acme.com:

  1. Add the domain in URX.
  2. Create the CNAME and TXT verification records URX shows you.
  3. URX verifies ownership, issues HTTPS and starts serving your links.

Analytics

Each click records the time, link, chosen destination, platform, device type, browser, country, referrer and UTM parameters. IP addresses are used to look up the country and are not stored. Retention: Free 30 days, Pro 1 year, Growth 2 years.

APIPreview

The REST API opens with the Growth plan. Authenticate with a workspace API key in the Authorization header. Shapes may change before general availability.

  • POST/v1/links — Create a smart link
  • GET/v1/links/:id — Retrieve a link and its routing
  • PATCH/v1/links/:id — Change destinations or rules
  • GET/v1/analytics — Query clicks and breakdowns
  • POST/v1/events — Report a conversion
Create a link
curl https://api.urx.si/v1/links \
  -H "Authorization: Bearer $URX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "launch",
    "destinations": {
      "ios": "https://apps.apple.com/app/acme/id6450000000",
      "android": "https://play.google.com/store/apps/details?id=com.acme.app",
      "fallback": "https://acme.com/launch"
    }
  }'

WebhooksPreview

Register an HTTPS endpoint to receive signed JSON for these events:

  • link.created — A link was created
  • link.updated — Destinations or rules changed
  • link.clicked — A visitor opened a link
  • conversion.created — A conversion was attributed

Stuck? Email support@urx.si or use the contact form.