RooQuiz Docs
Editor & Question Types

AI Reports

In an AI Quiz, nothing is scored. After a respondent submits, AI reads their answers (and any files they uploaded) and writes them a personal report, following the instructions you give it. Pick this type when the report itself is the value you offer — a diagnosis, a review, a coaching plan. See The four quiz types.

Writing the generation instructions

Open the editor's Report section. Under Generation instructions, tell the AI what the report should cover and how to write it, for example:

Assess the speaking sample for fluency, structure and confidence, give a level from A1 to C2, list 3 strengths and 3 things to practise, and end with a 2-week study plan.

  • The respondent's answers and uploaded files are sent to the AI automatically — you don't need to paste them in.
  • To point at one specific question, click + in the editor and insert it, e.g. "tailor the advice to [Target role]".
  • Leave the instructions empty and the AI writes a general summary with strengths and suggestions.
  • Instructions can be up to 20,000 characters.

Report length

Report length has three settings; Standard is the default.

SettingWhat the report contains
BriefThe verdict and the 1–2 points that matter most
StandardThe verdict, 2–3 key findings and next steps
Detailed3–5 findings and up to 3 charts

Style & rules

Style & rules (optional) sets tone and hard rules, up to 5,000 characters — for example "Warm, encouraging tone. Address the reader as 'you'. Never mention competitors." A length rule written here takes priority over Report length.

The editor's report preview shows a sample report. Real reports are written per respondent from your instructions and their answers, so two respondents never get the same text.

File uploads

An AI Quiz can include file upload questions so the AI can review real work — a CV, a speaking sample, a photo of a product. Each upload question accepts one kind of file:

KindAcceptedLimit per fileHow the AI reads it
ImageJPG, PNG, WebP, GIF10 MBLooks at the image
AudioMP3, M4A, WAV, WebM, OGG10 MB, up to 3 minutesReads a transcript
Short videoMP4, WebM, MOV20 MB, up to 1 minuteReads a transcript of the audio
DocumentPDF, Word, Excel, PowerPoint, TXT, CSV, Markdown10 MBReads its text
  • An AI Quiz can have up to 2 upload questions, each accepting up to 3 files (set Max files to allow fewer).
  • Upload questions only collect files; they are not scored.
  • Uploads count against your team's monthly file uploads allowance — see AI credits and file uploads.

Result tags

Result tags (optional) let the AI sort respondents for you. Add up to 10 tags, each with a name and a plain-language rule for when to use it — for example Ready to buy: "Has a budget and wants to start within a month". Before writing each report, the AI picks the one tag that fits best.

  • Respondents never see the tag. They only see the tag's CTA button under their report.
  • In Response records, filter by result and see the tag on each response.
  • Tags are sent to your connectors with the response, and you can use them as conditions — e.g. tag subscribers in Kit or send a matching follow-up email only for Ready to buy.
  • Deleting a tag doesn't change reports already tagged with it.

Several AI templates come with three example tags (follow up now / nurture / too early) to start from.

CTA button

Under CTA Button, set a default button that shows below every AI report, and optionally give each result tag its own button. A tag without its own button uses the default. See Result page CTA button.

How the report is generated

  1. The respondent submits; the report starts generating right away and appears on the result page as the AI writes it.
  2. If the quiz uses Email required to see the report, an anonymous respondent's report is generated after they pass the gate — no AI credits are spent on people who never leave their email. In the dashboard these responses show "The report hasn't been generated yet", with a button to generate it now.
  3. If generation fails, it is retried automatically; you can also Regenerate report from the response — see Reports.

Redirecting respondents to a link after submission is not available for AI Quizzes, because the report is written after they submit.

AI credits and file uploads

Each AI Quiz report uses 1 AI credit. Every team gets a monthly allowance that resets on the 1st of each month (UTC):

FreePro
AI credits per month5100
File uploads per month100 MB2 GB

During a Pro free trial, AI credits stay at the Free allowance until the subscription begins.

When the allowance runs out, top-ups are used — see Add-ons. If both are used up:

  • Respondents can still answer and submit; no response is lost.
  • Their report isn't generated and shows as failed because the team is out of AI credits. Top up, then regenerate it from the response.
  • Team owners and admins get an email and an in-app notification when AI credits or file uploads are running low, and again when they run out.

AI credits are only used by AI Quiz reports. AI Match grading of fill-in-the-blank answers in a Knowledge Quiz is unlimited and uses no credits.

On this page