Project 2. Select an object in the image

In this project performers will select image areas that contain a traffic sign. Use the results from project 1 as source images.

  1. Create a project
  2. Create a pool
  3. Prepare and upload a TSV file with tasks
  4. Get the results

Create a project

  1. Choose a template:

    1. Click + Create project.

    2. Select the Object selection in an image template.
  2. Provide general information:

    1. In Name to show performers, enter Outline traffic signs in the image.
    2. In Description for performers, enter Draw a box around all traffic signs in the image.
    3. Optionally add a Private comment.
    4. Click Save.
  3. Edit the task interface in the editor you selected:

    Template Builder
    HTML/CSS/JS editor
    1. You can use it for this project with pre-configured validation and task layout.

      The performer won't be able to submit a response without selecting an area in an image.

      For more information about the template and its settings, see Object selection in an image in the Template Builder Help.

    2. To see the input and output data fields, click Show specifications in the Data specification section.

      • Input data field: image — A link to an image.

      • Output data field: result — The field that will contain the information about the labeled image after it is uploaded.
    1. In Task interface, leave the HTML block unchanged.

    2. Edit the CSS block:

      1. Set up the area selection tools. This template uses Editor for image area selection. It features rectangle and polygon tools (by default).

        To set up rectangle selection, replace the code in the CSS block with the following:
        .image-annotation-editor__shape-polygon {
        display: none;
        Copied to clipboard
      2. Enter the code to adjust the interface height to the image size:

        .image-annotation-editor__annotation-layer {
        height: max-content;
        Copied to clipboard
      3. (optional) You can ask performers to enter an annotation for the selected area or select one from a list. To do this, add an interface element in the JS block. For example, a text field or drop-down list.

        Learn more about annotation.

    3. Click to see the performer's view of the task.

      Note. The project preview shows one task with standard data. You can define the number of tasks to show on the page later.
    4. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

    5. Exit preview mode. In the lower-left corner, click ExitExit . If there were errors when testing, check the code blocks that you entered.

  4. Save the changes.

  5. Write instructions for performers:

    Instruction text:
    Click and draw a rectangle around all traffic signs in the image.

    If you want to add a task examples in the instruction, complete it yourself in the preview mode. Take screenshots, upload them to photo hosting or cloud storage and insert image links in the instructions by clicking the button on the toolbar.

    Click Finish.

Create a pool

A pool is a set of paid tasks sent out for completion at the same time.

  1. Open the project page Outline the traffic signs in the image.

  2. Click the Add a pool button.

  3. Specify the Pool name.

  4. (optional) Enter a private description.

    1. Turn on the Add a private description option.

    2. In the Private description field, enter the pool description. This information is available only to you.

  5. In the Price per task suite section, find Price in US dollars and specify the price. For example, 0.01. You can see more examples of pricing here.

    What is a task suite?

    A task suite can contain one or several tasks that are shown on the same page. If the tasks are simple, you can add 10-20 tasks per suite. Don't make task suites too long because it slows down loading speed for performers.

    Performers get paid for completing the entire task suite.

    The number of tasks per suite is set when uploading tasks.

    What is a fair price for a task suite?

    The general rule of pricing is the more time the performer spends to complete the task, the higher the price is.

    You can register in Toloka as a performer and find out how much other requesters pay for tasks, or see examples of cost for different types of tasks.

  6. In the Performers section, filter performers:

    1. Click Add filter.

    2. Find the Audience presets block in the list and choose the Russian speaking users skill.

    3. Add a new skill. Click Create skill.

    4. In the window that opens, enter Area selection in the Title field.

    5. Click Add.

  7. Quality control rules allow you to filter out careless performers. In the Quality control section, set the rules for the pool:

    1. Turn on the Assignment review option.

      What is non-automatic acceptance (assignment review)?

      The non-automatic acceptance option allows you to review completed assignments before accepting them and paying for them. If the performer didn't follow instructions, you can reject the assignment. The maximum allowed period for the review is set in the Deadline field.

      In the Review period field, specify the number of days for checking the task.

    2. Add the following quality control blocks:
      • Recompletion of rejected assignments — sends the tasks you rejected to other performers according to the specified rules.

        1. Click Add Quality Control Rule.

        2. Find the Rules block in the list and choose Recompletion of rejected assignments.

        3. Set a rule for a rejected task: if assignment becomes rejected, then extend overlap by 1. Turn on the Open pool if closed option.

          This means that the rejected task will be returned to the pool and shown to another performer.

      • Submitted responses — allows you to limit the number of pool tasks available for the performer per day.

        1. Click Add Quality Control Rule.

        2. Find Rules block in the list and choose Submitted responses.

        3. Set a rule for the completed task: if submitted assignments ≥ 1, then assign skill value Area selection equal to 1.

          These parameters allow you to mark the performer who completed at least one task in the pool.


          If the Area selection skill isn't displayed in the list, save the pool and reopen it for editing.

      • Fast responses —Filters out performers who respond too quickly.

        1. Click Add Quality Control Rule.

        2. Find the Rules block in the list and choose Fast responses.

        3. In the Recent values to use field, enter the number of the performer's recently completed assignments. For example, 5.
        4. In the Minimum time per task suite field, enter the time in seconds. For example, 20.
        5. Set a rule for fast responses: if the number of fast responses≥ 1, then ban on requester for 10 days. In the Reason field, enter Fast responses.

          This means that a user who completes a task suite in less than 20 seconds will be suspended for 10 days and won't be able to access your tasks.

      • Results of assignment review — restricts the pool access for performers who often make mistakes.

        1. Click Add Quality Control Rule.

        2. Find the Rules block in the list and choose Results of assignment review.

        3. Set a rule for rejected tasks: if total reviewed responses ≥ 3 and rejected responses (%) > 35, then ban on requester for 15 days.

          This means that if 35% or more of a performer's responses are rejected, the performer is banned and can't access your tasks for 15 days. The rule takes effect after 3 responses of the performer are reviewed.

    Control tasks and majority vote aren't used for this project type, since the area markup provided by the performers must match (which is almost impossible). Learn more in Quality control.


    You can copy quality control settings from another pool. To do this, click Copy settings from in the Users filter section.

  8. Set overlap, which is the number of performers to complete the same task. In the Overlap section, specify the Overlap field value. For image area selection tasks, it is usually 1.

  9. (optional) In the Speed/quality ratio section, specify the percentage of top-rated users who will get access to the pool. Learn more in the Speed/quality balance section.

  10. In the Parameters section, specify the value for Time for completing a task suite in seconds. The time should be long enough to read the instructions and wait for task data to load. For example, 1200 seconds.
  11. Click Save.

Prepare and upload a TSV file with tasks

What is TSV?
A TSV file presents a table as a text file in which columns are separated by tabs.
You can work with it both in a table editor and a text editor, and then save it to the desired format. More about working with a TSV file. There is a CSV format that is similar to TSV, but you should use a TSV file for uploading.
Note. Before uploading the file, make sure it is saved in UTF-8 encoding.
  1. Prepare a TSV file with tasks.

    1. In the text or spreadsheet editor, open the TSV file that you received after aggregating the results in project 1.

    2. Choose images appropriate for the current project (the OK value).

      Tip. You can use the awk commands to outline images on Linux and MacOS devices:
      awk 'BEGIN {OFS = FS = "\t";} $2=/OK/ {print $1}' <aggregated_res>.tsv > <filtered_res>.tsv
      Copied to clipboard
    3. Copy the column with the selected links to a new sheet or document.

    4. Name it INPUT:image. If you want to set a different name, rename the column in the source file with the results, too.

    5. Save the file in TSV format.

  2. Upload the resulting TSV file.

    1. Click Upload. In the window that opens, configure the file upload settings.

    2. Choose Set manually.

    3. In the Tasks per page field, specify 1.

    4. Click Upload.

    5. In the window that opens, choose the TSV file with tasks to upload and click Open.

    6. In the window that opens, check the number of tasks and click Add.

  3. Click to start the pool.


    The tasks will be completed by real performers in Toloka. Recheck your project setup before you start the pool.

Get the results

  1. On the pool page, click Download results. In the window that opens:

    1. In Status leave only the Submitted option enabled.

    2. In Columns leave only the assignment ID option enabled.

    3. Disable the Separate assignments with empty row option.

    4. Click Download results.

  2. Use the TSV file with results in the third project.

What's next