For the complete documentation index, see llms.txt. This page is also available as Markdown.

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