A random short link says temporary. A custom alias says ours. The difference shows up in click-through, in trust, and eventually in search behavior — not because the alias itself "passes SEO", but because branded links change how people treat the URL before and after clicking. This guide covers how aliases work, how to name them, and how they interact with search.
What a custom alias changes
Consider two links to the same landing page:
https://yas.sh/Xk92a1 (random code)
https://yas.sh/black-friday (custom alias)
The second link tells the recipient what's behind it, who sent it, and that it's safe to click. That reduces friction at the exact moment friction costs conversions. For SMS, print, and spoken media — where a URL is read before it's clicked — the alias is the entire message.
Naming rules that scale
Aliases accumulate fast in a busy organization. Rules prevent chaos:
| Rule | Example | Why |
|---|---|---|
| ≤ 20 characters | launch not summer-2026-product-launch-event |
Typable, memorable, scannable |
| Lowercase, kebab-case | black-friday not BlackFriday |
Uniform, no case ambiguity |
| One concept | menu, apply, sale |
Mirrors real-world mental models |
| Avoid lookalikes | rn-2026 not rn-2O26 |
0/O and 1/l/I collisions kill print links |
| Reuse per campaign family | sale-spring, sale-summer |
Consistent structure aids analysis |
The platform enforces the mechanics: ^[a-z0-9-_]{3,30}$, lowercase normalization, and a reserved-word blocklist (api, admin, login, docs, dashboard, _next, …) so aliases can never shadow platform routes or brand names.
The SEO interaction: what actually matters
Three mechanisms connect short links to search performance:
1. 302 preserves the destination's SEO. Because the shortener responds 302 (temporary), search engines attribute the page to the destination URL. The destination's own canonical tag, meta data, and backlinks do the ranking work. Using 301 for short links would risk the destination's equity being viewed through the redirect — the 301 vs 302 guide explains the full semantics.
2. Click-through is a ranking signal by proxy. Google ranks pages people engage with. A branded alias on a printed flyer or SMS increases branded-search volume ("yas.sh black friday"), and branded search queries are among the strongest intent signals a site can earn.
3. Shareability compounds. Memorable links get shared more, and shares produce backlinks and visits. The alias is a small asset that compounds — which is why the naming matters as much as the destination.
Working with aliases via the API
Create, update, and check availability without touching the dashboard:
# Check availability before committing
curl -H "Authorization: Bearer yas_live_..." \
"https://yas.sh/api/v1/links?search=sale-spring"
# Create with alias
curl -X POST https://yas.sh/api/v1/links \
-H "Authorization: Bearer yas_live_..." -H "Content-Type: application/json" \
-d '{"originalUrl":"https://example.com/sale","customAlias":"sale-spring"}'
# → 201 { "shortCode": "sale-spring", "url": "https://yas.sh/sale-spring" }
# Retarget later (PATCH)
curl -X PATCH https://yas.sh/api/v1/links/<id> \
-H "Authorization: Bearer yas_live_..." -H "Content-Type: application/json" \
-d '{"customAlias":"sale-summer"}'
Alias changes are atomic: the uniqueness check and update happen in one operation, so two clients can't race to claim the same slug.
Aliases vs custom domains
Aliases live in the path (yas.sh/launch); custom domains live in the hostname (go.yourbrand.com/launch). They compose: a custom domain makes every link branded, and aliases make each one meaningful. If you control the domain, the hostname upgrade is the highest-leverage branding move — the custom domain setup guide is a 5-minute walkthrough.
Measuring alias performance
Because aliases are links, they inherit full analytics: clicks, devices, referrers, daily series. Compare alias families:
sale-springvssale-summer→ which season's creative landed?menuvsmenu-v2→ did the redesign help?- printed
applyvs digitalapply→ channel comparison on the same slug
The analytics overview endpoint returns per-link totals and breakdowns, so alias performance reviews are a query away.
Where the SEO benefit is real and where it is not
It is worth being precise about what a custom alias can and cannot do for SEO, so you invest where it pays. A descriptive alias does help in a few concrete ways: it makes the link readable and trustworthy (raising click-through when the URL is shown), it improves the anchor context when the link is used as descriptive text, and it makes the link easier to share and remember. It does not single-handedly move rankings the way a real page, backlinks, and on-page content do. The honest framing: a good alias is a supporting signal and a UX asset, not a substitute for genuine SEO. It complements rather than replaces the content it points to.
Anchors, readability, and click-through
Where the alias does earn its keep is in the parts of SEO that are about trust and behavior. A link like go.brand.com/spring-sale is more trustworthy at a glance than a random string, which lifts the click-through rate — and click-through is itself a signal. When that link is used as anchor text in a newsletter or an article, the descriptive slug reinforces what the destination is about. These are real, compounding benefits even though they are smaller than the effects of content quality and authority. The branded links trust material covers the trust side of this same coin.
Pairing aliases with clean, crawlable destinations
The best SEO result comes when the alias works with a destination that is itself indexable and well-structured: a real page with a clear title, a unique description, canonical URL, and good content. An alias pointing at a thin or non-indexed page does not rescue it. So treat the alias as the front door and the destination as the house: make the front door descriptive and trustworthy, and make the house worth arriving at. Together they give search engines a clear, rankable target and give users a link they trust enough to click.
A practical naming discipline
To get consistent SEO value, apply a naming discipline rather than ad-hoc aliases: lowercase, hyphenated, descriptive, and short, following the slug best practices. Keep permanent destinations on stable brand-level slugs and let a 301 handle relocation, so the equity you build is not lost when a page moves. A well-named alias plus a clean destination and a stable slug is a small but reliable component of an overall SEO approach.
Conclusion
Custom aliases are a marketing asset with engineering rules: short, lowercase, unique, reserved-word-protected, and fully measurable. They don't rank pages by themselves — but they earn the clicks, shares, and branded searches that ranking is built on. Choose them like the assets they are: create your first branded link or via the API in seconds.
