Button with click validation

If a task requires a performer to click a link (for example, to open a webpage), Yandex.Toloka can check if the performer did it. The link is displayed in the task as a button.

Variations of button use:

• Checking if the user opened a link. The output data will contain a field with values true (the performer opened the link) or false (the performer didn't open the link).

• Preventing the user from completing the task if the link was not opened. Add the "allowed_values":[true] parameter in the output data description.

To add the button with the link to the task interface, use the {{field type="button-clicked" name="output field name>"}} component. Example:

{{field type="button-clicked" name="ads" label="Нажми меня" href="https://yandex.ru" action=true}}

For a complete list of parameters, see the table.

Add a field of Boolean type to the output data description. To prevent the user from sending responses without opening the link, add the "allowed_values":[true] parameter.

{
  "ads": {
    "type": "boolean",
    "required": true,
    "allowed_values": [true]
  }
}

Parameters

Parameter	Description	Required	Default value
type	Field type: button-clicked — button with click validation.	yes	no
name	Attribute for the output data field. Contains the output field name.	yes	no
label	The button label. Example: label="Click me".	no	no
href	URL that the performer must open to complete the task.	no	no
size	Size of the field. Supported values: "S", "M", "L", "XL".	no	"L"
action	Button color: action=true — Yellow. action=false — White.	no	false

Parameter	Description	Required	Default value
type	Field type: button-clicked — button with click validation.	yes	no
name	Attribute for the output data field. Contains the output field name.	yes	no
label	The button label. Example: label="Click me".	no	no
href	URL that the performer must open to complete the task.	no	no
size	Size of the field. Supported values: "S", "M", "L", "XL".	no	"L"
action	Button color: action=true — Yellow. action=false — White.	no	false