Who This Is For / When to Use
This feature is for account managers and calendar administrators configuring appointment booking widgets in Kyrios. Use staff role badges when a service has multiple assigned staff members with varying expertise levels or specialties (such as "Senior Stylist" or "Lead Therapist"). Badges display directly on staff cards within the booking widget to help customers identify the correct staff member before booking.
What Staff Role Badges Do in Kyrios
Staff role badges add a custom text tag to a staff member's profile that displays during customer staff selection on booking widgets.
Key capabilities and behavior:
Reusable Badge Library: Created badges are stored globally across the account so you can assign the same badge to multiple staff members without re-typing.
Single Badge Limit: Each staff profile supports exactly one role badge containing up to 30 characters.
Color Customization: Each badge can be assigned a specific color to visually differentiate roles on the booking screen.
Dynamic Styling: Badges display on staff selection cards in a lighter shade of the widget's primary color to maintain brand consistency across desktop and mobile layouts.
Clean Display Logic: Staff profiles without an assigned badge display no tag or placeholder on the booking widget card.
Instant Widget Updates: Edits or deletions to badges apply immediately to the booking widget upon the next page load.
How to Create and Assign a Staff Role Badge
Navigate to Services in the main navigation menu and select Staff.
Click Edit next to the target staff member.
Select the Basic details tab.
Click the Staff badge dropdown menu.
Select an existing badge from the list, or select Manage to open the badge manager window.
Type the badge name (up to 30 characters), choose a color dot, and click + Add to save a new badge.
Select the desired badge and click Save.
The assigned badge now appears on the staff member's selection card in the booking widget.
Common Issues and Fixes
Badge changes do not appear on the booking widget
Cause: The customer booking widget page is cached in the browser.
Fix: Hard refresh the webpage or re-open the booking URL in a new browser window to load the updated settings.
The Staff badge dropdown option is missing
Cause: You are editing a service or calendar record instead of an individual staff profile.
Fix: Ensure you navigate directly to Services -> Staff and select the specific staff member's profile.