Back to User Guide

CSV Formatting

Rules and formatting tips for uploading quiz questions via a CSV file in Jovvix. Follow this guide so your questions, options, media, and answers import cleanly the first time.

CSV Header Structure

Your CSV file should include the following 12 headers. They don't need to follow a strict order — feel free to rearrange them as needed.

Header Description
Question Text The actual question prompt shown to players.
Question Type single_answer or survey — see the next section.
Points Score awarded for a correct response (1–20).
Option 1 → Option 5 Up to five answer choices per question.
Correct Answer Index(es) of the right option(s).
Question Media Image path or code snippet that goes with the question.
Option Media Image path or code snippet attached to an option.
Resource Extra context, metadata, or explanation.

Question Text Rules

  • Avoid quotes — neither double " nor single '
  • Avoid these special characters: , ; / \
  • Any language is supported (English, Hindi, Gujarati, etc.).
  • Capital letters are allowed.

Question Type

There are two supported types you can put in the Question Type column.

Type 1

single_answer

Only one of the listed options is the correct response. Best for factual or right/wrong style questions.

Type 2

survey

Every option entered is treated as correct. Use this for polls, opinions, or open-ended response collection.

Image-Based Questions

Place the image path or filename inside the right column — Jovvix picks it up from there.

When

Question contains an image

Question Media column
When

Options include images

Option Media column

Supported formats

JPG JPEG PNG WEBP
SVG is not supported

Code-Based Questions

Where to place code snippets so they render correctly in the player and host views.

When

Code in the question

Question Media
When

Code in the options

Option Media
When

Extra code, metadata, or explanation

Resource

Tip: use Markdown formatting or indentation if you need to keep the snippet visually separated from surrounding text.

Points

  • If the Points column is left blank, it defaults to 1 point.
  • You can override by setting any custom point value.
  • Maximum allowed score per question is 20 points.

Options

  • Up to 5 options per question (Option 1 → Option 5).
  • Fewer options are fine — three or two work too.
  • Don't exceed five total options.

Correct Answer Formatting

Reference each correct option by its number (1–5). For multi-correct questions, separate the numbers with the pipe character.

Single answer 
1

Just the index of the correct option — here, Option 1 is correct.

Multiple answers (survey / multi-select) 
1|2|4

Use the | (pipe) symbol to mark multiple correct option numbers — Options 1, 2 and 4 above.

Ready to upload your CSV?

Head back to the User Guide and use the CSV Upload flow inside the Jovvix app.

Back to User Guide