User Guide

How to Use Quizpio

Quizpio turns your WordPress site into a live, multiplayer quiz game. You build a quiz with the block editor, players join from any device with a PIN and a nickname, and everyone plays together in real time on a shared leaderboard — the kind of fast-paced game you’ve seen at conferences and classrooms, running entirely on the site you already own. No apps, no subscriptions, no third-party service.

This guide walks through everything from installing the plugin to running your first live session and reading the results afterward.

Getting started

Install from your dashboard (recommended)

1. Go to Plugins → Add New and search for “Quizpio”.
2. Click Install Now, then Activate.

Or install manually

1. Go to Plugins → Add New → Upload Plugin, choose the Quizpio .zip, click Install Now, then Activate; or
2. Via FTP, extract the quizpio folder into /wp-content/plugins/ and activate it from the Plugins page.

After activating, you’ll find a Quizpio menu in your admin sidebar. It contains everything you need: a Dashboard, your Quizzes, Sessions history, a Players list, and Settings. There’s nothing you have to configure before creating your first quiz — the defaults are sensible out of the box.

Building a quiz

Each quiz is a normal piece of WordPress content with its own page and URL, so you manage quizzes much like Posts or Pages.

1. Go to Quizpio → Add New Quiz.
2. Give the quiz a title at the top.
3. The editor opens with a Quizpio Quiz block already in place, containing one Quizpio Question block to get you started.
4. Fill in the first question, then add more questions with the + Add question button inside the quiz block. (The quiz block only accepts question blocks, so you can’t accidentally drop the wrong thing inside it.)
5. Publish when you’re done.

To run the quiz, click View on the quiz (from the Quizzes list or the editor) to open its page — that page is where you’ll host the live session.

Two block-editor concepts to keep straight:

• The Quizpio Quiz block is the container. Its settings (in the editor sidebar when the quiz block is selected) control how the whole quiz behaves — scoring, reveals, and pacing. See Quiz settings.
• Each Quizpio Question block is one question. Its settings control that single question — its type, time limit, and points.

Question types and polls

Select a Quizpio Question block to see its settings in the sidebar.

Question type offers two options:

• Multiple choice (4 options) — four answer options; mark one as correct.
• True / False — a statement with True and False as the two options; mark the correct one.

Switching a question’s type resets its answers, so choose the type before writing the options.

For each question you also set:

• Time limit (seconds) — how long players have to answer.
• Max points — how many points a correct answer is worth.
• The answer options themselves, with one marked Correct.

Quiz settings

Select the Quizpio Quiz block (the container) to find these in the sidebar. They apply to the entire quiz.

• Scoring style. Speed bonus (the default) rewards faster correct answers, scaling each correct answer between 50% and 100% of the question’s max points. Flat gives every correct answer the full point value regardless of speed — the right choice for assessments, where being quick shouldn’t earn more than being right.
• Reveal correct answer between questions. When on, a reveal screen appears after each question showing the correct answer and how many players chose each option. Turn it off to move straight from one question to the next.
• Show full standings to players. When on, players see the complete leaderboard on the Final Results screen. When off, they see the top 10 plus their own rank.
• Require host to click Next between questions. By default the quiz advances on its own. Turn this on to switch to manual pacing — the quiz waits for you to advance it, which is ideal for classroom discussion or a debrief between questions.

Embedding a quiz in a page or post

If you’d rather run the quiz from inside an existing page or post than at its own URL:

1. Edit the page or post where you want the quiz.
2. Add a Quizpio Quiz Embed block.
3. Pick the quiz you want from the dropdown.
4. Publish.

The quiz now plays at that location. Only one Quizpio Quiz Embed block is supported per page or post, but you can embed different quizzes on different pages. Sessions always belong to the quiz itself, so results from an embedded play roll up into that quiz’s history alongside every other session — wherever it was played.

Hosting a live session

Open the quiz’s page (its own URL, or the post where you embedded it). You’ll see the host controls.

