Initial Setup Guide
Get your school up and running with ClassHub in under an hour. This guide covers the essential setup steps and planning decisions you'll need to make.
Setup Overview
Setting up ClassHub involves five main steps, completed in order:
- Configure your school settings
- Plan and create your lesson structure
- Add teachers and assign lesson permissions
- Add students and create contracts
- Create your schedule
Planning Your Setup
ID Schema Planning
Before creating any data, plan your ID naming convention. IDs are permanent and cannot be changed once saved. IDs are not case sensitive. They display in all caps.
Choose clear IDs that your staff can easily understand. IDs are used internally for identification and for user login. Uniform length IDs work best for searching and organization.
Example ID formats:
- Admin Staff: Employee/member ID (e.g.,
A1234) - Teachers: Employee/member ID (e.g.,
T1234) - Students: Student/member ID (e.g.,
12345) - Lessons: Short codes (e.g.,
PV1,GRP-A,CONV)
If your school already has member IDs or student numbers, use those! The system searches both user ID and name fields, so unique IDs make searching more efficient. Names are not unique—IDs should be.
Password Strategy for Existing Users
If you're transitioning existing users to ClassHub, decide how passwords will be set:
✅ Recommended Method
Self-Service Password Setup
Users set their own passwords via the "Forgot Password" link. Requires valid email addresses for all users.
⚡ Alternative Method
Manual Password Entry
Manually enter passwords via user profile pages. More time-consuming but works without email addresses.
Understanding How ClassHub Works
The most important concept to understand before setup is how ClassHub handles lessons. Take time to understand this section—it will save you hours of confusion later.
Note: For clarity in this guide, we'll refer to the unit cost as "Credits" (whether you display them as Points or Tickets in your school)
The Three Building Blocks
🔷 Lesson (Template/Definition)
A lesson is a template that defines a type of class. It's not a scheduled class—it's a category or product with a set cost in credits.
Examples: "Private Weekday Lesson", "Group Conversation Class", "Weekend Premium Class"
🔷 Lesson Slot (Scheduled Time)
A slot is a specific time block on your calendar with an assigned teacher (or other service provider). One slot can have multiple lesson types assigned to it.
Example: Monday 9:00 AM slot with "Private Weekday" AND "Private Anytime" lessons assigned
🔷 Contract (Student's Access)
A contract provides students with credits to book lessons and defines which lesson types they can book. The monetary cost is set independently.
Example: 10 credits + "Private Weekday" (2 credits) and "Group Class" (1 credit) bookable + ¥30,000 monthly price
How They Work Together: The Matching System
When a student looks at the booking site, they only see slots that have at least one lesson type from their contract(s).
This flexible system allows you to control three different things:
- Availability (who can book when) - Control which students see which time slots
- Pricing (how many credits it costs) - Charge different credit amounts for the same time slot
- Content (what they're learning) - Let students choose lesson topics at booking time
Choosing Your Structure
Most schools will immediately recognize which structure matches their current system:
Scenario 1
Choose this if:
- You sell plans with different access levels e.g. "Weekday Only", "Anytime".
- All lessons in a plan use the same number of credits.
- Your plans define the number of bookings e.g 4 times per month, 50 times per year.
- You want to restrict which days/times students can book
Scenario 2
Choose this if:
- Your student contracts are based on a credit/point/ticket system wherein the number of credits is defined, but the number of lessons is not.
- Different times or content use different credit amounts
- Students manage their own credit usage
- Students choose lesson topics at booking
Let's look at how to set up your system for each scenario.
Scenario 1: Controlling Availability
The Setup:
Step 1: Create lesson types for each plan type
PV-WD- Display Name: "Private Lesson" | Description: "Weekday membership" | Credit(s): 1PV-ANY- Display Name: "Private Lesson" | Description: "Anytime membership"| Credit(s): 1
Step 2: Set availability restrictions
PV-WD: Available Monday-Friday, 9 AM-5 PM onlyPV-ANY: Available all days
Step 3: Assign lessons to teachers
- Give each teacher both lesson types (they can teach both membership types)
Step 4: Add appropriate lessons to student contracts
- Weekday membership students: Add only
PV-WD - Anytime membership students: Add only
PV-ANY - In both cases the number of credit(s) in the contract should equal the number of booking possible in the period.
Step 5: When creating schedule slots
- Weekday daytime slots (Mon-Fri): Assign BOTH
PV-WDANDPV-ANY - Weekday evening and weekend slots: Assign only
PV-ANY
✅ What Students See:
- Weekday students: Only weekday slots (9 AM-5 PM Mon-Fri)
- Anytime students: All slots (weekdays + weekends)
Scenario 2: Credit-Based System
You have a credit-based system where different times or teachers use different credit amounts.
Real-world example: Students have 60 credits/month. Weekend lessons use 15 credits, weekday lessons use 10 credits. Students manage their credit usage freely.
The Setup:
Step 1: Create lesson types for each price tier
PV-STD- 10 credits per lessonPV-PREM- 15 credits per lesson
Step 2: Assign lessons to teachers
- Give teachers both lesson types
Step 3: Add BOTH lessons to student contracts
- Student contract: 60 credits/month
- Contract includes:
PV-STD(10 credits) +PV-PREM(15 credits)
Step 4: When creating schedule slots
- Weekday morning/afternoon slots: Assign
PV-STD(uses 10 credits) - Weekend & evening slots: Assign
PV-PREM(uses 15 credits)
✅ What Students See:
- All time slots are visible
- They can see the credit cost for each slot
- They choose when to spend more or fewer credits
- Example: Book 6 standard lessons (60 credits) OR 4 premium lessons (60 credits) OR a mix
Extension: Content Choice
Scenario 2 can also be used for content selection where students choose what type of lesson they want when booking (conversation, grammar, test prep, etc.).
Use when: Students can choose lesson topic at booking time.
Example Setup:
CONV- Display Name: "Conversation Practice" (10 credits)GRAM- Display Name: "Grammar Focus" (10 credits)PRON- Display Name: "Pronunciation Training" (10 credits)
Student contract includes all three lesson types. When booking:
- Monday 9 AM slot shows dropdown with all three options
- Student selects what they want to study that day
- Each choice uses the specified credits from their balance
- Lessons can use the same or different credit amounts
Combining Scenarios
You can combine these approaches! For example:
Complex Example: Availability + Content Choice
Lessons created:
CONV-WD- Available Mon-Fri, 10 creditsCONV-ANY- Available all days, 15 creditsGRAM-WD- Available Mon-Fri, 10 creditsGRAM-ANY- Available all days, 15 credits
Student A (Weekday membership):
- Contract includes:
CONV-WD+GRAM-WD - Sees only weekday slots
- Can choose conversation or grammar at booking
- Uses 10 credits per lesson
Student B (Anytime membership):
- Contract includes:
CONV-ANY+GRAM-ANY - Sees all slots (weekday + weekend)
- Can choose conversation or grammar at booking
- Weekday slots use 10 credits, weekend slots use 15 credits
Result: You control availability (membership tier), pricing (different credit amounts), AND content choice with one system.
When you use the schedule Quickbuild tool and select a teacher and time, ClassHub automatically adds lessons that:
- The teacher is qualified to teach (assigned in teacher setup)
- Have availability matching that day/time
Step 1: Configure School Settings (~5 minutes)
Customize ClassHub with your school's branding and basic information.
- Navigate to Settings → School Profile
- Confirm all settings are correct and fill out where needed
📚 Complete School Settings Guide
School settings can be changed at any time. However, existing lesson slots on the live schedule will retain their original settings and won't be automatically updated.
Step 2: Create Lessons (~10 minutes)
Based on the scenario you chose above, create your lesson types.
- Navigate to Lessons in the main navigation
- Click New
- Fill in the lesson information:
- Lesson ID: Choose a permanent ID (e.g.,
PV1,CONV,GRP-A) - Display Name: What students see (e.g., "Private Lesson", "Conversation Practice")
- Description: Internal staff reference (e.g., "Weekday membership only")
- Type: Individual or Group
- Price/Credits: Cost per lesson in credits
- Availability: Set day and time restrictions
- Lesson ID: Choose a permanent ID (e.g.,
- Click Save
- Repeat for all lesson types in your system
Lesson duration is set at the school level in Settings and applies to all lessons by default. You can override this when creating individual lesson slots manually or in the fixed schedule template.
📚 Complete Lesson Management Guide
Lesson costs and availability can be changed later, but existing slots on the schedule will not be automatically updated. You'll need to update those slots manually or recreate them.
Step 3: Add Teachers (~10 minutes)
Add your teaching staff and assign them the lessons they can teach.
- Go to Teachers in the main navigation
- Click New
- Fill in teacher information:
- User ID: Use your school's employee/member ID system (e.g.,
T1234) - Name: Full name (required)
- Email: Not required, but needed for lesson reminders and password reset
- Phone: Contact number (optional)
- User ID: Use your school's employee/member ID system (e.g.,
- Assign lessons this teacher can teach:
- Select from the lessons you created in Step 2
- This determines which lessons will auto-populate when creating schedule slots
- Example: If Teacher John can teach conversation and grammar, assign both lesson types
- Click Save
- Click on the newly saved teacher and enter Edit mode to set their password or have them use the forgot password link
📚 Complete Teacher Management Guide
Step 4: Add Students and Create Contracts (1~2 minutes per student)
Add your students and create contracts with the appropriate lesson types.
- Navigate to Students
- Click New
- Enter student information:
- User ID: Use your school's existing student/member ID (e.g.,
12345) - Name: Full name (required)
- Email: Not required, but needed for lesson reminders and password reset
- Phone: Phone number (optional)
- User ID: Use your school's existing student/member ID (e.g.,
- Click Save
- After saving, click New in the Contracts section
- Create their contract 📚 Contract Fields Explained
- Click on the newly saved Student and enter Edit mode to set their password or have them use the forgot password link
📚 Complete Student Management Guide | Contract Management Guide
Step 5: Create Your Schedule
Now build your actual schedule of lesson slots.
Creating Slots with Quickbuild
- Go to Schedule → Create
- Switch to Week or Day view
- Click Create - a menu slides down above the calendar
- Select:
- Teacher
- Location (with optional +Online)
- Click any time on the calendar - slot created instantly!
- Lessons automatically populate based on:
- What the teacher can teach
- Which lessons are available at this day/time
- Click on the created slot to see details, verify settings, and book lessons
For more granular control over slot settings, you can create slots manually from the calendar or list view. These options allow you to customize individual slot settings beyond the automatic Quickbuild defaults.
Testing Your Setup
- Create a few test slots using Quickbuild
- Click on each slot to verify the correct lesson types are assigned
- Try booking a test student into a slot and then cancelling the lesson
- Using a test student, experiment with the admin overrides of the following:
- Lesson Rules - Allows you to book a Lesson that a student does not have access to in their contract. Credit requirements still apply
- Booking Rules - *Only for if you are using the Booking Limit control in contracts* Allows you to book a lesson for a student who does not have remaining bookings. Credit requirements still apply
- Cancel Limit - Return the credits for the lesson regardless of the slot's Cancelable Until time, and do not count this cancellation toward the contract's Cancellation Limit
Next Steps & Advanced Features
Congratulations! Your ClassHub system is now operational. Here are additional features to explore:
Recommended Next Steps
- Set Up Fixed Schedule Template: Create a weekly template and apply it to multiple weeks instantly—essential for large, regular schedules
- Add Additional Admin Users: Give office staff access to manage the system
- Configure Other Bookings: Set up non-lesson bookings (staff meetings, training, school events)
- Learn About Contract Management: Managing monthly (repeating) contracts and tracking payments
- Student Booking Site: Link your website to the student login page
All ClassHub plans include onboarding assistance. We're happy to walk through setup with you via video call or answer questions via email. We can help you:
- Determine which lesson structure scenario fits your school best
- Plan your lesson types and naming conventions
- Review your setup before going live
- Troubleshoot any issues