Skip to main content

​
What are Custom Aliases?

A custom alias is a human-chosen slug appended to your TyrionURL domain instead of a randomly generated code.
TypeExample
Default short codet.tyrionurl.com/a8f2k
Custom aliast.tyrionurl.com/summer-sale
Custom alias + custom domainlinks.yourbrand.com/summer-sale
Custom aliases make links easier to type, share verbally, print on physical materials, and trust at first glance.

​
Benefits

  • Higher click-through rates — Descriptive links signal relevance before someone clicks
  • Easier to share verbally — You can say “go to links.yourbrand.com/event” in a podcast or video
  • Printable — Short, readable URLs work on posters, packaging, and slides
  • Memorable — Your audience can return to a link even without saving it
  • Professional — Removes the impression of a suspicious random code

​
When to Use Custom Aliases

  • Campaign landing pages (e.g., /black-friday, /product-launch)
  • Evergreen links you’ll use repeatedly (e.g., /newsletter, /book-a-call)
  • Physical print materials where the URL needs to be human-typeable
  • Speaking engagements or videos where you mention a link out loud

​
Creating a Custom Alias

1

Open the Link Creator

Go to your Dashboard and paste your destination URL into the input field.
2

Open Advanced Settings

Click Advanced Settings to reveal the alias configuration panel.
3

Enter Your Alias

Type your desired slug in the Custom Alias field. TyrionURL checks availability in real time and shows a green checkmark if the alias is free or a red indicator if it’s taken.Alias rules:
  • Lowercase letters, numbers, and hyphens only
  • No spaces or special characters
  • Minimum 2 characters, maximum 50 characters
  • Must be unique across TyrionURL globally
4

Generate the Link

Click Shorten. Your link is created with the custom alias.
https://t.tyrionurl.com/summer-sale

​
Checking Alias Availability

TyrionURL validates alias availability via: 
GET /api/url/check?alias=summer-sale
The real-time indicator in the dashboard uses this endpoint as you type. If you’re integrating programmatically, you can use this endpoint before submitting your link creation request.

​
Best Practices

Keep aliases short — 2 to 4 words separated by hyphens is optimal for readability.
Use lowercase only to avoid confusion (URLs are case-sensitive on some systems).
Avoid dates in aliases unless the link is genuinely date-specific — it keeps links usable longer.
For branded links, combine a custom alias with a Custom Domain for maximum impact.
Maintain a naming convention across your team (e.g., [channel]-[campaign] → email-summer24).

​
Common Mistakes

Alias already taken — Popular words like /shop, /blog, or /home are often claimed. Add brand-specific prefixes to avoid conflicts (e.g., /acmecorp-shop).
Case sensitivity confusion — t.tyrionurl.com/SummerSale and t.tyrionurl.com/summersale may be treated as different aliases. Stick to lowercase.
Using aliases for one-time links — Save custom aliases for links you’ll promote repeatedly. Use auto-generated codes for one-off or internal links.

Custom Domains

Pair custom aliases with your own domain for full branding.

Password Protection

Add a password layer on top of any link.

URL Shortening Overview

Back to the shortening feature overview.

Analytics

Track performance of your named links.