Skip to content

Setting Up Your Booking Handle

Setting Up Your Booking Handle

Your booking handle is the unique identifier that creates your custom booking URL. This is what patients will use to access your booking page.


What is a Booking Handle?

A booking handle is a short, memorable name that becomes part of your booking URL:

HandleResulting URL
downtown-clinicbooking.outsmartcare.com/downtown-clinic
dr-smithbooking.outsmartcare.com/dr-smith
wellnesscenterbooking.outsmartcare.com/wellnesscenter

Handle Requirements

Your booking handle must follow these rules:

Allowed Characters

  • Lowercase letters (a-z)
  • Numbers (0-9)
  • Hyphens (-)

Format Rules

  • Minimum length: 3 characters
  • Maximum length: 50 characters
  • Cannot start or end with a hyphen
  • No consecutive hyphens (--)
  • No spaces or special characters

Reserved Words

The following handles are reserved and cannot be used:

  • admin, api, booking, book, app
  • login, logout, register, signup, signin
  • account, settings, help, support
  • www, mail, ftp, cdn, static, assets
  • img, images, css, js, fonts
  • ai, portal, store, shop, sit-booking, booking-app, store-app

Setting Up an Office Handle: the Web Address Card

Your office’s booking handle is your clinic’s web address. You set it on the Web Address card in your office’s preferences.

  1. From the Main Navigation Menu, click Office to go to the Office Details page, then click the Preferences tab at the top.
  2. Click the Online Booking tab.
  3. The Web Address card is at the top. If your office does not have a web address yet, it says You do not have a web address yet. Choose one to start.
  4. Type the address you want in the box in front of .outsmartcare.com, and click Save. To change an address you already have, click Change first.
In Office Details, on the Preferences tab, the Online Booking group. Shows the Web Address card with willowbrook.outsmartcare.com and the Change and Remove web address buttons, and below it the Allow Online Booking card switched Off with the public link willowbrook.outsmartcare.com/book.

The Web Address card on the Online Booking tab of Office Preferences. The Allow Online Booking switch below it turns the booking page on and off without changing the web address.

The web address and online booking are two separate settings:

SettingWhat it controls
Web AddressYour clinic’s address online, such as willowbrook.outsmartcare.com. Your booking page uses it.
Allow Online BookingWhether your booking page takes bookings. Turn it Off to pause online booking. Your web address stays yours while booking is paused.

When Allow Online Booking is Off, every link to your booking page shows patients a page headed Online Booking Temporarily Unavailable. It tells them to contact you to book, and shows your clinic’s phone number and email address. This includes your web address, your older booking page links, and links that name your office by number.

Remove web address, on the Web Address card, gives up the address. Your booking page then has no address until you choose a new one.

A web address of your own on outsmartcare.com, such as willowbrook.outsmartcare.com, needs an active Pro, Basic or Schedule+ subscription. Without one, the Web Address card shows a note saying so.

The Web Address card and the Preferences tab are available to the office owner and admin staff.

Good Handle Examples for Offices

Type of PracticeSuggested Handles
Single locationdowntown-clinic, main-street-physio
Multi-locationsmith-health-toronto, wellness-center-north
Specialty practicepediatric-therapy-ottawa, sports-med-vancouver

Setting Up a Practitioner Handle

To create a booking handle for your personal booking page:

  1. Log in to OutSmart as yourself (the practitioner)
  2. Navigate to your practitioner booking page
  3. Click the Settings icon (gear) in the header
  4. Find Custom Subdomain
  5. Enter your desired handle
  6. Click Save

Good Handle Examples for Practitioners

Practitioner TypeSuggested Handles
Medical doctordr-jane-smith, dr-johnson-md
Therapistsarah-jones-rmt, mike-lee-counselling
Specialistdr-patel-dermatology, physio-with-anna

Changing Your Handle

You can change your booking handle at any time:

  1. Access your booking page in edit mode

  2. Open Settings

  3. Enter the new handle

  4. Click Save

    Important: When you change your handle, the old URL will stop working immediately. Update any marketing materials, business cards, or website links that use the old URL.


Handle Conflicts

Same Handle for Office and Practitioner

If someone tries to use a handle that’s already taken:

  • The system will display an error
  • You must choose a different handle

Resolving Conflicts

If you need a handle that’s taken:

  • Add your location: dr-smith-toronto instead of dr-smith
  • Add your specialty: smith-dermatology instead of smith-clinic
  • Add a qualifier: downtown-wellness-clinic instead of wellness-clinic

Testing Your Handle

After setting up your handle:

  1. Open a new browser tab (or incognito/private window)
  2. Visit your new URL: booking.outsmartcare.com/your-handle
  3. Verify the page loads correctly
  4. Check that your branding appears
  5. Test the booking flow as a patient would

Next Steps

Now that you have your booking handle:

  1. Access Your Booking Page - Learn about different URL formats
  2. Edit Mode Basics - Start customizing your page