Help Guide
MatMgr Help Center
Welcome to the MatMgr Help Center. Find everything you need to manage your martial arts academy effectively.
Getting Started
Welcome to MatMgr!
MatMgr is a comprehensive management platform designed specifically for martial arts academies. Here's how to get started:
- Navigate to Settings → Academy Profile
- Add your academy name, address, and contact information
- Upload your academy logo (recommended size: 200x200px)
- Set your operating hours and time zone
- Configure your class schedule
- Go to Admin → Belt Ranks
- MatMgr comes with common belt ranks pre-configured
- Customize ranks to match your academy's system
- Add stripe levels if your academy uses them
- Set rank colors for visual identification
You have several options for adding students:
- Manual Entry: Add students one at a time via Admin → Students → New Student
- Bulk Import: Upload a CSV file with student data
- Self-Registration: Enable student self-registration and share your registration link
- Navigate to Admin → Billing → Setup
- Connect your Stripe account for payment processing
- Set up billing items (tuition packages, fees, etc.)
- Configure automated billing schedules
Account Management
Managing Your Account
User Roles
| Role | Permissions |
|---|---|
| Owner | Full access to all features, billing, settings, and user management |
| Admin | Manage students, attendance, events, and reports (no billing access by default) |
| Instructor | Take attendance, view student info, manage their classes |
| Front Desk | Check-in students, basic student lookup, process store sales |
| Family/Student | View their own profiles, attendance history, upcoming events |
Profile Settings
- Update Profile: Click your name → Account Settings
- Change Password: Settings → Security → Change Password
- Two-Factor Authentication: Enable 2FA for additional security
- Notification Preferences: Customize email and in-app notifications
Adding Staff Members
- Go to Admin → Staff
- Click Invite Staff Member
- Enter their email address and select a role
- They'll receive an invitation email to set up their account
Student Management
Managing Your Students
Adding a New Student
- Navigate to Admin → Students
- Click + New Student
- Fill in required information:
- Name and date of birth
- Contact information
- Emergency contact
- Current belt rank
- Start date
- Optionally add: photo, medical notes, family members
- Click Save Student
Student Profiles
Each student profile includes:
- Overview: Quick stats, current rank, attendance summary
- Attendance History: Complete training log
- Rank History: All promotions and testing records
- Billing: Payment history and current balance
- Notes: Private notes visible only to staff
- Documents: Waivers, contracts, certifications
Bulk Operations
- Import Students: Upload CSV with student data
- Export Students: Download student list as CSV/Excel
- Bulk Status Update: Mark multiple students active/inactive
- Bulk Messaging: Send messages to selected students
Family Accounts
MatMgr supports family accounts where one parent/guardian manages multiple students:
- Link students to a family account
- Single login for parents to view all children
- Consolidated billing per family
- Family discounts can be applied automatically
Classes & Schedule
Managing Your Class Schedule
Setting Up Classes
- Go to Admin → Classes
- Click + New Class
- Configure the class:
- Class name (e.g., "Beginner Taekwondo", "Adult Sparring")
- Age division (Little Tigers, Kids, Teens, Adults, All Ages)
- Default instructor
- Maximum capacity
- Description
Class Sessions
Each class can have multiple sessions (recurring time slots):
- Day of Week: Select which day the session occurs
- Start/End Time: Set the class duration
- Instructor: Override the default instructor if needed
- Room/Location: Specify where the class meets
Managing Sessions
- Click on a class to view its details
- Use the Sessions tab to add/edit time slots
- Sessions automatically appear on the public schedule
- Students can enroll in specific sessions
Class Enrollment
Students can be enrolled in classes from:
- The class detail page (add students)
- The student profile (assign to classes)
- Self-enrollment through the family portal
Public Schedule
Your class schedule is automatically displayed on the public website at /academy/schedule. The schedule shows:
- Weekly calendar view of all sessions
- Class names and times
- Age division filters
- Instructor information
Attendance
Tracking Attendance
Check-In Methods
QR Code Check-In
Students scan their personal QR code at a tablet or kiosk. Fast and contact-free.
Name Search
Staff searches for student by name and clicks to check them in.
Class Roster
Instructors take attendance from a class roster, marking present/absent.
Self Check-In
Students check themselves in via the family portal.
Attendance Types
- Training: Regular class attendance
- Helping: Instructor assistants helping with class (earns helping credit)
- Private Lesson: One-on-one training sessions
- Open Mat: Informal practice time
- Event: Seminars, tournaments, special events
Attendance Awards
MatMgr can automatically track and award attendance milestones:
- Configure milestones (e.g., 50 classes, 100 classes)
- Automatic notifications when students reach milestones
- Print certificates for achievements
- Track streaks (consecutive weeks/months)
Private Lessons
Managing Private Training Sessions
Setting Up Instructors
- Go to Admin → Lessons → Instructors
- Click Add Instructor
- Select from students marked as instructors
- Configure instructor settings:
- Display name (how they appear to students)
- Default lesson duration (30, 45, or 60 minutes)
- Hourly rate
- Default location
- Cancellation policy (hours notice required, fee)
Instructor Availability
Set when instructors are available for lessons:
- Recurring Slots: Weekly availability (e.g., Mondays 3-6pm)
- One-Time Slots: Special availability for specific dates
- Vacation Blocks: Block out dates when unavailable
Booking Lessons
Lessons can be booked by:
- Admin: From the lessons page or student profile
- Students/Families: Through the family portal (if enabled)
The booking wizard guides users through:
- Select student (for family accounts)
- Choose instructor
- Pick available date
- Select time slot
- Confirm booking
Lesson Management
- View All Lessons: Admin → Lessons → All Lessons
- Filter by: Status, instructor, date range
- Mark Complete: Triggers billing for the lesson
- Mark No-Show: Records no-show (can still charge)
- Cancel: With optional late cancellation fee
Instructor Dashboard
Instructors can view their own lessons from the Lessons menu:
- Upcoming lessons with student details
- Mark lessons as complete
- Monthly statistics
Earnings Reports
Track instructor earnings via Admin → Lessons → Earnings Report:
- Filter by instructor and date range
- View completed lessons, no-shows, and cancellation fees
- Total earnings per instructor
Belt Ranks & Promotions
Managing Belt Ranks
Setting Up Ranks
- Go to Admin → Belt Ranks
- Add/edit ranks with:
- Rank name and order
- Belt color (for display)
- Minimum requirements (classes, time in rank)
- Testing fee (if applicable)
- Use stripes for intermediate progress
Promoting Students
Students can be promoted in several ways:
- Individual Promotion: From the student's profile → Promote
- After Testing: Promote from test results page
- Bulk Promotion: Promote multiple students at once
Promotion Requirements
Configure automatic eligibility checking based on:
- Minimum classes attended
- Time at current rank
- Age requirements
- Required curriculum completion
- Account in good standing (billing)
Rank History
MatMgr maintains complete promotion history including:
- Date of each promotion
- Who performed the promotion
- Test scores (if applicable)
- Notes and comments
Events & Testing
Managing Events
Event Types
- Belt Tests: Rank examinations with sign-ups
- Seminars: Special training sessions
- Tournaments: Competition events
- Social Events: Parties, movie nights, etc.
- Camps: Multi-day training programs
Creating an Event
- Go to Admin → Events → New Event
- Fill in event details:
- Title, date, time, and location
- Description and requirements
- Capacity limits (if any)
- Registration fee (if applicable)
- Registration deadline
- Set visibility (all students, specific ranks, etc.)
- Enable/disable online registration
Belt Testing Workflow
- Create Test Event: Set date, eligible ranks, testing fee
- Open Registration: Eligible students can sign up
- Review Candidates: Approve/deny registrations
- Conduct Test: Use the testing interface to grade
- Record Results: Pass/fail with scores and notes
- Promote: Bulk promote passing students
Event Attendance
Track who attended each event:
- Mark attendance from event page
- QR code check-in for events
- Event attendance shows on student profiles
Billing & Payments
Managing Billing
Setting Up Billing
- Go to Admin → Billing → Setup
- Click Connect with Stripe
- Complete the Stripe onboarding process
- Configure your billing items and tuition packages
Billing Items
Create reusable billing items for:
- Monthly tuition (various packages)
- Registration/enrollment fees
- Testing fees
- Equipment and gear
- Private lessons
- Event fees
Creating Charges
- Go to Billing → Charges → New Charge
- Select the student or family
- Add billing items
- Set due date
- Send invoice via email (optional)
Automated Billing
Set up recurring charges:
- Configure tuition billing cycle (monthly, quarterly, annual)
- Set billing day of month
- Automatic pro-rating for mid-month enrollments
- Family discounts applied automatically
Payment Methods
Families can pay via:
- Credit/debit cards (saved on file)
- Bank transfers (ACH)
- Cash/check (record manually)
Gear Store
Managing Your Pro Shop
Store Setup
- Go to Admin → Store → Settings
- Configure store settings:
- Enable/disable the store
- Set tax rate percentage
- Configure pickup instructions
- Set minimum order amount (optional)
Managing Categories
- Go to Admin → Store → Categories
- Create categories like: Uniforms, Sparring Gear, Weapons, Apparel
- Set display order for how categories appear
- Categories help organize products for easy browsing
Adding Products
- Go to Admin → Store → Products
- Click + New Product
- Enter product details:
- Name and description
- Price and SKU
- Category
- Product image URL
- Active/inactive status
- For products with sizes, add size variants with individual stock levels
Product Variants (Sizes)
Products can have multiple size variants:
- Each variant has its own stock quantity
- Variants can have price adjustments
- Common sizes: XS, S, M, L, XL, XXL, or numeric sizes
- Stock is tracked per variant
Order Management
Orders flow through several statuses:
| Status | Description |
|---|---|
| Pending | New order, awaiting processing |
| Processing | Order is being prepared |
| Ready | Ready for pickup/delivery |
| Completed | Order fulfilled and picked up |
| Cancelled | Order was cancelled |
Pick Lists
Efficiently fulfill multiple orders:
- Go to Admin → Store → Pick Lists
- Select orders to include in the pick list
- Generate a printable list showing all items needed
- Mark orders as ready once picked
Store Reports
Available at Admin → Store → Reports:
- Sales summary by period
- Top selling products
- Revenue breakdown
- Inventory status
Communication
Communicating with Students & Families
Messaging
- Direct Messages: Send private messages to individuals
- Announcements: Broadcast to all students or specific groups
- Email Integration: Messages can be sent via email too
Sending a Message
- Go to Messages → Compose
- Select recipients (individuals, ranks, all students)
- Write your message
- Choose delivery method (in-app, email, or both)
- Send immediately or schedule for later
Automated Communications
MatMgr can automatically send:
- Birthday greetings
- Attendance milestone congratulations
- Testing eligibility notifications
- Payment reminders
- Event reminders
- Inactivity check-ins
News & Blog
Sharing News with Your Community
Creating Posts
- Go to Admin → News → New Post
- Enter post details:
- Title and content (rich text editor with formatting)
- Category (Announcements, Events, Training Tips, etc.)
- Featured image URL
- Excerpt (auto-generated if blank)
- Set publish options:
- Draft: Save without publishing
- Scheduled: Publish at a future date/time
- Published: Publish immediately
Post Features
- Pin to Top: Keep important posts at the top of the listing
- Notify Members: Send email notification when published
- Archive: Hide old posts without deleting them
Managing Categories
- Go to Admin → News → Categories
- Default categories: Announcements, Events, Training Tips
- Add custom categories as needed
- Categories help organize posts and improve navigation
Rich Text Editor
The post editor supports:
- Text formatting (bold, italic, underline)
- Headings (H2, H3, H4)
- Bulleted and numbered lists
- Links and images
- Tables
- Video embeds
Public News Page
News posts are displayed at /news on your public website:
- Pinned posts appear first
- Paginated listing (10 posts per page)
- Category filtering
- SEO-friendly URLs
- Reading time estimate
Reports & Analytics
Understanding Your Data
Available Reports
| Report | Description |
|---|---|
| Attendance Summary | Daily, weekly, monthly attendance trends |
| Student Roster | Complete list with contact info, ranks, status |
| Rank Distribution | Breakdown of students by belt rank |
| Testing Eligibility | Students who meet promotion requirements |
| Revenue Report | Income by category, period, payment method |
| Outstanding Balances | Students with unpaid charges |
| Retention Analysis | Student retention and churn metrics |
| Inactive Students | Students who haven't attended recently |
Dashboard
Your admin dashboard shows key metrics at a glance:
- Today's attendance and check-ins
- Active student count
- Revenue this month
- Upcoming events
- Recent activity feed
Exporting Data
Most reports can be exported as:
- CSV (for Excel/Google Sheets)
- PDF (for printing/sharing)
Family Portal
For Students & Parents
Family Portal Features
- Dashboard: Overview of all family members' training
- Attendance History: View all past and recent attendance
- Rank Progress: See current rank and history
- Upcoming Events: Browse and register for events
- Messages: Communicate with the academy
- Billing: View charges, make payments, manage payment methods
- Store: Purchase gear and uniforms
- Profile: Update contact information
Profile Switching
Family accounts can switch between profiles:
- Click your name in the top navigation
- Select a different family member
- View their specific dashboard and history
Self Check-In
If enabled by your academy, students can:
- Check in via the family portal
- Use QR codes for quick check-in
- View their QR code in the app
Troubleshooting
Common Issues & Solutions
- Verify you're using the correct email address
- Try the "Forgot Password" link to reset your password
- Check if your account has been deactivated (contact your academy)
- Clear your browser cache and cookies
- Try a different browser or incognito mode
- Refresh the page or dashboard
- Check if the correct date is selected
- Verify the student's status is "Active"
- Ensure the check-in was completed (not just started)
- Contact your academy if attendance was recorded manually
- Verify your card information is entered correctly
- Check if your card has sufficient funds
- Try a different payment method
- Contact your bank if the card is being declined
- For academy admins: Check your Stripe dashboard for error details
- Ensure camera permissions are granted to the browser
- Check lighting conditions (avoid glare)
- Hold the QR code steady and at the right distance
- Try the manual name search as a backup
- Clear browser cache and reload the page
Still Need Help?
Contact our support team:
- Email: support@matmgr.com
- Response time: Within 24 hours (business days)