# Run a live quiz or wall

> Bring phones into one room where answers change the tally live.

Kind: recipe · ~5 min · Verified v0.127.10 · Next: [A design review of a prototype](https://pr-2128-stg.superartifacts.app/docs/recipes/prototype-review.md)

## Goal

Bring phones into one room where answers change the tally live.

## What you’ll have

![A science quiz opens with a question everyone can answer.](https://pr-2128-stg.superartifacts.app/screenshots/docs/recipes-live-room-light.302ca815.webp)

*A science quiz opens with a question everyone can answer.*

## Prompt

**Run a live quiz or wall.** Your agent builds the page and checks the result with you.

```prompt
Help me run a live quiz in Super Artifacts. Ask for the audience size, the questions, and whether the score counts for anything. A room holds up to 500 open pages on every plan, but my workspace runs only so many live rooms at once (one on Free): call super_whoami and tell me if liveRooms shows another artifact holding one. For fun or practice, read live-quiz with super_templates (scope marketplace if it is not installed), fill its quiz slot, preserve its data declaration and publish with super_publish. If the quiz is graded, do not use that template, because its answer key travels inside the page: build the page yourself with the key in a stream only the owner reads, following super_help live. Keep it private with super_artifact_set and arrange the audience I choose. Explain that the host screen is my own signed-in page, or a named Editor’s, and return the joining link. Help me test two phones in the same room and verify that the live tally changes. If joining fails, check access and whether another artifact holds the live room; if the tally is still, check the live connection.
```

## Needs

- Questions, a host and phones with a connection.
- A free live room. A room holds up to 500 phones on every plan, and your workspace runs a set number of rooms at once (one on Free); see [Live rooms](https://pr-2128-stg.superartifacts.app/docs/concepts/live-rooms.md).
- A quiz for fun or practice. The template's answer key travels inside the page; for a score that counts, use the [quiz prompt](https://pr-2128-stg.superartifacts.app/docs/shared-pages.md) instead.

## Steps

1. **A free room**

   The agent checks that no other artifact of yours holds the live room.

2. **A live page**

   The live-questionnaire template supplies ordered questions, a projector screen and a phone view: polls, clouds, text, scales, ranking, 100 points, Q&A and casual quizzes. Owners and named Editors present while signed in.

3. **Phones join**

   Scan the QR or open the address. Guests need no account. Signed-in visitors join in one tap; email is ignored. Optional public quiz nicknames are unverified. Without one, shared Restricted readers see platform names; public and organization readers see pseudonyms. The host can link responses and remove leaderboard entries.

4. **The tally moves**

   Answers arrive live. Locking and visibility are separate controls. Private results stay off the projector and public board; raw answers belong to their submitter and the owner.

## Check it worked

Two phones change the tally without reloading. Reload restores an accepted answer. End finishes phones; Exit preserves the room.

## If not

- **A phone cannot join:** The prompt asks the agent to check access.
- **The header says live is paused:** another of your artifacts holds the room. Answers still save; close that artifact's tabs or turn its live connections off, and the page joins within 20 seconds.
- **The tally is still:** The prompt asks it to check the live connection and that both phones joined the same room.

Practice quizzes use client deadlines and duplicate filtering; direct API writes can bypass them. Public visitor tokens do not promise cross-device account deduplication. Restrict access with platform sharing.

## Variations

- The live-wall template collects short messages instead.
- Use live-polling for anonymous opinions, live charts and an end summary of consensus. Its at_end/private setting shares results at End; the host can link room responses.
- A fresh artifact gives the next session its own answers. On Free only one room runs at a time, so close the last session's tabs first.

## Next

- [Live rooms](https://pr-2128-stg.superartifacts.app/docs/concepts/live-rooms.md)
- [More on plans and pricing](https://pr-2128-stg.superartifacts.app/docs/reference/plans.md)
- [More on survey](https://pr-2128-stg.superartifacts.app/docs/recipes/survey.md)