Writing instructions

  1. Why instructions are important
  2. Creating instructions
  3. HTML markup
  4. Editing the instructions

When selecting a task, the performer is first shown the instructions that you wrote. Describe what needs to be done and give examples in them.

Why instructions are important

Good instructions help the performer complete the task correctly. The clarity and completeness of the instructions affect response quality and the customizable project's rating. Unclear or overly complex instructions, on the contrary, will scare off performers.

If the performer completed the task according to the instructions, and you rejected it, they can file an appeal. It is important to make the instructions both clear and accurate.

Learn more about how to write simple and clear instructions on the Toloka website.

Creating instructions

Write text, format it, and insert pictures, links and tables in the visual editor or using HTML markup. To switch modes, click .

To expand the editor to full screen, click .

To view the instructions as seen by the performer, click .

HTML markup

The HTML markup mode allows you to create user-friendly instructions. Declare and apply CSS styles and use allowed HTML tags.

CSS styles
Declare styles in the style container or use the style attribute in tags to assign a style.
Note. The style container can be placed at the beginning or at the end of the instructions.
Supported HTML tags
The HTML markup supports basic tags:
  • Headers from h1 to h6.
  • Paragraph p and the div, pre, and blockquote blocks.
  • The ol, ul, and dl lists.
  • The table tag for tables.
  • The a tag for links.
  • The img and map pictures.
  • Text layout. For example: span, strong, em.
Full list of supported tags
  • a
  • b
  • big
  • blockquote
  • br
  • center
  • cite
  • code
  • col
  • colgroup
  • dd
  • div
  • dl
  • dt
  • em
  • font
  • h1
  • h2
  • h3
  • h4
  • h5
  • h6
  • hr
  • i
  • img
  • li
  • map
  • ol
  • p
  • pre
  • samp
  • small
  • span
  • strike
  • strong
  • style
  • sub
  • sup
  • table
  • tbody
  • td
  • tfoot
  • th
  • thead
  • tr
  • u
  • ul
  • a
  • b
  • big
  • blockquote
  • br
  • center
  • cite
  • code
  • col
  • colgroup
  • dd
  • div
  • dl
  • dt
  • em
  • font
  • h1
  • h2
  • h3
  • h4
  • h5
  • h6
  • hr
  • i
  • img
  • li
  • map
  • ol
  • p
  • pre
  • samp
  • small
  • span
  • strike
  • strong
  • style
  • sub
  • sup
  • table
  • tbody
  • td
  • tfoot
  • th
  • thead
  • tr
  • u
  • ul
Unsupported HTML tags
You can't insert the following in the instructions:
  • Scripts.
  • Frames.
  • Objects, audio players, or video players (the object, audio and video elements).
    Tip. You can provide links to audio and video.
Tags that are not supported are removed from the instructions when saving the customizable project.

Editing the instructions

To change the instructions, go to project editing, make changes and save the project.
Note. If you edit instructions in a project that already has completed tasks, you should notify performers.

Troubleshooting

How do I show my instructions to the performer inside the task so that they don't need to open or close it?
There are three options:
  • Put your instructions inside the task, but make sure that it doesn't clutter the interface.
  • Use a side window for your instructions so that the user can quickly expand or collapse them.
  • Hide the instructions in an expandable section or add hints for the individual interface elements.
For best results, we recommend that you pre-select the performers that meet your requirements and set up the quality control rules.
Can I add a video player or audio player to my instructions?
No, but you can add links to them.
Some tags disappear after I save the instructions.
You can't use unsupported tags because they are deleted when you save the project. List of supported tags.
How do I create different instructions for the training pool and main pools?
By default, the project instructions are displayed in the training pool. To use separate instructions for the training pool, deselect Use project instructions. Don't forget to update the training instructions if you change something in the general task instructions.
What do I do if the radio button attributes are displayed correctly in the preview, but disappear after saving?

If the tags or attributes disappear after you save the instructions (for example, checked="true"), it means that they are not supported. For the full list of tags that can be used in the instructions, see the Guide.