1. Launch the session. Click Launch Session. Quizpio creates a session and shows you a PIN.
2. Share the PIN. Read it out, put it on the projector, or share the join link. As players join, you’ll see them appear while the screen shows Waiting for players….
3. Start the quiz. When everyone’s in, click Start Quiz at the top to display the first question.
4. Run it. While a question is live you can Skip to Reveal (or Skip to Next when reveals are off) to move ahead before the timer ends. Use Pause and Resume to hold the room, and a paused quiz shows players a clear “⏸ Quiz paused by host” banner.
5. Watch the leaderboard. A live leaderboard updates as answers come in. On wide screens it sits beside the question; on phones it stacks below. You can toggle it with ⊞ Show LB / ⊟ Hide LB.
6. Move between questions. If you turned on Require host to click Next, the quiz waits for you between questions; otherwise it advances automatically. Each reveal screen shows the correct answer, the vote count per option, and the standings going into the next question.
7. Finish. When you reach the end (or whenever you choose), use End Quiz / End & Show Results to close the session and show everyone the final results. You’ll be asked to confirm before the quiz ends.

The host view survives a page refresh, so an accidental reload won’t drop your session.

The player experience

Players don’t need an app or an account (unless you require one — see Guests vs. logged-in players). On any device — phone, tablet, or laptop:

1. Visit the quiz page and look for Join the live quiz.
2. Enter the Quiz PIN and a nickname, then tap Join Quiz. (Logged-in users have their nickname prefilled from their WordPress profile.)
3. Each player gets a color avatar generated from their nickname, so they have a consistent visual identity that recurs across sessions.

Once a question appears, players tap their answer, then see Submitted. Waiting… until the question ends. The leaderboard always shows a player’s own row — even when they’re outside the top — marked with a YOU badge, so everyone can see where they stand.

Leaving. A Leave option appears on every question and reveal screen. After a confirmation (“Leave quiz? You won’t be able to rejoin this session.”), the player exits cleanly without disrupting anyone else. Any points they’ve already earned stay on the leaderboard, but they can’t rejoin that same session. Players still waiting in the lobby leave fully — their entry is simply removed.

Refreshing and reconnecting. A player who refreshes the page, loses connection, or closes the tab can come back and pick up where they left off. Their identity is kept in the browser for up to 6 hours, or until that session ends — whichever comes first.

Final results

When the host ends the quiz, everyone sees the Final Results screen:

• A podium with medal cards for the top three finishers.
• Summary stats for the session.
• The full standings, if you enabled Show full standings to players (otherwise players see the top 10 plus their own rank).
• A per-question recap showing accuracy across the quiz.
• A “Held on” byline with the date, time, and duration — for example, May 17, 2026 · 2:30 PM · 12 min — shown in each viewer’s own local time.

Top-three finishers get a celebratory confetti burst on their own screen, and the host’s results screen celebrates too. (All motion respects the visitor’s reduced-motion preference — see Accessibility.)

From the results screen, players can choose Play another quiz, and the host can Start a new session or download the results as a CSV with ⬇ Download CSV. Logged-in players also get a My past plays button to review their history.

Guests vs. logged-in players

Quizpio works for anonymous guests and logged-in members alike, and you choose which you allow.

Guests play with just a nickname — no account, no friction. This is the default.

Logged-in WordPress users get a richer experience:

• Their nickname prefills from their profile.
• A My past plays button (on the join and Final Results screens) opens a personal history of every session they’ve played on your site.
• They appear in the Players admin page, so you can see who’s been playing across sessions.

Both kinds of player play the same quiz. To require accounts and turn off anonymous play, switch off Allow guest players in Quizpio → Settings.

Settings

Find these under Quizpio → Settings.

