Writing 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 thestyle
attribute in tags to assign a style.Note. Thestyle
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
toh6
. - Paragraph
p
and thediv
,pre
, andblockquote
blocks. - The
ol
,ul
, anddl
lists. - The
table
tag for tables. - The
a
tag for links. - The
img
andmap
pictures. - Text layout. For example:
span
,strong
,em
.
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
Full list of supported tags - Unsupported HTML tags
- You can't insert the following in the instructions:
- Scripts.
- Frames.
- Objects, audio players, or video players (the
object
,audio
andvideo
elements).Tip. You can provide links to audio and video.
Editing the instructions
What's next
- Learn more about how to set up a project:
Troubleshooting
- 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.
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.