Project 2. Find a similar item in an online store

In this project, Tolokers will search an online store for shoes that are similar to the ones shown in the task. Use the results from project 1 as source images.

  1. Create a project
  2. Create a pool
  3. Upload tasks

Create a project

To create a project, open Toloka for requesters.

In the interface:
  1. Choose a template:

    1. Click Create project.

    2. Select the Product photo search template.

  2. Provide general information:

    1. In the Project title field, enter Find the same or similar shoes in an online store.

    2. In the Description field, enter Go to an online store and provide a link and an image of the same or similar pair of shoes.

    3. Optionally add a Private comment.

    4. Save the changes.

  3. Edit the task interface in the editor you selected:

    Template Builder
    HTML/CSS/JS editor
    1. Use the ready-made code for this project with pre-configured validation and task layout.

      The Toloker won't be able to submit the response until they:

      • Click the button to go to the online store.
      • Add a link to the product.
      • Upload an image of the product.
    2. Click Show specifications to see the input and output data fields.

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

      • Output data fields:

        • found_link — The link to the product in the online store.
        • found_image — For uploading the image of the product.
    1. In the Task Interface, delete the template code from the HTML block and paste the following code:

      {{img src=image width="50%" height="400px"}}
      <div class='answers'>
          <p>Find similar shoes <b>shoes</b> in the ASOS online store</p>
      {{field type="button-clicked" name="button" label="ASOS" href="" action=true}}
      <p>Shoes must be similar in color, material, length, and style.</p>
      <p>Paste the link here</p>
      {{field width="100%" type="input" name="found_link"}}
      <p>Upload the image here</p>    <div>
      {{field width="100%" type="file-img" name="found_image" preview=true}}
      Copied to clipboard
    2. To check if the link and image submitted by the Toloker are valid, go to line 5 in the JS block and replace the following code:

      if (!solution.output_values.image && !solution.output_values.no_image) {


      if (!solution.output_values.found_image) {


      Be careful when changing the code. If you have issues with the preview, contact support or compare your code with the code sample in the Appendix.

    3. Replace the template code in the CSS block with the following code, which is responsible for setting the proportional image size.

      .task {
        display: block;
        height: 500px;
        width: 800px;
      .img {
        float: left;
        width: 50%;
      .answers {
        float: left;
        width: 40%;
        margin: 5%;
      Copied to clipboard
    4. Edit the input and output data in the Data specification block.

      1. Click to switch graphic mode to JSON format.

      2. In the Input data field, enter:

          "image": {
              "type": "url",
              "hidden": false,
              "required": true
        Copied to clipboard
      3. In the Output data field, enter:


        If you want to choose a different online store, change "pattern": "*" to "pattern": "your_store.*".

          "button": {
            "type": "boolean",
            "hidden": false,
            "required": true,
            "allowed_values": [
          "found_link": {
            "type": "string",
            "hidden": false,
            "pattern": "*",
            "required": true
          "found_image": {
            "type": "file",
            "hidden": false,
            "required": true
        Copied to clipboard

        Learn more about the Specification parameters in Input and output data.

      4. Click to see the Toloker'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.
        1. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

        2. Exit preview mode.

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

  4. Save the changes.

  5. In Instructions for Tolokers, enter the instructions.

    1. Instructions:
      Look at what the person is wearing in the picture.
      Then go to the ASOS online store and search for the same pair of shoes.
      It should be similar in category, style, color, and length.
      Copied to clipboard
    2. Save the changes.

  6. To go back to the Projects page, click Finish editing.

Learn more about working with the project in the Project section.

Create a pool

To create a pool:

  1. Open the page of the project titled Find the same or similar shoes in an online store.

  2. Click the Add pool button.

  3. Specify the pool name.

  4. (optional) Add a Private comment. This information is available only to you.

  5. In the Tolokers section of the Audience block, filter Tolokers by language:

    1. Click Add filter.

    2. Find the Toloker profile block in the list and choose the Languages skill.

    3. In the ? field specify =.

    4. In the Value field, specify Russian.

    Tasks in pools will automatically be available in the web version of Toloka and the mobile app. If you want to change the default settings and limit the visibility of the task for any of the versions, add the Client filter and select the desired value: Toloka web version or Toloka for mobile.

  6. In the Tolokers section, add a new skill:

    1. Click Add a skill.

    2. In the Title field of the window that opens, enter Found_shoes.

    3. Click the Add button.

  7. (optional) In the Speed/quality balance section, specify the desired quality level. Improving quality may reduce the speed of task completion because the pool will be available to fewer Tolokers. Learn more in the Speed/quality balance section.

  8. Enter 0.01 in the Price per task suite field in the Price block.

  9. In the Quality control block, specify quality control settings for the pool:

    1. Turn on the Non-automatic acceptance option.

    2. Set the Deadline field to 7.

    3. Click Add a quality control rule.

    4. Find the Rules block in the list and select Processing rejected and accepted assignments.

    5. Set a rule for rejected tasks: if a task is rejected, increase overlap by 1. In addition, turn on the Open pool if closed option:

    6. Add another quality control rule. Click Add a quality control rule.

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

    8. Set a rule for completed assignments: if the number of submitted assignments is greater than or equal to 1, set the value of the Found_shoes skill to 1.


      If the Found_shoes skill is missing from the list, save the pool and reopen it to edit it.

    Control tasks and majority vote aren't used in this type of project, because links submitted by Tolokers must match, which is practically impossible. Learn more in Quality control.

  10. Enter 3 in the The number of Tolokers to complete each task field in the Task overlap section.

  11. Click Create a pool.

Upload tasks

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

  2. Select images that are appropriate for the current project (OK or your value if you changed it for the result field).

  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.

  6. Upload the resulting file.

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

    2. Choose Set manually.

    3. In the Tasks per suite field, specify1.

    4. Click Upload.

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

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

  7. Click to start the pool.


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

What's next

  • Create Project 3 to compare the original image with the results from Project 2.