TSV file with tasks

Input data is uploaded to Toloka in a TSV file. You can download a sample file for your project by clicking File example for task uploading (tsv) on the pool page.

Column headings:

To form task suites yoursef, add empty line after each task suite. If you use “smart mixing”, task suites are formed automatically. You don't need to add an empty line.

The example file below contains two task suites. Data for the task: Image URL and webpage URL ( INPUT columns) and correct answers (GOLDEN:result column).

Additional fields for tasks selected on the map
If users select tasks on the map, add the coordinates of the map in the columns:
  • Al:latitude — Latitude.

  • Al:longitude — Longitude.

Coordinates should be the same for all tasks in a suite.

Rules for populating the TSV file:

  • Field names must have the same case as the input data ids.

  • URLs must have the www or http:// prefix.

  • Quotation marks in rows must be paired.

  • Multiple paragraphs and tab characters can be included in a field. To do this, enclose the text with paragraphs in quotation marks.

The maximum file size is 100 MB.

Errors uploading TSV file

If fields in TSV file are filled in incorrectly, you will see an error message when uploading the file. The message contains information about the type of the mistake and its location in the file.

Example error message:

"4": {
        "success": false,
        "payload": {
            "exception_msg": {
                "4.image": {
                    "code": "INVALID_VALUE",
                    "message": "[ValidationError{name='', key='INVALID_URL', message='invalid url', params=null}]"

Key "4" indicates the number of line with the mistake (the count starts from 1 and includes the header line). The types of errors are listed in the table.

Error message

"exception_msg": "unexpected end of file while reading quoted column beginning on line 2 and ending on line 5

One of the fields contains unpaired quotation mark (").

"payload": [{"name": "values.0.value.2", "key": "NON_NULL", "message": "may not be null"}]

The field is marked as required in the description of input data but is left empty in TSV file. Index values.0.value.2 in the example error message indicates the error location:

  • value.0 — first field (the count starts from 0).

  • value.2 — third task (the count starts from 0).

"exception_msg": "the nameMapping array and the sourceList should be the same size (nameMapping length = 3, sourceList size = 4)

The number of fields in one of the tasks doesn't match the number of fields in the header. Example error message says that one of the tasks has four fields instead of three.

"message": "[ValidationError{name='', key='INVALID_URL', message='invalid url', params=null}]"

URL format in a field of URL type is incorrect. URL should contain:

  • www or http:// prefix.

  • top level domain (for example, .ru, .com).

"payload": [{"name": "values", "key": "FIELD_IS_REQUIRED","message": "field image-left is required","params": ["image-left"]}]

The field is marked as required in the input data description, but is not added to TSV file.