> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tyrionurl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> The key building blocks of TyrionURL — understand these and every feature will make immediate sense.

Understanding how TyrionURL is structured will help you get the most out of every feature. This page covers the fundamental concepts that everything else builds on.

***

## Short Links

A **Short Link** is the foundational unit of TyrionURL. It is a compact, redirect URL that points to any destination on the web.

```
https://t.tyrionurl.com/xyz123  →  https://your-very-long-destination-url.com/path?params=...
```

Every short link can optionally have:

* A **custom alias** (e.g., `/summer-sale` instead of a random code)
* A **password** that visitors must enter before being redirected
* **A/B test variants** that split traffic between multiple destinations
* **Analytics** that track every click automatically

<Info>
  You do not need an account to create a basic short link — but saving links to your dashboard and accessing analytics requires registration.
</Info>

***

## Short Codes & Custom Aliases

Every short link has a **short code** — the unique identifier at the end of the URL. By default, this is randomly generated (e.g., `xyz123`). With a paid account, you can set a **custom alias** (e.g., `/launch-day`) to make links more meaningful and memorable.

**Default:** `t.tyrionurl.com/a8f2k`
**Custom alias:** `t.tyrionurl.com/launch-day`
**Custom domain:** `links.yourbrand.com/launch-day`

***

## Analytics Events

Every time someone visits a short link, TyrionURL records a **click event** containing:

| Data Point         | Description                                               |
| ------------------ | --------------------------------------------------------- |
| **Timestamp**      | When the click happened                                   |
| **Country & City** | Geo-location of the visitor                               |
| **Device Type**    | Mobile, desktop, or tablet                                |
| **Browser & OS**   | Chrome on Android, Safari on iOS, etc.                    |
| **Referrer**       | Where the visitor came from (social, email, direct, etc.) |

These events power all charts, heatmaps, and real-time monitoring in the [Analytics Dashboard](/analytics/overview).

***

## Campaigns

A **Campaign** is a named container that groups multiple short links together. Campaigns let you measure the combined performance of all links in a marketing effort — across channels, creatives, and time periods.

**Example:** A product launch campaign might include links shared on Instagram, in an email newsletter, and in a paid ad. The campaign view shows aggregate clicks for all three.

→ Learn more: [Campaigns](/link-management/campaigns)

***

## Bio Pages

A **Bio Page** is a mobile-first micro-landing page hosted at `t.tyrionurl.com/bio/:username`. It is designed to solve the "one link in bio" limitation of social platforms like Instagram and TikTok.

Your bio page can include:

* A profile photo and display name
* A description or tagline
* Multiple links (with icons and custom labels)
* Social media icons
* Embedded Spotify or YouTube content
* A customizable theme and color palette

→ Learn more: [Bio Pages](/bio-pages/creation)

***

## QR Codes

A **QR Code** is a scannable image that encodes a URL (or text or vCard). TyrionURL lets you generate QR codes with custom colors, shapes, and logos — downloadable as PNG or SVG for print use.

QR codes are independent of short links — you can point a QR code directly at a destination URL, at a short link, or at a bio page.

→ Learn more: [QR Code Generator](/qr-codes/generating)

***

## A/B Tests

An **A/B Test** splits incoming traffic across two or more destination URLs according to a configurable ratio. TyrionURL records which variant each visitor was sent to, and (if conversion tracking is set up) which variant generated the most leads or revenue.

**Example:** 50% of visitors go to Landing Page A, 50% to Landing Page B. After a week, you check which page had more purchases.

→ Learn more: [A/B Testing Setup](/ab-testing/setup)

***

## Custom Domains

By default, all short links use the `t.tyrionurl.com` domain. A **Custom Domain** lets you replace this with your own branded domain (e.g., `go.yourbrand.com`).

Custom domains require a DNS CNAME record pointing to TyrionURL's servers. Once verified, all new links you create will use your branded domain automatically.

→ Learn more: [Custom Domain Setup](/custom-domains/setup)

***

## Deep Links

A **Deep Link** is a special short link that detects the visitor's context (e.g., Instagram's in-app browser, the Amazon app) and routes them to the best possible experience — either the native app or a standard browser.

TyrionURL supports deep linking bypasses for Instagram, Amazon, Myntra, Spotify, YouTube, and X (Twitter).

→ Learn more: [App Deep Linking](/products/deep-linking)

***

## Secure Documents

A **Secure Document** is a file you upload to TyrionURL and share via a trackable link. Recipients can view the document in TyrionURL's built-in secure viewer without needing to download it. You control whether downloads are permitted.

→ Learn more: [Secure Document Sharing](/products/secure-documents)

***

## API Keys (A/B Testing)

An **API Key** is a credential generated in your TyrionURL settings and embedded in a partner website. It allows TyrionURL to receive **conversion events** — such as purchases or lead form submissions — from that external site, and attribute them back to the A/B test variant that sent the visitor.

→ Learn more: [Generating API Keys](/ab-testing/api-keys)

***

## How It All Fits Together

```
Short Link
├── Custom Alias (optional)
├── Password Protection (optional)
├── A/B Test Variants (optional)
│   └── Conversion Tracking via API Key
├── Click Analytics (automatic)
│   ├── Geo Heatmap
│   ├── Real-time Live Traffic
│   └── Time-series Charts
├── Attached to a Campaign (optional)
└── Served on a Custom Domain (optional)

Bio Page
├── Multiple Links
├── Social Icons
├── Spotify / YouTube Embeds
└── Customizable Theme

QR Code
└── Points to any URL, Short Link, or Bio Page
```

***

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/getting-started/quickstart">
    Jump straight into creating your first short link.
  </Card>

  <Card title="Dashboard Overview" icon="gauge" href="/getting-started/dashboard">
    Learn how to navigate your TyrionURL workspace.
  </Card>
</CardGroup>
