Create a public quiz competition linked to any quiz, let students join and compete, and watch the live leaderboard fill up with ranked scores.
A quiz competition lets you host an event where participants take the same quiz and compete for the top spot on a live leaderboard. Perfect for school quizzes, organization knowledge contests, community challenges, and anything else where you want ranked results automatically.
This walkthrough creates a Bangla general knowledge quiz with 5 MCQs, publishes it as a public competition, and shows two students joining and taking the quiz with different scores — resulting in a ranked leaderboard.
You need an existing quiz with questions to link to the competition. If you haven't created a quiz yet, see the Online Quiz / MCQ tutorial first.
Any user can visit /competitions to browse all active public competitions on the platform.
As an admin, go to /admin/competitions to see the full list (including drafts and ended competitions).
Click New Competition to open the creation form.
Fill in the key fields:
New competitions are created as draft — only visible to you. Change the status to live to make it visible on the public /competitions page so students can join.
After creating, the admin detail page shows all participants, quiz submissions, leaderboard, and edit controls.
Students open /competitions and see your live competition listed with its title, organization, and cover image.
Clicking the card opens the competition detail page with the description, dates, participant count, and a Join Competition button.
After clicking Join, the page updates to show a green Joined ✓ badge and a Start Quiz button. The student's name is now in the participant list.
Clicking Start Quiz takes the student to /competitions/:id/quiz/attempt — the standard quiz attempt page, but the submission gets tagged to the competition automatically.
The student answers the questions, submits, and sees their result.
Right after Rahat submits, the leaderboard shows him at rank #1 with 5/5 (100%).
When Sumaiya joins and submits with 3/5 (60%), the leaderboard updates in real time showing both participants ranked by score.
Back in the admin panel, the competition detail now shows both participants with their scores, time taken, and submission times.
That's the full free quiz competition flow:
This tutorial covers the free, public quiz competition flow. These features work for any competition type and will be covered in dedicated tutorials: