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.