Creating a file with tasks

Tasks are uploaded to the pool in the tasks file.

Download the file template for your project on the pool page. Use the template to create your own task file and upload it to the pool.

Use sample data

If you need to add different task types to the pool, upload multiple files, one for each task type.

Tasks file structure


The first line of the file contains the column headers:

  • INPUT:<name of the input data field> — input data for tasks.

  • GOLDEN:<name of the output data field> — control task responses.

  • HINT:text — hints for training tasks. The Toloker will see the hint text at the top of the task (on a red background) if their response to the control task is different from the correct one.

  • TASK:overlap — the optional parameter that is used to configure the task overlap. It has a higher priority than the overlap value set in the pool settings. The parameter value must be a positive integer.

  • Point coordinates for field tasks:

  • Al:latitude — latitude.

  • Al:longitude — longitude.

Escaping in TSV/XLSX

Escaping is the replacement of control characters in the text that are used for labeling with the corresponding text substitutions. It is used when you need to display a control character as a regular one.

The type of input data determines how control characters are escaped. Determine the type of data and study the corresponding paragraph. Possible options:

String type data
Data in JSON format
An array of data in the JSON format


See examples for the different tasks types and different data types.

Tasks types
Data types

The columns with required input data fields must be filled. The other columns can be deleted if they are empty.

Working with the file

In popular spreadsheet editors, you can import and export data in TSV or XLSX:

A text editor is good for JSON files (for example, Notepad on Windows or TextEdit on Mac OS).

You can work with data in an editor and then save it in the desired format.

  1. Create a spreadsheet with appropriate headings or copy them from the template.

  2. Add data for tasks.

  3. Copy the entire spreadsheet. Paste it into a simple text editor (such as Notepad in Windows or TextEdit in Mac).

  4. Save the file in UTF-8 encoding with the tsv extension.

The maximum file size is 100 MB.

What's next


Uploading tasks to a pool
Tasks file
Input data
Contact support

Last updated: August 24, 2023

Getting started
Important tips
Useful recommendations
Working with Toloka
Project analysis
Toloka settings
Task interface
Template Builder
HTML/CSS/JS editor
Help and support