Service Settings (Per Variant)
(Admin → Services → Service Settings)
This defines default rules for a specific Shopify variant.
📌 Setting 1 — Staff Selection Mode
Controls whether customer must choose a staff member.
REQUIRED
✔ Customer must pick a staff ✔ Widget shows all staff cards ✔ hold/appointment requires staffId
Recommended for:
Beauty salon
Nail, spa
Personal trainers
OPTIONAL
✔ Customer can choose staff ✔ OR choose “Any staff” ✔ If no staff chosen → system assigns automatically
Recommended for:
Clinics
Repair service
Tutor company
HIDDEN
❌ Customer cannot choose staff ✔ One staff will be auto-assigned ✔ Useful when:
Merchant manually assigns later
Customers don’t care who performs the service
Team members rotate randomly
Good for:
Car wash
Cleaning service
Home maintenance
📌 Setting 2 — Default Duration (minutes)
Used when:
Staff mapping does not exist
OR staff mapping durationMin = 0
This allows global control:
“All staff perform this service for 45min unless overridden.”
📌 Setting 3 — Max Appointments Per Day
Limit how many bookings total this service can accept (per staff via mapping OR per service via settings).
Example:
Massage therapy only allows 5 bookings/day to avoid burnout.
📌 Setting 4 — Max Days in Advance
Defines how far into the future customers may book.
Examples:
365 days = yearly planner
30 days = most common
1 day = next day only
0 = same day only
System checks:
diffDays > maxAdvanceDays → block timeslot
📌 Setting 5 — Allow Same-Day Booking
If disabled:
Customer cannot book today
Earliest available date = tomorrow
Useful for:
Businesses who need preparation time
Travel or events
Clinics that require verification
📌 Setting 6 — Disabled Dates
Specific dates where this service is unavailable, even if staff is available:
Examples:
Public holidays
Store closed
Maintenance day
Product launch event
Format:
YYYY-MM-DD
If a date is listed:
Timeslots on that day will be empty.
Last updated