Skip to main content

Create a New Class Template

This is where you create a new class template — a reusable blueprint for classes you offer at your gym or studio. Think of it like designing a recipe card: you define what the class is called, how long it lasts, when it starts, and all the other d...

Written by Ronny Christensen
Updated over 3 weeks ago

What This Screen Does

This is where you create a new class template — a reusable blueprint for classes you offer at your gym or studio. Think of it like designing a recipe card: you define what the class is called, how long it lasts, when it starts, and all the other details. Once saved, you can use this template over and over to schedule actual classes on your calendar without re-entering the same information each time.


How to Get There

  1. Open the dashboard.

  2. In the left-hand menu, click Class Template.

  3. Click the + New Class Template button in the top-right corner.

  4. You are now on the Create Class Template screen.


Step-by-Step Guide

The form is split into two sections: Details (basic information about the class) and Planning (scheduling and timing settings).

1. Upload a Background Image (optional)

  • At the top of the details section you will see an image upload area.

  • Click it to open the file picker on your computer.

  • Select an image (JPEG, PNG, or GIF) that represents the class.

  • This image may be shown on public-facing class listings, depending on your setup.

  • If you skip this, the class template will have no background image.

2. Fill In Class Details

These fields describe what the class is:

Field

Required

What to Enter

Name

Yes

The name of the class (e.g. “Morning Yoga”, “HIIT Blast”).

Description

No

A short explanation of what the class involves. This may be shown to members when they browse classes.

Category

Yes

Pick a category from the dropdown (e.g. “Yoga”, “Strength”, “Cardio”). This helps organise your class offerings.

Instructors

No

Select one or more instructors who typically teach this class. You can leave this blank and assign instructors later.

Location / Gym

Yes

Choose which gym or location this template belongs to. It defaults to your currently selected gym.

Max Participants

No

The maximum number of people who can sign up for each session. Leave blank for unlimited.

Color

No

Pick a colour for the class. This colour appears on the calendar so you can quickly tell classes apart.

3. Configure Planning & Scheduling

These fields control when and how the class runs:

Field

Required

What to Enter

Begins

Yes

The date when this class template becomes active. Pick a date from the date picker.

Duration

Yes

How long each class session lasts (in minutes).

Recurrence / Days

No

Which days of the week this class should repeat on.

Time

Yes

The start time for the class.

4. Set Opt-Out Time (optional)

The opt-out time controls how far in advance a member must cancel their booking. This prevents last-minute cancellations.

Field

Required

What to Enter

Change Opt-Out Time

No

Toggle this on if you want a custom cancellation window for this class. If left off, the system default is used.

Opt-Out Time (Hours)

No

Number of hours before class start that members can still cancel. Only shown when the toggle above is on.

Opt-Out Time (Minutes)

No

Additional minutes for the opt-out window. Combined with the hours field above. Only shown when the toggle is on.

  • If both hours and minutes are set to 0, no custom opt-out time is sent to the server, and the system default applies.

5. Save

  • Click the Create button at the bottom-right of the form.

  • The system will:

    1. Validate all your inputs across both the Details and Planning sections.

    2. Create the class template record.

    3. Upload the background image (if you added one).

    4. Redirect you to the class template list.

  • You will see a green “Create success!” notification at the bottom of the screen.


What Happens Behind the Scenes

You click "Create"
        |
        v
Both forms validate all fields (Details + Planning)
        |
        v
If validation fails → form shows errors, submission stops
        |
        v
API call: ClassTemplatesService.create({ body: formData })
        |
        v
Class template record is created, server returns the new template (with ID)
        |
        v
(If background image was added)
API call: ClassTemplatesService.setBackgroundImage({ id, files: [image] })
        |
        v
Success notification: "Create success!"
        |
        v
You are redirected to /class-templates (the class template list)


Troubleshooting

“I filled everything in but nothing happens when I click Create”

  • Make sure all required fields are filled in across both sections (Details and Planning).

  • Look for small red error messages below the fields — they tell you exactly what is wrong.

  • Scroll through the entire form; the error might be on a field that is not currently visible on your screen.

“I see a red error banner at the top of the form”

  • This means the server rejected your request. Read the message carefully — it usually explains the problem.

  • Common causes include duplicate template names, missing required data that was not caught by the front-end, or a temporary server issue.

  • If the message is unclear, try again. If it keeps happening, contact your administrator with the exact error text.

“My background image did not upload”

  • The image must be a JPEG, PNG, or GIF.

  • Make sure the file is not too large. If the template was created but the image failed, go back to the template and edit it to re-upload the image.

“I do not see any categories in the dropdown”

  • Categories are loaded from the server when the page opens. If the list is empty, try refreshing the page.

  • If the problem continues, check your internet connection or ask your administrator to verify that categories have been set up.

“I do not see any gyms or locations to select”

  • You must have at least one gym or location set up in the system before creating a class template.

  • If you are new to the platform, ask your administrator to set up a gym under the Chain or Gym settings first.

“The form keeps resetting or I lose my changes”

  • Do not navigate away from the page before clicking Create. The form does not auto-save.

  • If the page refreshes unexpectedly, check your internet connection — a brief disconnection can cause the page to reload.

“I want to set an opt-out time but I do not see the hours and minutes fields”

  • You need to turn on the Change Opt-Out Time toggle first. The hours and minutes fields only appear when this toggle is enabled.

  • If you leave both hours and minutes at 0, the system will use the default opt-out time instead.

“I created the template but it does not appear on the calendar”

  • A class template is a blueprint, not a scheduled class. You need to use the template to create actual class sessions on the calendar.

  • Check that the Begins date is set to today or a past date if you want to start using it immediately.

“I get a network error when I try to save”

  • Check your internet connection and try again.

  • If you are on a slow connection, the image upload may time out. Try saving without the image first, then add it later by editing the template.

  • If the problem persists, contact your system administrator — the server may be temporarily unavailable.

Did this answer your question?