> For the complete documentation index, see [llms.txt](https://synap.ac/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synap.ac/docs/platform/collections/mock-exams.md).

# Mock exams

Mocks are ready-made tests generated from the quiz questions in a collection. You choose the title, number of questions, pass score, timer and question mix in advance. Students simply choose a mock and start it.

{% hint style="info" %}
**Location:** Collections → select a collection → Mocks
{% endhint %}

### What students see

As soon as the collection contains a mock, **Generate mock** appears in both Cards and Player views. Students see the title, number of questions and whether each mock is timed or untimed.

![The Generate mock window showing an untimed five-question mock](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FaVUvsrdgwDW4BWJDWh5P%2Fgenerate-mock.png?alt=media\&token=26b4f13f-1662-41ea-90f0-c567e3bf30ae)

Selecting **Start** creates the test and opens the quiz player. For a timed mock, Synap shows the time available to that student and applies any approved extra-time allowance automatically.

### Mock settings

![The mock editor showing its title, length, pass score, timer and question filters](https://3891068282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FLfOjZZPOun75iNKqP1Fw%2Fmock-configuration.png?alt=media\&token=ac413fc3-9505-41fd-85c7-a05f830ec67e)

| Field            | What you set                                        | What the student experiences                                           |
| ---------------- | --------------------------------------------------- | ---------------------------------------------------------------------- |
| **Title**        | A clear name for the mock.                          | The name shown in the **Generate mock** list.                          |
| **Length**       | The number of questions to generate.                | The question count shown before starting.                              |
| **Pass Score**   | The percentage required to pass, from 0 to 100.     | The pass or fail result when results are shown.                        |
| **Time allowed** | A duration in minutes, or blank for no timer.       | A timed or untimed test. Approved extra time is applied automatically. |
| **Filters**      | One or more rules that choose questions using tags. | A planned question mix that students cannot change.                    |

Select **Done** to close the mock editor, then **Save** on the Mocks page to apply the collection's mock list.

### Choosing the question mix

Each filter row controls part of the mock. You choose which tags a row should match and how many questions it should contribute.

For example, a five-question mock could take one question from Algebra and four from Geometry. Each generated test may contain different questions, but it keeps the same planned balance while enough matching questions are available.

Tag conditions can include or exclude particular tags. The summary on each row shows its current question allocation and tag selection.

{% hint style="warning" %}
A mock cannot be generated if one of its rows does not have enough matching questions. Changing quiz content or tags later can reduce the number available, so retest important mocks after updating the question bank.
{% endhint %}

### Length and available questions

Length is the number of questions the mock should contain. The filter rows must be able to supply that number, and locked quiz placements are not included. If the mock uses several rows, each row needs enough matching questions for its own allocation.

### Pass score

Pass score is the percentage needed to pass the generated mock. A value of 0 means every submitted attempt passes, so choose a deliberate value before sharing the mock with students.

### Timer and extra time

Enter the standard duration in minutes, or leave the field blank for an untimed mock. If a student has an approved extra-time allowance, Synap applies it automatically. You do not need to create a separate mock for that student.

### Using more than one mock

A collection can contain several mocks. Students see them together in the **Generate mock** window, so use titles that clearly distinguish them, such as “Paper 1”, “Foundation” or “Algebra practice”.

Each mock uses the collection's question content but keeps its own length, pass score, timer and filters.

### Mocks and generated attempts compared

|                          | Generate attempt                          | Generate mock                                      |
| ------------------------ | ----------------------------------------- | -------------------------------------------------- |
| Who chooses the options? | The student, within the limits you set    | You set them in advance                            |
| Student sees             | Mode, length and permitted filters        | Name, question count and time status               |
| Useful for               | Flexible, self-directed practice          | A planned paper or repeatable simulation           |
| Questions come from      | Eligible quiz questions in the collection | Eligible questions matching the mock's filter rows |
| Becomes available when   | **Allow generated attempts** is enabled   | At least one mock has been saved                   |

### Check the student experience

For every mock, preview the collection and start a sample attempt. Check that:

* the title is easy to recognise;
* the question count and timer are correct;
* every filter row can supply enough questions;
* the pass score produces the expected result; and
* the generated questions have the mix you intended.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://synap.ac/docs/platform/collections/mock-exams.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.