• Background refresh interval (seconds). How often players’ browsers check for updates. Lower feels more responsive but asks more of your server; higher is gentler but can feel laggy. A good rule of thumb is to keep the interval around one-third of your shortest question’s time limit.
• Reveal pause (seconds). How long the reveal screen between questions stays up.
• Allow guest players. On by default. Switch off to require players to be logged in.
• Data cleanup. Quizpio never deletes anything on its own. When you want to clear space, you can delete sessions before a date, or wipe all session data (you’ll be asked to type DELETE to confirm). Either way, only the play history is removed — your quizzes are never deleted.

Sessions and reporting

Dashboard (Quizpio → Dashboard) gives you an at-a-glance view with overall stats, a callout for any active session with a one-click way to open the host view, and a list of recent sessions.

Sessions (Quizpio → Sessions) is the full history. You can filter by quiz and page through past sessions. Open any session to see its detail: the final leaderboard plus a per-question breakdown showing how the room answered each question.

Exporting results. From a session’s detail page — or the ⬇ button next to an ended session — you can export a CSV. Each row covers one player’s answer to one question and includes: nickname, rank, score, question number, question text, the option they selected, the correct answer, whether they were correct, points awarded, and their response time in milliseconds. The file is named from the quiz and the session date, so downloads stay easy to sort.

Players (Quizpio → Players) lists your registered (logged-in) players with sessions played, best score, and when they last played, and lets you click through to an individual player’s history. This page covers logged-in users; anonymous guests aren’t tracked here by design.

Accessibility

Quizpio is built to be usable by everyone:

• The whole quiz interface is keyboard-navigable, with ARIA roles and live regions so screen readers announce each change of phase (a new question, a reveal, the final results).
• The interface carries its own styling rather than inheriting from your theme, so it behaves consistently on every site and renders in your device’s native system font — type that looks at home on Mac, Windows, or Android.
• All motion, including the end-of-quiz confetti, respects the visitor’s reduced-motion setting. If someone’s system asks for less motion, Quizpio honors it.

Hosting, caching, and performance

How many players can join? There’s no fixed limit — it scales with your hosting. Because each player’s browser polls your server for updates, the real ceiling is how many of those requests your host can serve. On entry-level shared hosting, Quizpio comfortably runs classroom-sized rooms of 50–100 players; a stronger host handles more.

No special infrastructure. Quizpio runs on standard WordPress — no Node.js, no WebSocket server, no external service.

Cache plugins. Quizpio is built to work alongside page-cache plugins (WP Rocket, W3 Total Cache, LiteSpeed Cache, and others). It sends no-store headers on its live endpoints, declares the page non-cacheable during a session, and adds a cache-busting parameter on every update check — which covers nearly every real-world setup. The Quizpio → Compatibility page checks your site and flags anything worth knowing.

Troubleshooting

• Players can’t join with the PIN. Make sure you’ve clicked Launch Session (the PIN only exists once a session is launched) and that players are entering the current session’s PIN. PINs are specific to a session — a PIN from an earlier session won’t work.
• Someone is stuck on an old screen. This is almost always page caching. Check the Compatibility page, and if needed exclude /wp-json/quizpio/* in your cache plugin.
• Updates feel slow or laggy. Lower the Background refresh interval in Settings, keeping it around one-third of your shortest question time. If your host is under heavy load, a slightly higher interval trades a little responsiveness for stability.
• A player left and wants back in. A player who left (via the Leave button) can’t rejoin that same session — that’s intended. A player who merely refreshed or lost connection can rejoin automatically within the 6-hour window. To bring a departed player back, start a new session.
• “Please sign in to join this quiz.” Anonymous play is turned off. Either sign in, or have the site owner enable Allow guest players in Settings.

Translating Quizpio

Quizpio is translation-ready and ships with a quizpio.pot file in its languages/ folder. Use a tool like Poedit or Loco Translate to create a translation, and place the resulting .po/.mo files in wp-content/languages/plugins/.

Uninstalling and your data

Quizpio keeps your data under your control. It never deletes sessions automatically — clearing play history is always something you choose to do in Settings. If you uninstall the plugin, Quizpio cleanly removes its own database tables and options, leaving your site tidy.

Need a hand or want to report something? Reach us at quizpio.com/contact.