Project 4. Which of the found items is more similar to the initial one?

In this project, performers will compare the found shoes with the initial image and determine which pair is more similar. To make a comparison in the project, you'll add the results from the second project. See details in Prepare and upload a TSV file with tasks.

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

Create a project

To create a project:

  1. Click the + Create project button.

  2. In the window that opens, select the Image side-by-sides template. To do this, hover over the template and click Choose.

  3. In the window that opens, fill in the project parameters.

    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 to and an image of the same or similar pair of shoes.

    3. In the Instructions field, enter the instructions.

      Instruction text:

      Look at 2 pictures with different shoes and decide which pair of shoes looks more similar to the original pair. 
      Rely on your own sense of style, but also remember that they will look alike if 
      they have similar color, fabric, length, and style.
  4. Edit the input and output data in the Specifications block.

    1. Click to switch graphic mode to JSON format.

    2. In the Input data field, enter:

        "image": {
          "type": "url",
          "hidden": false,
          "required": true
        "left_link": {
          "type": "url",
          "hidden": false,
          "required": true
        "right_link": {
          "type": "url",
          "hidden": false,
          "required": true
    3. In the Output data field, enter:

        "result": {
          "type": "url",
          "hidden": false,
          "required": true

    Read more about the Specification parameters in the Input and output data section.

  5. Prepare the Task interface.

    1. Remove the template code from the HTML block.

    2. Insert the following code in the HTML block:

      <div class="header">
          <div class="left caption">
              {{button label="Go to site" href=left_link size="L"}}
              <p class="url">{{left_link}}</p>
          <div class="right caption">
              <p class="url">{{right_link}}</p>
              {{button label="Go to site" href=right_link  size="L"}}
      {{img src=image}}
      <div class="content clearfix">
          <div class="left page">
              {{iframe src=uploaded_link_left width="100%" height="700px" real-size=true screenshot=true}}
          <div class="right page">
              {{iframe src=uploaded_link_right width="100%" height="700px" real-size=true screenshot=true}}
      <div class="footer">
          {{field type="radio" name="result" label="Left image is better" value=result_left hotkey="1"}}
          {{field type="radio" name="result" label="Right image is better" value=result_right hotkey="2"}}
    3. In the js block, edit the code by adding the following lines before OnRender.

      Don't remove the existing code.

      getTemplateData: function() {
              var data = TolokaHandlebarsTask.prototype.getTemplateData.apply(this, arguments),
              input = this.getTask().input_values;
              var left_link = input.left_link;
              var right_link = input.right_link;
              var uploaded_link_left = '',
                  uploaded_link_right = ''
              if (Math.floor(Math.random() * 2)) {
                  uploaded_link_left = left_link
                  uploaded_link_right = right_link
              } else {
                  uploaded_link_left = right_link
                  uploaded_link_right = left_link
      	 data.uploaded_link_left = uploaded_link_left;
              data.uploaded_link_right = uploaded_link_right;
              data.result_left = uploaded_link_left;
              data.result_right = uploaded_link_right;
              return data;
    4. Remove the template code from the CSS block.

    5. Insert in the CSS block the following code that is responsible for setting the proportional image size:
      .task {
        display: block;
      .header {
        overflow: hidden;
        background-color: #FFCC00;
      .caption {
        width: 50%;
      .url {
        white-space: nowrap;
        overflow: hidden;
        text-overflow: ellipsis;
        max-width: calc(100% - 182px);
        display: inline-block;
        vertical-align: bottom;
      .button {
        margin: 10px;
        max-width: 182px;
      .button__label {
        white-space: nowrap;
        overflow: hidden;
        text-overflow: ellipsis;
        max-width: 150px;
      .content {
        margin: 10px 0;
      .page {
        display: inline-block;
        width: 50%;
      .left {
        float: left;
        text-align: left;
      .right {
        float: right;
        text-align: right;
      .clearfix {
        overflow: hidden;
        width: 100%;
  6. Click the Preview button.

  7. In the window that opens, check if the task options work correctly.

    1. Answer the question.

    2. In the lower right corner, click Send.

  8. Exit the preview mode.

    1. In the lower left corner, click Exit.

    2. In the window that opens, click Exit.

  9. In the window that opens, click Finish editing.

Read 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 Which shoes look more alike.

  2. Click the Add pool button.

  3. Specify the pool name.

  4. (optional) Enter the 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 page section, in the Price in US dollars field, specify 0.01.

  6. In the Performers section, filter performers:

    1. Click Add filter.

    2. Find the Profile block in the list and choose the Languages skill.

    3. In the ? field specify =.

    4. Add another filter. Click Add filter.

    5. Find the Skills block in the list and select a skill named Choose skill.

    6. In the Choose skill field, select Found_shoes.

    7. In the ? field specify =.

    8. Leave the Absent field empty.

  7. In the Quality control section, specify quality control settings for the pool:

    1. Click Add quality control rule.

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

    3. Set a rule for fast responses: if the number of fast responses is more than 3, then restrict the performer's access to the project for 10 days. Specify Fast responses as a reason.

    Read more about quality control in the Quality control section.

  8. In the Overlap section, in the Overlap field, enter 10.

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

  10. In the Parameters section:

    1. In the Time per task page in seconds field, specify 300.

    2. Turn on the Keep task order option.

  11. Click the Save button.

Prepare and upload a TSV file with tasks

  1. Download the TSV file received in the third project.

  2. Create pairs for each input image so that you can compare the two found images with the original one and decide which one is more similar.

    You can create pairs manually using a text editor or automatically, for example, through Python or Jupyter Lab.

    As an example, you can use our results

  3. Open the Which item is more similar? pool.

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

  5. Choose Set manually.

  6. In the Tasks per page field, specify1. You can experiment with the number of tasks per page.

  7. Click Upload.

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

  9. Click to start the pool.


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

Receive the results

To get the results:

  1. Click Download results.

    1. In the Status block, only leave the Accepted option enabled.

    2. In the Fields block, leave the link, response ID, and user ID options enabled.

  2. Disable the Separate assignments with empty row option.

  3. Try to use the Bradley-Terry model based on the results. As an example, use our results.