Page tree
Skip to end of metadata
Go to start of metadata

Using the various configuration options in the Options tab, you can adapt the test according to your needs.


You can give the learner the opportunity to attempt individual questions multiple times. The number of available attempts will be displayed to the learner when performing the test. They can submit their answer and, if further attempts are possible, answer the same question again.

In the ONYX Editor, you can decide whether the settings for the number of available attempts should be applied to the entire test or only to selected sections or individual questions. Go to the Options tab to configure your desired settings.

If you, for example, set the maximum number of attempts to find a solution to 2, the learner can answer each question in the test twice.

If you wish to set the number of attempts individually for specific sections or questions, disable the option Apply the configuration of the superior element. Now, you can set the number of attempts individually for the section or question.

The default is always one attempt. To allow an unlimited number of attempts, enter 0 in the input field.

New random values

By default, the same variable values and the same order of elements are used for each attempt to solve a question. If you select the option New random values, random parameters will be recalculated per attempt. This affects both the variables used and the random order.

Recalculate variablesQuestions can be changed for each test attempt by using variables. If the random values are recalculated, so are the variable values for each attempt at a question.
Reshuffle random orderThe Shuffle option is available for choice interactions, match interactions, matrix interactions and order interactions. If enabled, the predefined responses of these question types will be arranged differently for each test attempt. If random values are recalculated, the order will also be changed for each attempt at a question.

These settings can extend practise and self-test scenarios. If the participant does not solve a question correctly, feedback can be used to provide instructions on how to answer the question and find a solution. The participant can then retry the question in a new attempt. The use of random values such as variables and a new random order allows the participant to work on a similar question but with new answers or values.

Time limit

The author can define a processing time for the entire test or individual test sections. The remaining processing time will be displayed to the participant during the testing process accurately to the second.

After the expiration of this time limit, a message will be displayed to the participant indicating that the sections and questions can no longer be processed. If the processing time for the whole test has expired, the test will be automatically terminated.


The author can choose between a linear and a non-linear navigation. A non-linear navigation allows participants to navigate between questions. In this way, solutions entered for previous questions can still be changed later on.

In the case of a linear navigation, participants have to navigate from question to question using the next and back buttons. As concerns the non-linear navigation, it is also possible to navigate using the displayed navigation tree.


The author can decide how the questions will be presented to the participants. Currently, it is only possible to show either one or all questions of one section on one page (section-based).

For display on mobile devices, we recommend showing only one question at once.

Comments allow the participants to leave a message for the test assessor. Especially in the case of closed task forms with limited response options, the comment function offers a valuable support possibility for participants, e.g. if they do not understand the task, perceive the task as inaccurate, or do not find their solution in the answers provided to them.

In the ONYX Editor, you can decide whether the comment settings are supposed to be applied to the entire test or only to selected sections or individual tasks.

The tutor can view the comments in the participant's results view. Further information are provided in the help section "Results view: View participant comments".

Using comments within tests

To enable the comment function for a test, proceed as follows:

  1. Switch to the Options tab in the test settings.
  2. In the Options section, activate the selection box Allow on question level under Comment. Now, participants can leave a comment for each question in the test.

You can customise your tasks and tests using a layout file. The prerequisite for the use of this function is basic knowledge in HTML and CSS.

Save your layout file as a CSS file (.css) and upload it to the Options tab of your task or test. Use the preview to verify whether the presentation is correct. You can remove the layout file at any time or upload a new one.


Custom layout is only supported in the browser. The export views (PDF export, performance results page) do not allow for a correct display of your layout.

Individual layout settings of a task also affect all other tasks on the respective page when the test option Show all tasks of this section on one page is configured. This also applies to all detailed assessment views.

Example: Hide test titles

When a test is performed, the test title is displayed in the upper left pane. You can hide the test title using your own style sheet file (CSS).

Use the following CSS statement:

.nav-header h1 {display: none !important;}

Save the statement in a CSS file (.css). Then add the CSS file to the test content by uploading it as a style sheet file to the Layout settings section in the Options tab.