This section describes how to edit the specification in an HTML/JS/CSS editor. You can also learn how to edit the specification in the Template Builder.
In the specification, add fields for the data used in the task or for the data you need in the results. Reference these fields when you configure the interface.
Don't repeat the input data in the output data. You will receive all data, including the input, in the results.
Specification editing is available only when the Define data specification manually option is enabled.
There are two ways to edit the specification in project settings: using either regular mode or JSON mode. JSON mode gives you more options — you can hide input data and use regular expressions to validate output data.
To add a field in the regular mode, click Add field.
To edit an existing field, hover over the field and click .
You can use different data types:
If you edit a required field, the changes apply only to new task pools. For example, if you need to fix an error in a project, clone the pool or create a new one. Existing task pools will continue using the previous version of the project.
In the output, use value validation and don't forget to mark the field as required if the Toloker has to fill it in.
Hidden fields are intended only for requesters and are not available in the task interface. The values of hidden fields can't be used either in the JS code or in the template constructor.
Let's say you pass product data (like articles or batch numbers) that Tolokers don't need in order to complete the task. Or you are moderating comments and you need the authors' personal data in the results for further data processing, but the Tolokers shouldn't have access to personal data.
To create a hidden field, add it to the specification yourself and then add the
"hidden": true parameter to this field in JSON mode. You should do this in Toloka when configuring your project. The hidden field remains when the specification is re-generated using the Template Builder.
Learn more about how to set up a project:
Last updated: February 15, 2023