> 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/quizzes/experience-and-instructions.md). # Experience and instructions Experience settings control how users take the quiz. Instructions provide content immediately before the first question. ### Instructions {% hint style="info" %} **Location:** Library → Quiz → Instructions {% endhint %} Enable instructions, then configure a title and rich-text body. Instructions can also include audio. When the quiz timer is enabled, a separate instructions timer can limit how long the page remains available. Use instructions for rules users must read before starting. Put question-specific information in the question or section where it is needed. Tell students which mode they are entering, whether they can return to earlier questions, how the timer behaves, whether guessing can lose marks and when results will be available. Preview long instructions on a smaller screen and do not make essential information available only as audio. ### Quiz experience {% hint style="info" %} **Location:** Library → Quiz → Experience {% endhint %} | Group | Available configuration | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | **Allowed modes** | Practice, Exam and Timed exam. | | **Timer** | Fixed duration or a value inferred from questions; soft timer and enforced full time. | | **Allowed lengths** | All questions, Short, Medium, Long and Extra long. | | **Players** | The quiz players available to the portal, such as Default or specialist players. | | **Practice by tag** | Allowed facets and tag sets, dropdown or toggle display, multiple selection, untagged-question handling and mastery filters. | | **Security** | Disable copying, pasting and right-click. | | **Navigation** | Prevent movement between questions, hide the control panel or suppress notifications. | | **Question layout** | Allow the question panel to be resized. | | **Informational questions** | Exclude informational items from displayed question counts. | | **Sections** | Soft sections, section shuffling and question shuffling. | | **Learner tools** | Calculator, notepad, strike-through, highlighting, bookmarking, lab values, flagging and microphone controls. | | **Display** | Available marks, pinned message and theme. | ![The Quiz experience page showing allowed modes, timer controls and allowed lengths](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FMfeFccI0XdglTsL1sRY1%2Fquiz-experience.png?alt=media\&token=29d0b2f6-5844-4739-9def-f5355a2b9c05) ### Practice, exam and timed exam modes | Mode | Student expectation | Typical use | | -------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------ | | **Practice** | Works through questions as a learning activity, often with more immediate feedback and navigation | Revision and formative checks | | **Exam** | Completes an assessed attempt without a quiz-level countdown | Untimed tests or externally timed sessions | | **Timed exam** | Completes the attempt within the configured timer | Time-limited practice and assessments | Allowed modes give the delivery surface a set of choices; they do not make every mode equally suitable. If only one experience is intended, permit only that mode so students are not asked to make an assessment-design decision themselves. ### Timer behaviour A fixed timer gives every attempt the configured duration. An inferred timer derives the total from question timing. A soft timer can continue after the nominal time, while enforced timing ends or advances the attempt according to the player rules. **Enforced full time** can prevent an early finish, so use it only when students genuinely must remain for the whole period. Timer visibility and enforcement are separate: hiding a timer does not remove it. Test timeout, final warning, submission and refresh behaviour, particularly when sections also have timers. ### Learner tools Enable tools that support the task and the intended accommodations. The calculator, notepad, highlighting and strike-through help students work; bookmarks help them return to questions when navigation permits. Lab values provide a reference panel. Question reporting lets students flag a suspected problem to staff; it does not bookmark the question for their own review. {% hint style="warning" %} Some combinations are intentionally restrictive. For example, preventing navigation can make Practice mode impossible to complete if users cannot progress as expected. Preview every allowed mode after changing navigation or timer rules. {% endhint %} --- # 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/quizzes/experience-and-instructions.md?ask=&goal= ``` `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.