Sandbox

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.

Toloka clients register and access Toloka sandbox using social authorization.

Note

If you registered in the sandbox using an email address, you can continue accessing the sandbox using the old domain address. We will help you migrate to the new sandbox address in the nearest future.

Make sure the projects you plan to use in the sandbox meet the usage rules.

Usage rules

  1. The sandbox is intended for testing tasks with small batches of data. Labeling an entire dataset is considered unfair usage of the service, unless you have a special agreement with us.

  2. The sandbox limits the number of trusted Tolokers and submitted tasks for testing your project. Limits are set by Toloka admins.

If you need a private data labeling environment for your own team, request the in-house data labeling option.

How to run a project in the sandbox

To register in the sandbox as a client and post tasks for Tolokers, you need to have one of the following supported social accounts:

  • Google
  • Facebook
  • GitHub
  • Microsoft
Note

Depending on your current location the list of the available social accounts might differ and include or exclude some of the social services.

Follow the steps below to run a project there.

  1. Register in the sandbox as a requester.

    Toloka uses social authorization both for the registration and signing in to the sandbox.

    To authorize in Toloka sandbox using one of the social accounts, go to the sign-in page.

    Registering
    Signing in

    1. Click the button with the social service name.

    2. You will be redirected to the selected service authorization page. Follow the service steps to sign in using your social account.

    3. Once you sign in to the selected service, you will be redirected back to Toloka. The system will invite you to enter some additional information (email address used for notifications, company name, country of origin, and some other optional information).

    4. When done, accept the Toloka Terms of Use and click Get started.

    Tip

    To avoid confusion, use the same social account 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:

    1. Go to the Toloker sandbox sign-in page.

    2. Click a social service where you have an account.

    3. You will be redirected to the selected service authorization page. Follow the service steps to sign in using your social account.

    4. Once you sign in to the selected service, you will be redirected back to Toloka. The system will invite you to enter your phone number and will send you a confirmation code to make sure that the phone number you entered is correct and belongs to you.

    5. If all is good, you will get access to the sandbox as a Toloker.

  2. Now log in to the sandbox using the requester account.

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

  4. Click Add Toloker and enter the phone number of the created Toloker or the Toloker ID.

    Where to get the Toloker ID

    Only trusted Tolokers can access your tasks. The number of trusted Tolokers required for testing depends on the overlap settings.

    Overlap settings

  5. Log in to the sandbox using the Toloker account and test your tasks. Make sure that the buttons and task 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 projects to the production version of Toloka

Restriction

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.

To move projects 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 Plus sign Generate token, create a new API key, and copy it.

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

  2. Go to the project page in the sandbox and click Drop-down button → Export button Export.

  3. Choose the pools to export and click Export.

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

Troubleshooting

I want to create a project in the sandbox and see my pool as a Toloker. How can I do this?
Is it possible to use the same account for the sandbox and the public Toloka version?
What do I do if an error occurs on the server when I try to export a project from the sandbox?
How do I check my project in the mobile version of Toloka?
Will a copy of the project exported from the sandbox be updated in the main version if I edit the original?
Why isn't anything happening when a test Toloker clicks “Submit” in the sandbox?
How do I move control tasks from the sandbox to the main pool?
Why don't I see my task in the sandbox?
I can't add a trusted user.
Contact support

Last updated: August 29, 2023

Introduction
Getting started
Important tips
Useful recommendations
Working with Toloka
Projects
Pools
Tasks
Results
Project analysis
Toloka settings
Task interface
Template Builder
HTML/CSS/JS editor
Help and support
FAQTroubleshootingSupportGlossary