1. Getting Started
Tabulous is a comprehensive platform designed to streamline the management of debate tournaments. Whether you're running a small local competition or a large international championship, Tabulous provides all the tools you need to organize, execute, and analyze your tournament efficiently.
Initial Setup
- Create an Account:
Visit the Tabulous homepage and click the "Login" button in the top right corner. Then click "Sign Up" to create your account. You'll need to provide a valid email address and create a secure password.
Alternative: You can also sign up using OAuth providers (Google, GitHub, etc.) for quick and secure authentication.
- Complete Your Profile:
After signing in, set up your profile with your name, institution, and other relevant details.
Creating Your First Tournament
- Start the Creation Process:
From the home page, click the green "New Tournament" button located in the top right corner of the page.
- Fill in Tournament Details:
A modal will appear asking for essential tournament information. You'll need to provide:
- β’Tournament Name: A clear, descriptive name
- β’Format: Choose from BP, World Schools, Australs, or Asian Parliamentary
- β’Dates: Start and end dates of the tournament
- β’Location: In-person (with city/country) or online
- β’Level: University, School, or Mixed
- Submit and Navigate to Your Tournament:
After creating your tournament, you'll need to access it from your "my-tournaments" page.
Important: Accessing Your Tournament After Creation
After creating a tournament, it will appear on the home page. To access your tournament:
- Click on the user icon in the top right corner of the navigation bar
- Select "My Tournaments" from the dropdown menu
- You'll see your newly created tournament listed under "Upcoming"
- Click on the tournament to access the tournament's dashboard
- Click on the "Admin" button to access the tournament's admin dashboard
Understanding User Roles
Tabulous supports different user roles, each with specific permissions and capabilities:
π― Tournament Admin
Full control over tournament settings, participants, rounds, draws, and results. Can add other admins and manage all aspects of the competition.
βοΈ Judge
Can access assigned ballots, submit results, and provide feedback. Views rounds they're assigned to adjudicate.
π£οΈ Debater
Can view draw, motions, and results. Receives notifications about round assignments and tournament updates.
Accessing the Admin Dashboard
After creating your tournament and navigating to it via "My Tournaments", you'll need to access the admin dashboard to manage your tournament:
- Navigate to your tournament page (via My Tournaments)
- Look for the "Admin" button
- Click the "Admin" button to access the full admin dashboard
What You Can Do in the Admin Dashboard:
- βReview and update tournament settings
- βApprove participant registration requests
- βCreate and manage teams
- βSet up rounds with motions and generate draws
- βManage ballots and view results
Pro Tip
Watch our video tutorial for a visual walkthrough of the entire tournament setup process. You can access it from the sidebar or by clicking the "Tutorial" button on the home page.
2. Participants
Managing participants is a crucial step in organizing your tournament. Users can only join through registration requests.
Share Your Tournament Link
To invite participants, you need to share your tournament link with them. You can find your tournament's unique URL in your browser's address bar when viewing the tournament page (e.g., tabulous.com/tournaments/your-tournament-name).
When non-admin users visit your tournament page, they'll see a "Register" button in the top right corner where they can submit their registration request.
How Participant Registration Works
Users can only join your tournament through registration requests. Here's the complete process:
1.User Submits Registration Request
Interested participants visit your tournament page using the link you shared with them. Non-admin users will see a "Register" button in the top right corner of the tournament page.
When they click "Register", they'll be prompted to select their role (Debater or Judge) and can optionally include a message with their request.
2.You Receive the Request
As a tournament admin, you'll receive a notification about the new registration request. Navigate to Admin β Participants to view all pending requests.
3.Review and Approve/Reject
In the Participants section of the Admin panel, you'll see a list of all registration requests with details about each user. You can:
- β’ View the user's profile and requested role
- β’ Read any message they included with their request
- β’ Accept the request to add them to your tournament
- β’ Reject the request if they don't meet your requirements
4.User Receives Confirmation
Once you approve a request, the user will receive a notification confirming their participation. They'll then appear in your participants list and can be assigned to teams.
Managing Your Participant List
After approving participants, you can manage them from the Participants section:
- β’View All Participants: See a complete list of accepted debaters and judges
- β’Filter by Role: Separate views for debaters and judges
- β’Remove Participants: Remove users if they can no longer attend
- β’Track Status: Monitor pending, accepted, and rejected requests
Important Note
All participants must register through the registration request system. There is no way to directly add participants without them submitting a request first. This ensures that all participants actively consent to join your tournament.
3. Teams
Once participants are accepted, you need to organize debaters into teams.
Team Management
Navigate to Admin β Teams from your tournament's admin dashboard.
Creating Teams Manually
Step 1:Enter Team Name
In the "Create New Team" section, enter a descriptive name for the team. Team names should be unique and easily identifiable.
Step 2:Select Team Members
Choose debaters from the participant list. The system provides several helpful features:
- β’Filter by name: Search for specific participants
- β’Filter by institution: Find participants from specific schools/universities
- β’Mutual Match indicators: Participants who selected each other as preferred partners are highlighted with a green background and "Mutual Match" badge
- β’Partner Selected badges: Shows when you've selected a participant's preferred partner
- β’Participants already in teams are grayed out and cannot be selected
Step 3:Create the Team
Click the "Create Team" button to finalize the team. The selected participants will be added to the team and removed from the available participants list.
Managing Existing Teams
Viewing Teams
All created teams are displayed in the "Existing Teams" section. For each team, you can see:
- β’Team name
- β’All team members' names
- β’Member details (institution, preferred partner, categories)
Filtering Teams
Use the filter input at the top right of the "Existing Teams" section to search teams by name. This is helpful for tournaments with many teams.
Deleting Teams
Click the trash icon next to any team to delete it:
- β’A confirmation dialog will appear
- β’Deleted team members become available for selection again
- β’This action cannot be undone
4. Rounds
Rounds are the core structure of your tournament. Each round requires a name, motion(s), and participating teams and judges. Navigate to Admin β Rounds to get started.
Creating a Round
Follow these steps to create a new round:
Step 1:Choose Round Type
At the top of the Create Round page, you'll see options for different round types:
- β’Regular Round (Default): Standard preliminary rounds where all teams and judges participate
- β’Out Round (Break Round): For elimination rounds with only broken teams and judges. You'll need to select a break category (Open, ESL, EFL, High School, U18, U16, U14, Novice)
- β’Silent Round: Results will be hidden from participants (useful for surprise announcements)
- β’Finals Round: When creating an out round, you can mark it as the final round of the tournament
Step 2:Enter Round Name
Give your round a clear, descriptive name. Examples:
- β’ Round 1, Round 2, Round 3... (for preliminary rounds)
- β’ Quarterfinals, Semifinals, Grand Final (for break rounds)
- β’ ESL Final, Open Semifinals, etc.
Step 3:Add Motion(s)
Every round requires at least one motion (debate topic). You can:
- β’Add a Single Motion: Standard approach where all debates use the same motion
- β’Add Multiple Motion Options: Click "Add Motion Option" to create a pool of motions for debaters to vote on. This allows democratic motion selection.
- β’Include Info Slides: Optionally add context or clarifications for each motion
Step 4:Select Participating Teams
Choose which teams will participate in this round:
- β’For regular rounds: All teams are pre-selected by default
- β’For out rounds: Only teams that have broken in the selected category will be available
- β’You can manually select/deselect individual teams or use "Select All" / "Unselect All"
Step 5:Select Participating Judges
Choose which judges will adjudicate this round:
- β’For regular rounds: All judges are pre-selected by default
- β’For out rounds: Only judges that have broken in the selected category will be available
- β’Ensure you have enough judges for your teams (typically 1-3 judges per debate)
Step 6:Create the Round
Click the "Create Round" button at the bottom of the page. The round will be created with a DRAFT status, allowing you to review and make changes before publishing it to participants.
Understanding Break Categories
For out rounds, you'll need to select which break category the round is for. Teams and judges must be marked as "broken" in their respective category (done in the Break tab) before they'll be available for selection:
- β’Open: Main break category for all teams
- β’ESL/EFL: English as Second/Foreign Language categories
- β’Age Categories: U18, U16, U14 for age-restricted breaks
- β’High School/Novice: For school-level or beginner competitions
Team Pairing Algorithm
The team pairing algorithm determines how teams are matched in the draw. This is set in Tournament Settings and applies to all rounds:
- β’High-High: Pairs teams of similar strength (1st vs 2nd, 3rd vs 4th, etc.)
- β’High-Low: Pairs strongest vs weakest (1st vs last, 2nd vs 2nd-last, etc.)
- β’Swiss System: Pairs teams with similar records who haven't faced each other
- β’Random Power Protected: Random pairing while protecting top teams
- β’Round Robin: Every team faces every other team exactly once
Important: Before Creating Break Rounds
Before you can create an out round for a specific break category, you must first mark teams and judges as "broken" in that category from the Admin β Break tab. If you try to create an out round without any broken teams or judges, you'll receive an error message.
5. Draws
The draw determines which teams debate against each other, which judges adjudicate each debate, and where debates take place. Tabulous provides manual draw management with flexible team and judge assignment.
Creating a Draw
After creating a round, navigate to Admin β Draws to set up the draw:
1.Select Your Round
Click on the round you want to create a draw for. The round must be in DRAFT or UNPUBLISHED status to be modified.
2.Create Rooms (Debates)
Click the "Add Room" button to create individual debate rooms. Each room represents one debate that will take place.
- β’Add as many rooms as needed for the number of debates in your round
- β’For BP format with 4 teams per debate, you'll need fewer rooms
- β’For 2-team formats, you'll need approximately half as many rooms as participating teams
3.Assign Teams to Rooms
For each room, assign the competing teams:
- β’Click "Add Team" within a room
- β’Select teams from the dropdown of available teams
- β’BP format: Assign 4 teams per room and set their positions (OG, OO, CG, CO)
- β’2-team formats: Assign 2 teams per room and set their sides (Proposition/Opposition)
4.Assign Judges to Rooms
For each room, assign the judging panel:
- β’Click "Add Judge" within a room
- β’Select judges from the dropdown of available judges
- β’Assign judge roles: Chair (main judge who submits the final ballot), Panel (additional judges), or Trainee (observing judges)
- β’Each room should have at least one Chair judge
5.Assign Room Names/Locations
Optionally assign physical room names or locations:
- β’Use the "Room Assignment" dropdown for each debate room
- β’Select from your pre-configured room names (e.g., "Room 101", "Main Hall", "Online Room A")
- β’This helps participants know where to go for their debates
6.Publish the Round
Once your draw is complete:
- β’Click the "Publish" button on the round
- β’This makes the draw visible to all participants
- β’Teams and judges can now see their room assignments and opponents
- β’Judges can access their ballots to fill out after debates
7.Control Motion Visibility
After publishing the round, you can control when participants see the motion(s):
- β’By default, motions are hidden from participants when a round is first published
- β’To make motions visible, click the blue "Show Motion" button on the round
- β’This allows you to publish the draw first, then release the motion when debates are about to begin
- β’Once public, all participants can see the motion and infoslide in the Draws page
- β’The button changes to an amber "Hide Motion" button if you need to make it private again
Modifying Published Draws
You can make changes to the draw even after publishing:
- β’While a round is PUBLISHED, you can still add/remove teams, judges, and rooms
- β’If you need to make major changes, click "Unpublish" first
- β’Changes made to published rounds are immediately visible to participants
- β’Once a round is COMPLETED, no modifications can be made
Round Status Flow
Important: Motion Visibility Control
To make motions visible to participants, the round must first be PUBLISHED, and then you must explicitly click the "Show Motion" button (shown in blue). This two-step process gives you control over exactly when participants can see the debate topics, allowing you to publish the draw and room assignments first, then release the motion at the appropriate time. Once public, the button changes to "Hide Motion" (shown in amber) if you need to make it private again.
Pro Tip: Power-Protected Pairing
While Tabulous provides manual draw creation, the tournament's sorting algorithm (set in Settings) will influence how teams should be paired based on their performance in previous rounds. Consider team rankings when manually creating matchups to ensure fair and competitive draws.
6. Ballots
Ballots are used to record debate results, including team rankings and speaker scores. After a round is published, assigned judges can access and fill out their ballots.
For Judges: Accessing and Filling Out Ballots
1.Finding Your Ballots
Once a round is published and you've been assigned as a judge, you'll receive a notification. To access your ballots:
- β’Click on your user icon in the top right corner of the navigation bar
- β’Select "Ballots" from the dropdown menu
- β’You'll see all your assigned ballots organized into two tabs: "Available" (ballots you need to fill out) and "Completed" (ballots you've already submitted)
2.Understanding Ballot Information
Each ballot card displays important information:
- β’Tournament name and round name
- β’Motion and infoslide (if provided)
- β’Room assignment (where the debate takes place)
- β’Your role: Chair (you submit the final ballot) or Panel judge (you may or may not need to submit depending on tournament settings)
3.Filling Out a Ballot
Click the "Fill Out" button on any available ballot to begin:
- β’Rank the teams: Assign rankings to all teams in the debate (1st, 2nd, 3rd, 4th for BP format; 1st, 2nd for two-team formats)
- β’Score the speakers: Enter speaker scores for each debater (typically on a scale of 60-80 or as configured by the tournament)
- β’Add feedback (optional): Provide constructive feedback for teams and speakers if the tournament has enabled this feature
- β’Submit the ballot: Once all required fields are filled, click "Submit Ballot" to finalize your decision
4.After Submission
Once you submit a ballot, it moves to the "Completed" tab. You can still view your submitted ballots, but you cannot edit them after submission. If you need to make changes, contact a tournament administrator.
Chair-Only Ballot Filling
Some tournaments are configured for "chair-only ballot filling." In this mode, only the chair judge needs to submit a ballot for the room. Panel judges will not see these ballots in their "Available" tab and will not receive notifications to fill them out.
For Admins: Managing Ballot Submission
1.Accessing Ballot Management
Navigate to Admin β Ballots Management from your tournament's admin dashboard.
2.Monitoring Ballot Status
Select a round to view detailed ballot status:
- β’Completion summary: See a progress bar showing how many ballots have been completed
- β’Room-by-room breakdown: View each room's status, including assigned judges, teams, and submission status
- β’Judge completion: See which judges have submitted their ballots and which haven't
3.Filling Out Ballots on Behalf of Judges
As an admin, you can create or edit ballots for any judge:
- β’In the "Admin Actions" column, click "Create" for judges who haven't submitted yet, or "Edit" for those who have
- β’This is useful if a judge is unavailable or having technical difficulties
- β’The ballot will be submitted on behalf of that judge
4.Auto-Fill Ballots (Testing Feature)
For testing purposes, admins can use the "Auto-Fill All Ballots" button:
- β’This automatically generates scores and rankings for all incomplete ballots in the round
- β’Useful for testing tournament workflows without manually entering data
- β’The round must be in "Published" status to use this feature
5.Refreshing Status
Click the "Refresh Status" button at the bottom of the page to update the ballot completion status in real-time as judges submit their ballots.
Important: Ballot Submission and Round Completion
Before completing a round, ensure all ballots have been submitted. The system will warn you if there are incomplete ballots when you attempt to mark a round as completed. Once a round is completed, no further modifications can be made to ballots or the draw.
7. Results
Tabulous provides multiple ways to view tournament results and track team/speaker performance. Results are automatically calculated based on submitted ballots and updated in real-time.
Accessing Results Pages
All results pages can be accessed through the tournament's navigation bar at the top of the tournament page. Simply click on the desired tab to view that type of results.
Understanding Access Permissions
Different results pages have different visibility rules:
π Standings (Live Results)
- β’Visible: During active tournaments (before completion)
- β’Who can see: All users (participants and public)
- β’Shows current rankings as rounds are completed
π Team Tab & Speaker Tab (Final Results)
- β’Visible: Only when tournament is marked as "Completed"
- β’Exception: Tournament admins can always view these tabs
- β’Shows comprehensive final rankings and statistics
π Results (Round-by-Round)
- β’Visible: When there is at least one completed round
- β’Who can see: All users (participants and public)
- β’Admins can also view published rounds (even before completion)
Available Results Pages
1.Standings
Live tournament rankings shown during the tournament:
- β’Current team rankings based on completed rounds
- β’Team points and cumulative speaker scores
- β’Updates automatically as rounds are completed
- β’Available to everyone during active tournaments
2.Team Tab
Comprehensive team rankings and statistics (available after tournament completion):
- β’Final team rankings with total points
- β’Cumulative speaker scores for each team
- β’Win/loss records
- β’Click on any team name to view their detailed team record
3.Speaker Tab
Individual speaker rankings (available after tournament completion):
- β’Complete ranking of all speakers in the tournament
- β’Average speaker scores across all rounds
- β’Team affiliation for each speaker
- β’Hover over team names to see team members
4.Results (Round-by-Round)
Detailed results for each completed round:
- β’Select a specific round to view its results
- β’See team placements and points for that round
- β’View speaker scores for each team in the round
- β’Admins can view published rounds before they're completed
5.Team Record (Individual Team View)
Detailed performance data for a specific team:
- β’Access by clicking on a team name in the Team Tab
- β’Round-by-round breakdown of team performance
- β’Shows placement, points, and speaker scores for each round
- β’Lists judges who adjudicated each of their debates
- β’Includes team position/side for each round (OG, OO, CG, CO for BP)
- β’Link to view the ballot for each round
Important: When Results Become Visible
The Team Tab and Speaker Tab are designed to show final, official results and are only visible to the public after a tournament is marked as "Completed." During the tournament, participants can view live rankings in the Standings page instead. Tournament admins have access to all results pages at all times for preview and verification purposes.
Real-Time Updates
All results pages automatically update as ballots are submitted and rounds are completed. You need to manually refresh the page to see the latest results.
8. Testing
Test mode lets tournament admins safely generate and manage test-only data (participants, teams, rounds, draws, ballots) without affecting real data. When enabled, pages clearly indicate that you are viewing only test data.
Enabling Test Mode
- Open your tournament admin dashboard (Admin button on the tournament page).
- Use the Test Mode toggle in the header to switch test mode on/off.
- A yellow banner appears when test mode is active. While active, most admin pages show only test data.
Important
Test data is stored separately and hidden when test mode is off. You can safely create and delete test data without impacting real participants or teams.
Participants Management in Test Mode
In test mode, the Participants page shows a dedicated βAdd Test Participantsβsection and filters all tables and stats to show only test participants.
Adding test users
- Enable test mode via the admin header toggle.
- Go to Admin β Participants.
- In βAdd Test Participantsβ, choose a role (Debater or Judge).
- Use the slider to select how many available test users to add (already-added users are automatically excluded).
- Click Add. New test participants are inserted as Accepted with your chosen role.
- Participant lists and statistics show only test participants while test mode is on.
- You can still update Status, Payment, and Withdrawal toggles on test participants.
- Chief Adjudicator can be toggled for accepted judges. Role changes are blocked if a debater is already in a team.
- You can edit categories and institution for test participants exactly like real ones.
Teams Management in Test Mode
In test mode, the Teams page shows only test teams. Creating teams while test mode is on marks them as test teams automatically, and the participant selector lists only test participants.
Creating test teams
- Enable test mode via the admin header toggle.
- Go to Admin β Teams.
- Enter a team name and select debaters (only test participants appear).
- Click Create Team. The team is saved as a test team.
Auto-create test teams (admins)
- Click Auto-Create Teams to batch-create teams from available test debaters.
- Team sizes follow the tournament format (e.g., 3 for World Schools, 2 otherwise).
- Mutual partner preferences are honored first for 2-member formats.
- Only test teams are shown while test mode is on; deleting here affects only test data.
Creating Rounds and Test Mode
On the Admin Create page, new rounds inherit the current mode. If Test Mode is enabled, created rounds are marked as test rounds and will only appear when viewing the site in test mode.
- When you toggle test mode on, the Create page shows a banner indicating that created rounds will be test rounds.
- Test rounds are filtered everywhere else unless test mode is enabled.
- Break/out round creation respects test mode and will only allow selecting teams/judges visible in the current mode.
Draws Management and Test Mode
The Draws Management page strictly separates test and real data:
- Only rounds matching the current mode are listed (test rounds when test mode is on; real rounds otherwise).
- Team and judge pickers filter to test teams/judges in test mode and real teams/judges when not in test mode.
- If there are no rounds for the current mode, youβll see a contextual message (e.g., βNo Test Rounds Createdβ).
Ballots Management and Test Mode
Ballots Management filters by both round status and mode:
- Shows only PUBLISHED or COMPLETED rounds that match the current mode (test vs real).
- Room ballot status entries are filtered to test ballots when in test mode and real ballots otherwise.
- In test mode, admins/organizers can use Auto-Fill Ballots to generate test results for the selected test round (useful for demos).
Viewing Test Data Across Tabs
Many tournament pages provide a test mode toggle for organizers. Use it to switch between real and test views:
- Teams Tab: Toggle to view test teams and related standings specific to test data.
- Speakers Tab: Toggle to view speaker stats computed from test rounds and ballots.
- Results: Toggle to refresh and display rankings/results derived from test rounds only.
- Draws (public/participant pages): Show only draws from rounds matching the current mode; server-side pages cache real data, while test data loads client-side when enabled.
- Motions, Participants, and Institutions: Where applicable, lists and counts reflect only the data for the current mode.
Need Help?
If you encounter any issues or have questions, check out our tutorial video or contact support.
Best Practices
- β’Set up all teams before generating the first draw
- β’Review draws before publishing to participants
- β’Monitor ballot submission progress regularly
- β’Keep participants informed about tournament schedule changes