Skip to main content

Creating Quizzes

A Quiz in TriviaFlow is a container for a sequence of questions. You can play a single quiz or chain multiple quizzes together into a playlist.

The Workflow​

Because TriviaFlow uses a centralized Image Library, the recommended workflow for creating a media-rich quiz is:

  1. Upload Media: Go to the Image Library and upload all necessary pictures.
  2. Create Quiz: Create the quiz object.
  3. Add Questions: Write your questions and link the images you uploaded in step 1.

1. Step-by-Step Guide​

Navigate to Game Management > Quizzes and click "Add Quiz".

Basic Info​

  • Title: The name of the quiz (e.g., "80s Pop Culture"). This is visible to players.
  • Description: Internal notes for the host (optional).

Adding Questions (Inline Editor)​

You don't need to save and switch screens for every question. You can add them directly on the Quiz page using the "Questions" table at the bottom.

FieldDescription
TextThe actual question (e.g., "Which planet is closest to the sun?").
Image(Optional) An image displayed while the timer is running.
Resolution Image(Optional) An image displayed after the answer is revealed.
DurationTime in seconds for this specific question. Default is 20s (or whatever you set in .env).
Options A-DThe four possible answers.
Correct OptionThe letter of the correct answer.
Working with Images

You cannot upload images directly inside the Question row. You must select existing images from the Image Library dropdown. This prevents duplicate files and keeps your server clean.

2. Advanced Image Features​

TriviaFlow supports a unique "Two-Phase" image system for questions.

Phase 1: The Question Image​

This image is shown immediately when the question starts.

  • Use Case: "Visual Puzzle"
  • Example: Show a zoomed-in photo of an object.
  • Question: "What object is this?"

Phase 2: The Resolution Image​

This image is hidden initially and only appears when the timer hits zero or the host manually reveals the answer.

  • Use Case: "The Reveal"
  • Example: Show the full, zoomed-out photo of the object from Phase 1.
  • Effect: Provides a satisfying "Aha!" moment for the audience.

3. Bulk Import / Export (ZIP)​

You can share quizzes between servers or backup your work using the Import/Export feature.

Exporting​

  1. Go to the Quiz list.
  2. Select the quizzes you want to export.
  3. Choose "Export selected Quizzes (ZIP)" from the "Action" dropdown.
  4. Click Go.

ZIP File Structure​

Advanced users or developers can generate these ZIP files programmatically to bulk-create quizzes.

The ZIP file must contain a specific folder structure:

my-export.zip
├── Quiz_Title_ID/
│   ├── data.json       # Contains titles, questions, and options
│   └── images/         # Folder containing the actual image files
│       ├── 1_logo.png
│       └── 2_poster.jpg

data.json Format:

{
    "title": "My Awesome Quiz",
    "description": "Created externally",
    "questions": [
        {
            "text": "What is the capital of France?",
            "duration": 20,
            "options": ["Berlin", "Madrid", "Paris", "Rome"],
            "correct": "C",
            "image": "1_eiffel_tower.jpg",
            "resolution_image": null
        }
    ]
}
Image References

The filenames in data.json (e.g., "image": "1_eiffel_tower.jpg") must exactly match the files inside the images/ subfolder of the ZIP.