Skip to main content
Your custom domain on Wrkks takes the form wrkks.site/username, where you choose the username. This creates a memorable, professional URL for your personal website.

​
Username requirements

When selecting your username:
  • Choose a unique identifier (availability is checked automatically)
  • Use a professional handle that represents you
  • Consider using your name, initials, or professional brand
  • Keep it simple and easy to remember
Your username becomes part of your public URL, so choose carefully. You can change it later if needed.

​
Setting up your username

Your username is displayed and managed from the /website page.

​
Username display

At the top of your website page, you’ll see: 
wrkks.site / [your-username]
The DomainInputField component shows:
  • A link icon to indicate this is a URL
  • “wrkks.site /” prefix
  • Your current username (or placeholder if not set)
  • Edit button (pen icon) to change username

​
Changing your username

1

Click the edit button

Click the pen icon next to your username. This opens the EditDomainDialog component.
2

Review current username

The dialog displays:
  • Title: “Change Userhandle”
  • Your current username in a disabled input field
  • Label: “Old Userhandle”
3

Enter new username

In the “Choose new Userhandle” field:
  • Type your desired username
  • The placeholder shows “New [current-username]”
  • Input validates in real-time
4

Save changes

Click the Save button. The system:
  • Validates username availability
  • Updates your username via updateUser() function
  • Shows success toast: “Username updated successfully!”
  • Refreshes the page to display new username

​
Dialog actions

The EditDomainDialog provides two buttons:
  • Cancel: Close dialog without making changes
  • Save: Submit new username (triggers validation and update)

​
Username validation

When you attempt to save a new username:
If validation fails, you’ll see an error toast with the specific issue:
  • Username already taken
  • Invalid characters
  • Username too short/long
  • Other validation errors

​
Success confirmation

After successfully updating your username:
  1. Success toast appears: “Username updated successfully!”
  2. Page refreshes automatically to show the new username
  3. URL updates to reflect new username
  4. Published site (if live) is immediately accessible at new URL
If your site is already published, changing your username updates your public URL immediately. Share the new link with your audience.

​
Username in publish flow

Your username is required before publishing:
  • The publish button uses your username to determine the public URL
  • If username is not set, publishing may fail
  • Set your username before your first publish

​
Technical implementation

The username system:
  1. Stores username in user data table (Supabase)
  2. Uses updateUser({ username: newUsername }) to save changes
  3. Validates uniqueness server-side
  4. Associates username with your user account

​
Best practices

  • Use your name: “john-smith” or “jsmith”
  • Keep it short: Easier to share and remember
  • Avoid numbers: Unless they’re part of your brand
  • Match other profiles: Use the same handle as LinkedIn/Twitter for consistency
  • Test pronunciation: Make sure it’s easy to say out loud

​
Changing username after publishing

If you change your username while your site is live:
  1. Old URL (wrkks.site/old-username) stops working immediately
  2. New URL (wrkks.site/new-username) becomes active
  3. Update any links you’ve shared (social media, resumes, email signatures)
  4. No need to republish—the change is instant
Changing your username breaks existing links. Consider the impact before changing if you’ve already shared your URL widely.

​
URL format

Your complete website URL follows this pattern: 
https://wrkks.site/username
Where:
  • wrkks.site is the platform domain
  • username is your custom handle

​
Error scenarios

If you try to save without entering a username:
  • Save action is blocked
  • No API call is made
  • Dialog remains open

​
Next steps

After setting up your username:
  • Publish your website to make it live
  • Share your custom URL on professional networks
  • Update your resume and business cards with your new link

Build docs developers (and LLMs) love

Get started for freeTalk to us