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

Use the various configuration options in the tab Options to adapt the task 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.


The answers for most task forms are by default arranged in random order. Therefore, the task seems different for each test participant and attempt. For some questions, however, it may be desirable that the answers are not randomly displayed. In such cases, the setting Shuffle in the tab Options can be disabled.

For match interactions, it is further possible to disable the shuffle option per answer set.

Orientation and swapping elements

The answers of most task forms are arranged in vertical order by default, i.e. one above the other. You can, however, configure the orientation to be horizontal. In the case of a larger number of possible answers, however, a horizontal orientation is not recommended for visual reasons and because it might impair the usability of tests on mobile devices such as smartphones.

For match interactions, it is further possible to swap the location of the source and target elements, in addition to configuring the horizontal and vertical orientation. This allows the implementation of concrete technical content, for example mathematical or chemical equations. If the beginning of the equation is provided and the participant has to find the correct end of the equation or its solution, we recommend enabling the configuration Swap source and target elements.

By default, the source elements are assigned by the participants. The assignment is done from left to right. Therefore, the participant has to match the source elements on the left with the correct target elements on the right.

By activating the option Swap source and target elements, it will be the other way round, i.e. the target elements have to be assigned by the participants. This also implies that the source elements will now be provided on the right and the target elements on the left.

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".

Use comments in a task

To use the comment function for a task, proceed as follows:

  1. Switch to the tab Options in the desired area.
  2. In the section Options, disable the option Apply the configuration of the superior element under Comment and select the setting Allow on question level to enable comments for the desired area or Not allowed to disable comments explicitly for this area.

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.

Examples of using a layout file for ONYX test tasks: