Custom Slugs
ProRequires a Pro or Builder plan
What are Custom Slugs?
By default, AWSYS.CO assigns a random six-character ID to every new link (e.g., awsys.co/a1b2c3). With custom slugs you choose a meaningful label instead, scoped inside your personal namespace — for example, awsys.co/ns/summer-sale. Branded slugs are more memorable, look professional in marketing materials, and make it easier to identify links in your dashboard.
Requirements
Custom slugs require a Pro or Builder subscription. Each Pro account has a unique 4-character namespace assigned automatically (visible in Settings). Custom slugs must be unique within your namespace. Namespaces cannot be changed.
Step-by-step: Create a link with a custom slug
- Open Create Link. Paste the destination URL as usual.
- Toggle on Custom slug. A text field appears showing your namespace prefix (e.g.,
awsys.co/ab12/). - Type the slug you want after the namespace — use letters, digits, and hyphens only. Spaces and special characters are not allowed.
- AWSYS.CO checks availability in real time. A green checkmark means the slug is available; a red indicator means it is already taken in your namespace.
- Click Shorten. The resulting link will be
https://awsys.co/ab12/your-slug. - To use a custom slug on a custom domain, first connect the domain in Settings — the slug will then be served at
https://go.yourdomain.com/your-slug.
Configuration reference
| Field | Allowed values | Notes |
|---|---|---|
| Slug characters | a–z, 0–9, hyphen (-) |
Case-insensitive; stored lowercase |
| Minimum length | 2 characters | Shorter slugs are reserved |
| Maximum length | 64 characters | Includes hyphens |
| Namespace | Your account's 4-character code | View in Settings → Account |
Common questions
Can I change the slug after the link is created?
No. Once a custom slug is set, it cannot be changed — this ensures that any existing QR codes or shared links continue to work. You can delete the link and create a new one with a different slug if needed.
Can two accounts have the same slug?
Yes, because slugs are scoped inside each account's namespace. awsys.co/ab12/sale and awsys.co/cd34/sale are completely independent links.
What happens to my custom slugs if I downgrade from Pro?
Existing links with custom slugs keep working after a downgrade. You just cannot create new custom slugs until you re-upgrade. Auto-generated IDs are used for any links created while on the Free tier.
Can I create custom slugs via the API?
Yes. Pass "slug": "your-slug" in the body of a POST /api/createShort request along with your API key. The slug is scoped to your namespace automatically.