# Shortcut aliases

An alternate handle that resolves to the same shortcut as its canonical slug.

> **Who can use this feature?**
>
> - Available on the [Business and Enterprise plans](https://uselora.com/pricing)

## Overview

A shortcut has one canonical slug — the name you enter in the **Slug** field — plus optional **Aliases** that open the same destination. Aliases inherit the shortcut's visibility, password, expiry, and analytics. When you change the destination, every alias follows automatically.

Use aliases when your team needs more than one name for the same link — for example `/vacation` and `/urlaub` in a bilingual workspace, or `/pto` alongside the full slug `/vacation-request`.

## Configure

Aliases are optional. You can add them when you create a shortcut or later on its detail page.

### Add aliases when creating a shortcut

1. From your workspace, press **C** or click **Create shortcut**.
2. Enter the canonical slug and destination URL as usual.
3. Under **Aliases**, type an alternate handle and press **Enter** to add it. Repeat until you have every name you need (up to 10).
4. Click **Create shortcut**.

### Add or edit aliases on an existing shortcut

1. From your workspace, open the shortcut.
2. On the detail page, find **Aliases** in the form.
3. Add handles with **Enter**, or remove a chip with its remove control.
4. Click **Save**.

> **Note:** Aliases use the same naming rules as slugs — lowercase letters, digits, hyphens, and underscores, 1–50 characters. Each alias must be unique in the shortcut's namespace (shared for Workspace and Unlisted shortcuts, or private to you for Private shortcuts). An alias cannot match the canonical slug.

## Basics

### How aliases behave

- Every alias opens the same destination as the canonical slug, including [dynamic parameters](/docs/creating-shortcuts#dynamic-shortcuts) and [dynamic routing](/docs/creating-shortcuts#dynamic-routing).
- [Workspace analytics](/docs/workspace-analytics) counts clicks under one shortcut, regardless of which alias or slug a visitor used.
- Duplicating a shortcut copies the canonical slug only — aliases are not copied.
- If you downgrade from Business or Enterprise, existing aliases keep working. You can remove aliases on any plan, but adding or changing them requires Business or Enterprise.

### Language variants

In international teams, keep one canonical slug and add aliases in other languages your colleagues use — for example `/vacation` with aliases `/urlaub` and `/ferien`. That way everyone can type the name they remember without maintaining duplicate shortcuts.

## FAQ

**My alias says it's already taken**
Another shortcut in the same namespace already uses that handle, or you added the same alias twice. Pick a different name, or remove the alias from the other shortcut first. Alias names follow the same [naming conventions](/docs/naming-conventions) as slugs.

**Changing visibility failed because of an alias**
When you change a shortcut's visibility, every alias moves to the new namespace with it. If any alias would collide with a name another shortcut already owns in that namespace, the whole change is rejected and nothing is updated. Remove or rename the conflicting alias, then try again.

**Which name shows in search and the extension?**
Search and the [browser extension](/docs/get-the-app) show the handle that matched what you typed — canonical slug or alias. The shortcut still appears once in results; opening it uses the matched handle in the URL.

**Does unlocking a password-protected shortcut work across aliases?**
Yes. After you unlock via the canonical slug or any alias, other aliases on the same shortcut open without asking again.