circle-info
Welcome to the new Sesami Help Portal with AI capabilities. Search your question and get your answer instantly!
githubEdit

Quickstart

This guide gets you from "installed" to "first booking" with the fewest steps.

What you'll set up

  • Services - Shopify products representing bookable services

  • Resources - Team members, rooms, equipment, or other assets needed to deliver services

  • Availability - Working hours and scheduling rules for resources

  • Storefront integration - Booking buttons and calendar on your online store

circle-info

Time estimate: 15-30 minutes for a basic setup with one service and one team member.

Before you start

Make sure you have:

  • Admin access in your Shopify store

  • A list of services you want to offer with:

    • Service name (e.g., "60-Minute Massage", "Dog Grooming")

    • Duration (e.g., 30 minutes, 1 hour, 2 hours)

    • Price

    • Capacity (number of simultaneous bookings, if applicable)

  • Resource information:

    • Team member names and their working hours

    • Room or equipment requirements (if applicable)


1

Create service products in Shopify

Create a Shopify product for each bookable service:

  1. In Shopify Admin, go to Products > Add product

  2. Enter a clear product title without duration (e.g., "Haircut", "Massage", "Consultation")

    • Keep the title simple - this appears in booking confirmations and calendars

  3. Add variants for different durations:

    • Click Add variant

    • Create variants like "30 Minutes", "1 Hour", "90 Minutes"

    • Set the price for each duration variant

  4. Add a description, images, and other product details as needed

  5. Save the product

Repeat for each service type you want to offer.

circle-check
2

Create resources and set availability

Resources are what your service needs to happen - team members, rooms, equipment, etc. You'll create them and set their availability.

circle-info

Note: In the current Shopify Admin interface, resources are labeled as "Team Members". This will be updated to "Resources" in an upcoming release.

  1. Open Sesami in your Shopify Admin

  2. Navigate to Team Members (Resources)

  3. Click Add Team Member and create your resources:

    • For staff: Add each team member by name (e.g., "Sarah", "Alex", "Jamie")

    • For rooms/equipment: Add them as team members for now (e.g., "Room 1", "Camera Kit A")

  4. For each resource, set their availability:

    • Click on the resource name

    • Go to the Availability tab

    • Add availability rules (e.g., Monday-Friday, 9:00 AM - 5:00 PM)

    • Save the schedule

Example setup:

  • Team member "Sarah" → Available Monday-Friday, 9 AM - 5 PM

  • Room "Treatment Room 1" → Available Monday-Saturday, 8 AM - 8 PM

See: Resources Guide | Availability Setup

3

Link services to resources

Tell Sesami which resources are needed for each service:

  1. Open Sesami in your Shopify Admin

  2. Navigate to Services

  3. Select a service product

  4. Go to the Resources section

  5. Choose which resource types are required:

    • Select Team member if the service requires a staff member

    • Select Room if the service requires a physical space

    • Select Equipment if specific tools are needed

  6. Optionally, assign specific resources:

    • Check Specific resources only to limit the service to certain team members or rooms

    • Leave unchecked to allow any available resource of that type

  7. Save

Example configurations:

  • Haircut: Requires "Stylist" (any stylist can do it)

  • Facial Treatment: Requires "Esthetician" + "Treatment Room" (both needed)

  • Private Training: Requires specific resource "Personal Trainer - Sarah" only

circle-exclamation
4

Add booking to your storefront

Make the booking calendar accessible to customers on your online store:

Option 1: Theme App Embed (Recommended - Modern Themes)

Most Shopify 2.0 themes support app embeds:

  1. In Shopify Admin, go to Online Store > Themes

  2. Click Customize on your active theme

  3. Click on App embeds (usually in the left sidebar or theme settings)

  4. Enable the Sesami app embed

  5. Save

The booking calendar will now automatically appear on your service product pages.

Option 2: Manual Integration (Older Themes)

For older themes without app embed support:

  1. In your theme editor, add a button or link to product pages

  2. Link to the product page with the Sesami calendar active

  3. Or contact support for theme-specific integration help

See: Shopify Online Store Setup

circle-check
5

Test end-to-end

Before going live, test a complete booking flow:

  1. Open your store in an incognito/private browser window (to see the customer view)

  2. Navigate to a service product page

  3. Check that the booking calendar appears with available time slots

  4. Select a date and time

  5. Add to cart and proceed through checkout

  6. Complete the purchase (use Shopify's test mode or make a real booking)

  7. Verify the booking appears in Sesami Admin under Bookings

  8. Check on mobile - Test the same flow on a mobile device

What to verify:

  • Available time slots match your resource availability

  • Correct timezone is displayed

  • Booking appears assigned to the correct resource

  • Times don't overlap if you book multiple appointments

circle-exclamation

Troubleshooting

chevron-rightCalendar doesn't appear on the product pagehashtag

Check:

  1. Sesami app embed is enabled in Theme Settings (Step 5)

  2. Product has sesami-service tag in Shopify

  3. Sesami is enabled in Sesami Settings

  4. You're viewing the published theme (not a draft/unpublished version)

  5. Service is configured in Sesami with the product linked

chevron-rightService is not working or shows errorshashtag

Check:

  1. Product is added as a service in Sesami

  2. Resources are assigned to the service (Step 3)

  3. Required resources are enabled (not disabled)

  4. Duration variant format is correct (e.g., "30 Minutes", "1 Hour" - no extra spaces, in English)

chevron-rightNo available time slots showinghashtag

The most common issue! Check:

  1. Resources are assigned to the service (Step 3)

  2. Availability is set for assigned resources (Step 2)

  3. Timezone is correct in Sesami Settings

  4. Booking window allows future bookings (check advanced settings)

  5. No block-offs are covering all available dates

See: No Availability

chevron-rightTimezone looks wronghashtag
  1. Go to Sesami > Settings > Timezone

  2. Verify your store's timezone matches your physical location

  3. Check resource availability is set in the correct timezone

  4. Clear browser cache and test in incognito mode

See: Timezone Mismatch

chevron-rightCheckout behavior is unexpectedhashtag

If checkout is skipped when you expected it (or vice versa):

  1. Check if Instant Booking is enabled (skips checkout)

  2. Verify deposit settings (may change checkout flow)

  3. Review product pricing (free products may skip checkout)

See: Instant Booking | Deposits

chevron-rightBooking shows "Assigned to: No one"hashtag

This happens when time slots become unavailable during checkout:

  1. Enable Reservation Period in Sesami Settings

  2. Enable Cart Validation to check availability before checkout

See: Troubleshooting Assigned to No One


Next Steps

Once you have basic bookings working, consider:


Need Help?

Last updated

Was this helpful?