Toloka documentation


The Sandbox is a testing environment for Toloka. This is where you can test your project settings as a Toloker before moving them to the Toloka production version and running the project for real Tolokers. This helps you avoid making mistakes and spending money on a task that isn't working right.


Note that you can move only project and pool settings. You can't move tasks and responses to them. The project's quality control settings can't be moved, either.

How to run a project in the sandbox

  1. Register in the sandbox as a requester. To do this, follow the link.


    To avoid confusion, use the same Yandex ID that you used in the Toloka production version to register as a requester.

  2. Configure and launch your project:

How to complete tasks

To complete your tasks in the sandbox:

  1. Register in the sandbox as a Toloker (see the instructions in the user documentation ).


    Authorization via social media isn't allowed, so you need to register a new user in Yandex.

  2. Log in to the sandbox using the requester account.

  3. Open the Tolokers page and click Add trusted Tolokers.

  4. Click Add Toloker and enter the case-sensitive username of the created Toloker.

    Only trusted Tolokers can access your tasks.

    The number of trusted Tolokers required for testing depends on the overlap settings.

    To test your project in the Sandbox, set overlap 1. If you increase the overlap, you will need to register more Tolokers and add trusted accounts.

    When exporting a project to the production version of Toloka, you can specify the necessary overlap in accordance with your project goals.

  5. Log in to the sandbox using the Toloker account and test your tasks. Make sure that the buttons and response validation are set up correctly, and assess how long it takes to complete the tasks. Make sure that the Toloker selection and quality control work.

How to move a task to the production version of Toloka

To move tasks from the sandbox to the production version:

  1. Link the sandbox and production version accounts:

    1. Open the Integrations tab in the production version on the profile page, click Get OAuth token, and copy the OAuth token displayed.

    2. Open the same tab in the sandbox on the profile page, paste the copied token into the Main Toloka OAuth token field, and click Add OAuth token.

  2. Go to the project page in the sandbox and click Export.

  3. Choose the pools to export and click Export.

    If the pool has linked training, it is exported automatically.


How do I work with the Sandbox?

Register as a requester in the sandbox.

Register as a Toloker using another account.

In your requester account, add your Toloker account to your trusted list.

Create and run a task. It will appear in the list of tasks for your trusted users. For more information, see Help.

How do I see my pool through the eyes of a Toloker?

To test your task, add yourself as a trusted Toloker in the Sandbox. To do this, on the Tolokers page, click Add trusted users. Enter the username for the Toloker's account (case-sensitive).

Is it possible to use the same account for the Sandbox and the public Toloka version?

No, you need a separate account for each version of Toloka. To create a task in the Sandbox, register in it as a requester. To complete your own task, register another account for yourself as a Toloker.

What do I do if an error occurs on the server when I try to export a project from the Sandbox?

Try exporting the project without pools.

  • Select an exported project and don't select pools in the window that opens.
  • Click Export.

If the error persists, refresh the token.

  • Go to Yandex ID.
  • Under Sign in and device history, click Log out from all devices.
  • Request new tokens in the Sandbox and main environment.
  • Update the token in the Sandbox Profile.
How do I check my project in the mobile version of Toloka?

To do this, you will need a Sandbox version of the Toloka app. Write to support to get it.

Will a copy of the project exported from the Sandbox be updated in the main version if I edit the original?

You won't be able to update a previously exported project. If you clone a project from the sandbox again, its current copy is added. The old project doesn't change.

Why isn't anything happening when a test Toloker clicks Submit in the sandbox?

Use your requester account to preview the pool and check whether it's possible to submit a task. If this fails, most likely there is an error in your project.

How do I move control tasks from the Sandbox to the main pool?

The tasks themselves are not exported, only the project configuration and the settings of the selected pool. You can download the completed tasks from the pool in the Sandbox and import them to the exported pool.

To download only the control tasks (if you completed them in the interface), go to Mark up, then click Control tasks and Download.

Why don't I see my task in the Sandbox?

Make sure that:

  1. The pool is started.

  2. The Toloker is added as a trusted.

  3. The trusted user is registered in the sandbox as a Toloker.

  4. The trusted user didn't use social networks when registering.

  5. Your trusted user matches the filters you set.

I can't add a trusted user.

Possible reasons:

  • The Toloker isn't registered in the sandbox. The account you registered in the Toloka production version won't work. Make sure you have specified the correct Toloker's account as a trusted one.

  • The Toloker's account is authorized via social networks.Register a new user in Yandex.

What overlap should I set?

Overlap defines how many Tolokers complete the same pool task.

The best overlap is an overlap that provides satisfying quality of results. For most tasks that are not reviewed, overlap from “3” to “5” is enough. If the tasks are simple, overlap of “3” is likely to be enough. For tasks that are reviewed, set overlap to “1”.

Can I change overlap after the pool is started?

Yes. Open edit mode for the pool and set a new overlap value. You don't need to restart the pool. Updating the settings is usually fast, but if there are many tasks, it may take several minutes.