Getting started

From install to the first customer booking, including the two steps that happen outside the app.

Before you start

You need a Shopify store you can install apps on, and a rough idea of how your venue runs: opening hours, how many people fit in the space at once, how long a session is, and what you want to sell.

1. Install Repose

Until Repose is listed on the Shopify App Store we install it with you. Ask for early access and we send an install link for your store. Approve the permissions it asks for; each one is there for a reason the privacy policy explains.

Repose opens on a Getting started page the first time you visit, with eight steps in order: venue, what people book, first offer, waiver, booking block, checkout check, the Repose cards, and notices. It ticks each one off from real data where it can see it, and you tick the two it cannot. Come back to it from the menu at any time, or press Start again. The steps below are the same ones, in more words.

2. Set up your location

Repose creates one location for you, called Main, with neutral defaults: Monday to Friday, 9 to 5, ten people. Open Locations and make it yours:

  • Timezone. Every time the app shows is in the location’s timezone.
  • Opening hours for each weekday, and any closed dates.
  • Venue ceiling. The most people who can be in the space at once, across everything that shares it.
  • Start times. How far apart the start times you offer customers are, for example every 15 minutes.

Add more locations if you have more sites. Each has its own timezone, hours, ceiling and resources. See Locations and resources.

3. Set up what can be booked

Each location comes with one resource, called Session: 60 minutes long, with a 15-minute buffer either side. Change it to match your space, and add others if you have several bookable things, such as a sauna and an ice bath with different lengths.

For each resource you set the session length, the buffer between users, how many places it has, and whether it counts against the venue ceiling.

4. Decide the shop-wide rules

On Settings:

  • Cancellation notice. How long before a start time a customer can cancel and get their credit back.
  • Credit expiry. How long a bought credit lasts. Free passes have their own, shorter, life.
  • Booking horizon. How far ahead customers can book, and the separate, longer horizon your staff can book to.
  • Email. The switch for all email from the app, an optional logo for customer emails, and the address of your booking page so the emails can link to it. Refer to Customer emails.
  • Opening day. Only if you sell before you open. Customers cannot book a time before it, and what they buy before it starts on that day. Refer to Running the desk.

On Waiver, the wording customers agree to before their first booking, with a small editor for headings and lists, and whether a change to it makes everyone agree again. A venue that needs no waiver switches it off here. See Waivers and cancellations.

5. Create something to sell

Customers book with credits or under a membership, and both come from ordinary Shopify products. Two ways to make one:

  • Offers → New offer in Repose. Choose single visit, pack of visits, membership or gift card, give it a name and a price, and Repose creates the product in Shopify for you, as a draft until you say otherwise. Membership needs the Pro plan; on Free and Standard that choice is switched off.
  • The Repose card on any product page in your Shopify admin. Press Edit Repose settings, say what the product sells, fill in the matching fields and save.

Either way the Offers page then shows the product, what it grants, and any warning. For a membership that renews, Repose takes the payments through Shopify once you set Membership payment in its Repose settings, so you do not need a separate subscriptions app. See Offers and Memberships.

6. Add the booking block to your theme

The second step outside the app. Customers book through a block that lives on your storefront.

  1. In Shopify, go to Online Store → Themes → Customize.
  2. Open the page where you want booking to happen, for example a “Book” page.
  3. Add block and choose Session booking from the Repose app.
  4. Choose a Width for the block if your theme squeezes it, and pin it to a location or an option if you have more than one. Save.

Until this is done, nothing on your store is bookable, however complete the app looks. The Getting started page reminds you.

Then add the other blocks that you use. A block does not show until you add it, and Shopify does not tell the app when you add it:

  • Repose back to booking, on the Thank you page. Go to Settings → Checkout → Customize, select the Thank you page, then Add block, Apps. A customer who paid for a held time sees a link back to the booking.
  • Quick book, in the theme editor. Add it only if walk-ins pay as a guest for the next start. Guest checkout is necessary for it.
  • Membership plan, in the theme editor on each membership product page, and the Repose membership page and Repose membership link in your customer accounts editor. Only if you sell memberships paid through Repose. Refer to Memberships.
  • The Repose tiles on each Shopify POS till, if your desk uses POS. Refer to Shopify POS.

Blocks and tiles to add, at the bottom of the Getting started page, shows the booking blocks, the Thank you block, the Repose cards and the POS tiles. The Where customers see Repose card on the Today page links to the booking block, the Membership plan block and the member’s page.

7. Pin the Repose cards

Shopify lets you add an app’s card to its product and customer pages. The Repose card on a product page is where offers are set up; the one on a customer page shows what that customer holds. Neither is required, but both save opening a second screen. Tick the step on Getting started once they are there, since the app cannot see it.

8. Make a test booking

Place a test order for a product that grants credits, using a customer account you control. Open the booking block on your store, sign in as that customer, tick the waiver, pick a day and take a time. Then open Today in the app and find it.

If the booking does not appear, the order is the first place to look: does it contain a product the Offers page recognises, and did it reach paid?

What happens next

Bookings from customers count toward your plan. A Shopify development store is unlimited, so testing genuinely costs nothing there. An open store’s free plan gives you 100 customer bookings in total before you need to choose a paid plan.