> 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/collections/revision-and-study-portal-planning-guide.md).

# Revision and Study Portal Planning Guide

This guide outlines features, suggestions and best practices for using Synap as a revision / study platform use case. Learn how to plan a question bank, configure the portal for studying. Whether you are migrating an existing question bank or starting from scratch use this guide to plan your portal and set up.&#x20;

Key considerations:&#x20;

1. Access to quizzes via collections
2. Tags and facets
3. Self directed learning features

{% embed url="<https://youtu.be/AbPKkcHkzqs>" %}

### 1. Access to quizzes via collections

The foundation of a revision portal is **quizzes inside collections** this is how users access questions in quizzes. Once users have access there are several features to get an attempt with those questions in, most Synap portals that have this use case will use a mixture of the features below:&#x20;

| Feature                       | What users do                                                                     | Best for                                   |
| ----------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------ |
| Collection: Quizzes           | Open a ready-made topic quiz                                                      | Structured revision by topic               |
| Collection: Generate attempts | Build their own practice test from the collection, choosing tags, length and mode | Targeting weak areas; large question banks |
| Collection: Mocks             | Take a fixed, named mock built from the collection                                | Exam-style practice                        |
| Study: Self practice          | Build their own practice test from the collection, choosing tags, length and mode | Students managing their own revision       |
| Study: Spaced learning        | Add quizzes to a personal Study area and generate self-practice from it           | Long-term retention                        |

&#x20;

More information can be found in the specific guides below&#x20;

{% content-ref url="/pages/VuvrGhCPC1UkRVwglBIM" %}
[Collections](https://synap.ac/docs/collections/creating-collections.md)
{% endcontent-ref %}

{% content-ref url="/spaces/WXE6hvHQFtER1a1Dm3l5/pages/nhSYnKzVmR9bp7eztOhR" %}
[Generated attempts](https://synap.ac/docs/platform/collections/generated-attempts.md)
{% endcontent-ref %}

{% content-ref url="/pages/X6kLSdn1CK8S9JOMUnrM" %}
[Collection mocks](https://synap.ac/docs/collections/collection-mocks.md)
{% endcontent-ref %}

{% content-ref url="/pages/POVEZfDGlids9jCEV5v3" %}
[Collections and the Study](https://synap.ac/docs/collections/collections-and-the-study.md)
{% endcontent-ref %}

{% content-ref url="/pages/tgUvYccP0uj594Qbxu4E" %}
[Study and Self Practice settings](https://synap.ac/docs/portal-settings/portal-settings/study-and-self-practice-settings.md)
{% endcontent-ref %}

We recommend splitting a large question bank into smaller topic or category quizzes. Synap can handle a single quiz with thousands of questions, but smaller quizzes are easier to browse, look more polished in a collection, and give students natural stopping points.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FX4AMCIVKxYAyRNeJGN1G%2FcollectionGenerate.gif?alt=media&amp;token=09683cb6-705d-4a40-affb-0bdd749e7292" alt=""><figcaption><p>Generating attempt from a collection</p></figcaption></figure>

{% hint style="info" %}
If an item is reused across collections, editing its questions changes it everywhere. Titles and schedules stay separate per collection.
{% endhint %}

### 2. Tags and facets

Tags are a great way to gain insights into user performance on different areas and allow users to generate attempts on specific topics. Facets are how you group tags together, for example:&#x20;

* Tags = `Chemistry` ,`Biology` , `Physics` could have a `Subject` Facet
* Tags = `Easy` , `Medium` , `Hard` could have a `Difficulty` Facet

Having Tags & Facets in place will power the various graphs on insights and results pages on platform and allow users to filter their results.&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FaQSNxY6xDQCylU6gox8z%2FScreenshot%202026-10-27%20at%2011.46.44.png?alt=media&amp;token=986f5148-e645-460d-a7f3-e8eb3cd8c579" alt=""><figcaption><p>Students insight pages for a specific subject facet</p></figcaption></figure>

Learn more about Tags, Facets and results in the guides below

{% content-ref url="/pages/9T2iftAc4DNFUJE76ov7" %}
[Tags & facets](https://synap.ac/docs/analytics/tags-and-facets.md)
{% endcontent-ref %}

{% content-ref url="/pages/2nc56hN8WuQgPO3sSVP7" %}
[Facet best practice](https://synap.ac/docs/analytics/tags-and-facets/facet-best-practice.md)
{% endcontent-ref %}

{% content-ref url="/pages/r82bd8wzlFw6LSDq1xan" %}
[Results page configs](https://synap.ac/docs/exams/create-and-manage-exams/3.-configure/results-page-configs.md)
{% endcontent-ref %}

### 3. Self directed learning features

Unlike highstakes exam assessments, when it comes to self directed learning you may want to give your users more options around when they get feedback and how they submit and if they can come back to finish attempt later.&#x20;

Synap provides the following configuration options on Quizzes, Collections and The Study to customise your users attempt experience

* **Allowed modes:** Practice, Exam and Timed exam
* **Progress configs:** Allow review and submit and Allow save and resume

#### Allowed modes

All allowed modes are enabled by default for attempts generated from a users study, these modes can be customised on Collection and Quizz attempts&#x20;

| Mode       | Timed | When answers are marked                          | Feedback                             |
| ---------- | ----- | ------------------------------------------------ | ------------------------------------ |
| Practice   | No    | After each question is submitted                 | After each question                  |
| Exam       | No    | After all questions and the attempt is submitted | Depends on the results page settings |
| Timed exam | Yes   | After all questions and the attempt is submitted | Depends on the results page settings |

#### Progress configs

All progress configs can be customised across Quizzes, Collections and The Study. To edit study settings go to portal settings > study.

| Progress configs            | Description                                                                                                                                                                              |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Allow review and submit     | Let users submit an attempt early, before seeing all the questions. Unseen questions will be skipped. Results settings determine whether skipped questions count towards the final score |
| Allow save and resume later | Let users save an unfinished attempt and return to it later. Timers will continue to tick down while users are away.                                                                     |

Learn more about attempt progress below&#x20;

{% content-ref url="/pages/UxLijADr8rVmnga4ctBv" %}
[Save and resume, submit and exit attempts](https://synap.ac/docs/quizzes/creating-a-quiz/quiz-experience/save-and-resume-submit-and-exit-attempts.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://synap.ac/docs/collections/revision-and-study-portal-planning-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
