Skip to main content
Instead of a random 7-character code, you can choose the path that appears after the domain. This lets you create short links that are easy to remember and reinforce your brand. 
https://www.shorturlx.xyz/my-brand
instead of: 
https://www.shorturlx.xyz/abc1234

​
Requirements

Custom slugs require a Shorturlx account. Sign in before creating a link to access this feature. Slug constraints:
  • Allowed characters: letters (a–z, A–Z), numbers (0–9), hyphens (-), and underscores (_)
  • Maximum length: 50 characters
  • Must be unique — no two links can share the same slug
If the slug you want is already taken, you will receive a 409 Conflict error. Choose a different slug and try again — there is no way to claim a slug that belongs to another link.

​
Creating a custom slug

​
Via the dashboard

1

Sign in

Go to shorturlx.xyz and sign in to your account.
2

Open the URL shortener

Click New link or use the shortener form on the dashboard.
3

Enter your URL

Paste the long URL you want to shorten.
4

Set a custom slug

In the Custom URL slug (optional) field, type the path you want, for example my-brand. The field shows your domain as a prefix so you can see exactly what the final URL will look like.
5

Create the link

Click Shorten URL. Your link will be available at www.shorturlx.xyz/my-brand immediately.

​
Via the API

Pass the customSlug parameter in your request body when calling the /api/shorten endpoint. You must include a valid API key. 
curl --request POST \
  --url https://www.shorturlx.xyz/api/shorten \
  --header "Authorization: Bearer sk_your_api_key_here" \
  --header "Content-Type: application/json" \
  --data '{
    "url": "https://example.com/very/long/path",
    "customSlug": "my-brand"
  }'
A successful response returns the created link object: 
{
  "id": "clx1234abcd",
  "shortUrl": "https://www.shorturlx.xyz/my-brand",
  "slug": "my-brand",
  "longUrl": "https://example.com/very/long/path",
  "createdAt": "2026-03-31T12:00:00.000Z"
}
If the slug is already taken, the API responds with: 
{
  "error": "Custom slug already taken"
}
with an HTTP status of 409.

​
Next steps

URL shortening

Learn how random slugs work and how click tracking is handled.

API keys

Generate an API key to create custom slugs programmatically.

Build docs developers (and LLMs) love

Get started for freeTalk to us