Your first project

Before you start

Make sure you're registered as a requester.

Log in to the Sandbox to create and test your project for free. This helps you avoid making mistakes and spending unnecessary money on a task that doesn't work.

Step 1. Create a project

In the project, you'll customize an appearance of the tasks.

  1. On the Projects tab, click Customizable.

  2. Choose a template that matches your task. Start with a pre-configured template: it already contains a task interface and instructions for Tolokers. Adapt the solution for your own tasks if needed.

    The templates for the most popular tasks
    • Image classification

      Designed to determine which category an image belongs to.

    • Product search relevance

      Intended to rate how relevant products are to specific search queries.

    • Object recognition & detection

      Used to outline objects on images for training computer vision to detect them.

    • Customer survey

      Designed to collect information for research purposes.

    If you can't find a suitable solution, choose the Blank template to set up a project from scratch. To learn how, see the Initial project settings section.

  3. In the General information section, fill in the project name and a brief explanation of what will happen within the project.
  4. In the Task interface section, do the following:
    1. Select Template builder.
    2. Edit the preset task interface to configure the task appearance.
    3. Click Show specifications to see the generated input and output data fields.
    To learn more, see the Template Builder Help.
  5. In the Instructions for performers section, edit the ready-made instructions if needed.
  6. Click Create a project.

Step 2. Configure a task pool

A pool is a set of tasks sent out for completion at the same time. Create and configure the pool as follows:

  1. On the project page, click Create new pool.
  2. Configure the pool parameters:
    • Set a price per task page and overlap. The minimum price is $0.005.
    • Use filters to select Tolokers who will have access to your tasks.
    • Add and configure quality control rules to get more accurate responses. You can use a quality control preset with default settings. In the Quality Control section, click Add a quality control rule and choose a suitable preset.

  3. Click Create pool.

Step 3. Upload a file with tasks

A task is the data you want Tolokers to label. Each image or comment is a separate task.

  1. Create a TSV file with the tasks. On the pool page, download the sample file that matches your task type.

    Task types:

    • General — tasks that you don't have answers for, and you want to get responses from Tolokers.
    • Control — tasks that you know the correct answers to. It is used for checking Tolokers.
    • Training — tasks with correct answers and hints. It is used for training Tolokers to complete a task.
  2. Add the tasks data to the sample file. For a trial pool, 10–100 tasks is enough.
  3. Click Upload and choose how to divide tasks into suites.

  4. Click Upload and choose the file with the tasks.

  5. After uploading the file, click Preview to make sure that your tasks look correctly.
  6. Use control tasks to improve Tolokers' task completion quality.
    Tip. To save time, you can opt for having your control tasks created by Toloka experts.

Step 4. Launch the pool and get the results

  1. Start the pool by clicking Start labeling. This assigns the tasks to the Tolokers.

  2. Complete your tasks as a Toloker by yourself.
  3. Track your project with the real-time statistics on the pool and project pages.
  4. When the tasks are completed, get the results:
    • Download a TSV file with the responses.
    • If you have used overlap, run aggregation to get the final results.
    • Get the files that Tolokers have attached to the tasks.

Next steps

  • When you complete the testing in the Sandbox, move your project to the Toloka production version and launch the pool for real Tolokers.
  • View our tutorials. Perhaps there is an instruction that fits your task, and you will only need to insert your own data.
  • If you don't like Template Builder, try out the HTML/JS/CSS editor.
  • See the Toloka API documentation to learn how to manage your projects via the API.
  • If you have questions or problems, see the Troubleshooting and support section.