Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testsplatform.com/llms.txt

Use this file to discover all available pages before exploring further.

A Test is a set of questions grouped together. When you create a test, it starts as a draft. Draft tests are only visible to you — you can add questions, adjust settings, and make changes without anyone else seeing them. When ready, publish the test. A published test is a snapshot at that moment in time. You can keep editing after publishing, but changes won’t go live until you publish again.

Creating a Test

There are three ways to create a test:

1. From scratch

Go to My TestsCreate Test and start adding questions manually using the question editor.

2. Import from a document

Go to My TestsCreate TestImport Questions. Upload a file — the AI will automatically extract questions from it. Supported formats: PDF, Word (.docx), JSON, TXT, Markdown (.md) The AI recognizes question text, answer options, and marks the correct answers where possible. Review the imported questions and adjust as needed — formatting may not always be perfect.

3. Generate with AI

On the test editing page, click the Create with AI button. Describe the topic and the AI will generate questions for you. You can also paste a screenshot of existing questions into the chat and the AI will recognize and import them. See the AI-Assistant page for tips on getting the best results.

Question Types

Single Choice

Only one answer can be selected. The most common type for knowledge assessments and recruitment screening tests.

Multiple Choice

Multiple answers can be selected. Use when more than one option may be correct.

Free Answer

The applicant writes a text response — no predefined options. When creating a free answer question, you define AI review criteria: a description of what a correct answer should include. After the applicant submits the test, AI automatically evaluates their response against your criteria and marks it as correct or incorrect. Example:
Question: Describe the steps to onboard a new support agent. AI review criteria: A correct answer must mention: (1) account setup, (2) product training, (3) shadowing an experienced agent, (4) supervised first calls. The order matters. Similar wording is acceptable as long as the steps are present.
This makes free answer questions practical for assessing open-ended knowledge without manual review for every submission. (Available on Basic plan and above.)

Settings Panel

Tags

Attach tags to your test to categorize it. Tags help with filtering and organization.

Topics

Assign a topic to group related tests together.

Question Settings

Tags

Tag individual questions to get per-tag performance breakdowns in results. For example, tag some questions as “SQL” and others as “System Design” — after the test you’ll see how the candidate performed in each area.

Explanations

Add an explanation to each question showing why an answer is correct or incorrect. Explanations are shown to applicants after they complete the test (depending on your link settings). You can write explanations manually or generate them automatically with the AI-Assistant.

Statistics

For any published test you can view overall statistics:
  • Average score
  • Best result
  • Worst result
These include all attempts across all links.

Visibility & Sharing

Personal account

After publishing, a test is accessible via a direct link. By default, anyone with the link can take it.

Organization account

In an organization you have additional visibility controls:
  • Only assignees — the test can be previewed via link, but only assigned users can take it
  • Organization-wide — visible to everyone in your organization in the Tests catalog; not visible externally
  • Public — visible to anyone, including users outside the organization
To share a test and configure how results are collected, use Links.

Notes on Anonymous Test-Taking

If a user takes your test without a TestsPlatform account, a cookie is used to link their attempt to their session. If they later create an account on the same device, the assessment is associated with their new account. If they clear cookies before signing up, the assessment record is lost. You cannot see individual results from anonymous test-takers — only aggregate statistics.