Import questions from CSV

Use Upload CSV in the Playground to add questions from a spreadsheet. Imports join the questions already in your set, so you can combine them with manual entries and AI drafts.

Prepare and import your file

1. Create a custom game or select Edit on an existing one.
2. Under Add questions, open Upload CSV and select Download Template. The download matches your selected game type.
3. Open the template in your spreadsheet app. Keep the column headers unchanged, replace the sample questions and enter one question or prompt per row.
4. Export the sheet as a comma-separated .csv file, no larger than 1 MB. Keep each cell on a single line.
5. Select Upload CSV and choose your file.
6. Check Import Preview. It shows the valid and invalid row counts, with an explanation for each invalid row.
7. Fix invalid rows in the spreadsheet and upload again, or select Import Questions to add only the valid rows. The button includes the number it will import.

For a new game, finish by selecting Create Game. In an existing game, confirming the import saves the questions to that set.

An import adds rows; it does not update or replace matching questions. If you imported the valid rows first, upload only the corrected rows afterwards to avoid adding duplicates.

Follow the selected game's columns

Download a fresh template when you change game types. Common requirements are:

• Missing Letter: use underscores in question. Put only the missing letters, in left-to-right order, in answer. A hint is required.
• Unscramble: provide the scrambled prompt, intended answer and a hint.
• Odd One Out: fill all four option columns. The answer must exactly match one option, and a hint is required.
• Sub-Words: put the main word in question and a comma-separated list in answers. Only listed words will score.
• Trivia: use single_choice, multiple_choice or text in answer_mode. Choice questions need three or four options in the CSV.
• Charades and Song Association: use the word column.
• Taboo: provide a word and all five forbidden-word columns.
• Find the Mole: provide a word and category.
• Who Said It: provide the prompt in question; there is no preset answer.

The optional difficulty value is easy, medium or hard. Leave it blank if you do not need a difficulty label.

Commas inside answers or questions

A cell containing commas must be enclosed in double quotes in the CSV file. Spreadsheet apps normally add these quotes when exporting.

For example, this Sub-Words row keeps all three accepted answers in one cell:

question,answers,hint,difficulty
TRIANGLE,"train,ring,angle",Use the letters in the main word,easy

For multiple-choice Trivia, list every correct option in the quoted answer cell:

question,answer,answer_mode,option_1,option_2,option_3,option_4,hint,category,difficulty
Which are mammals?,"Dog,Whale",multiple_choice,Dog,Snake,Whale,Lizard,,Animals,easy

Keep spelling and capitalisation consistent between an option and its answer. For text questions, leave the option columns empty.

Fix common import problems

• “Missing required fields”: check that you used the right game's template and did not rename a header or leave a required cell empty.
• “answer_mode must be one of…”: check the exact value and look for an unquoted comma in the question, answer or hint. A stray comma can shift the rest of that row into the wrong columns.
• An answer is not found in the options: copy the complete option text into the answer cell. For multiple choice, check every answer in the list.
• The file is empty or will not upload: export as .csv, not an Excel workbook, and include at least one data row below the header.
• The import exceeds the limit: a set can hold 200 questions in total, including questions already saved. Remove rows from the file or use another set.

Reported row numbers count data rows, starting with the first question as Row 1. The header and any guidance lines beginning with # are not counted. A saved set needs at least five questions or prompts before it can be played.