> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Start a project from a template

> Launch a project from a ready-made template — pick what you need done, open a template, answer the assistant's questions, attach your data, and deploy.

A template is a project configuration someone has already built and tuned: the labeling interface, the quality criteria, the expert onboarding, and the audience and pricing defaults. The current templates cover two data-collection jobs: egocentric activity video and app crowdtesting. Pick one, answer a few questions, and deploy. If neither matches your job, [have the agent build the project from your description](https://docs.platform.toloka.ai/docs/data/recipes/agentic-project.md) instead.

## Before you start

You need:

* An account you can sign in to.
* **Full access** to the selected team. If you belong to several teams, [switch to a writable team](https://docs.platform.toloka.ai/docs/core/teams-and-balance.md#switch-teams) before choosing Data collection. Read-only members cannot create a project.
* A team with a funded balance. A template run incurs labeling charges, so deployment is blocked on an empty balance. See [Manage your team and balance](https://docs.platform.toloka.ai/docs/core/teams-and-balance.md).
* Your data, if you have it. You can also let the assistant build the dataset for you, which is what the collection templates do — they generate one empty slot per recording.

## Step 1 — Say what you need done

Sign in. The home screen asks **What do you need done?** Click **Data collection**. The current templates collect egocentric activity video or app-testing recordings. For an existing dataset that needs annotation, ranking, transcription, or moderation, choose **Data labeling** and [have the agent build the project](https://docs.platform.toloka.ai/docs/data/recipes/agentic-project.md) instead.

![The home screen asking “What do you need done?”, with the Data collection and Data labeling cards.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/use-case-cards.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=1d17f766687e72f66ff4f58cbabc5f40)

Your choice creates a draft project, opens the **Let’s set your task** screen, and narrows the templates below to the ones that fit it.

## Step 2 — Open a template

Under the description field is a **Use a template** section. Each card names a template and says what it collects. Click the one that matches your job.

![The Use a template section with a template card: an icon, the template name, and a one-line description.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/template-cards.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=20667799b7f9a07eaeab513f312f7eaf)

> [!NOTE]
>
> The **+ Project** button on the Projects page also creates a draft, but it skips the use-case question, so the section lists every template instead of the ones for your job.

> [!NOTE]
>
> To reuse a pipeline you built in another project, click **Import pipeline** in the **Import** section below the templates, and choose the `.pipeline` file saved with **Export** in the source pipeline's **More pipeline actions** menu. That file holds the pipeline configuration, not results. The project opens with that pipeline, but without its dataset or item filter. Attach a dataset, set the filter again if you need one, and check the item count on the Start node before you deploy.

## Step 3 — Check the preview, then continue

The card opens a preview: the pipeline the template will build, and a summary of the prompt it will send to the assistant on your behalf — including the defaults it assumes for the expert audience, price per item, and item length. Read the summary; those defaults are what you will be changing later if they do not fit.

![The template preview dialog: the template name, a pipeline preview image, the Summary of the prompt section, the note “Next: the agent confirms the details with you”, and the Continue button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/template-preview.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=5b43df01f3d97e843c6030e8274bb948)

Click **Continue**. Three things happen at once: the project takes the template's name, a first pipeline appears already configured from the template, and the assistant starts work on it.

The chat opens with **Started from preset**, followed by the agent's summary of what the project collects, its defaults, and the questions you need to answer.

> [!NOTE]
>
> The pipeline is built at this point, but it is not yet pointed at any data. That is what the next two steps are for.

## Step 4 — Answer the assistant's questions

The assistant asks everything it needs in one go, right after its opening message. You answer the questions one at a time; some offer suggested answers, and you can type your own instead.

![An assistant question: “How many videos do you want to collect?” with suggested amounts, a free-text option, and a Next button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/assistant-questions.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=a0857e1acad5a8e8aa63b8688aca1a1f)

What each template asks:

* **Egocentric Activity Video Collection** — three questions. How many videos you want (50, 100, 250, 500, or 1000); whether to keep the default list of 13 household activity categories, narrow it, or collect a different domain; and which of the defaults you want changed — audience languages and countries, price per task, time per task, the per-expert cap, and the minimum clip length. "Nothing" is a valid answer to the last one.
* **App Crowdtesting** — four questions. How many recordings you want (50, 100, 250, or 500, one per tester); the install link testers download the build from; what the app is and whether testers should be on Android or iOS; and what a good test session looks like — plain prose describing what a tester should have done by the time they stop recording, including anything off-limits such as paying or deleting an account.

Answer all of them. The assistant does not touch the pipeline until it has your answers, so this is the cheapest point to change your mind about scope, price, or audience.

Once it starts building, it works through a fixed sequence — create the dataset, point the pipeline at it, apply your answers, validate — and then plays the result back for you to correct or approve in one round.

## Step 5 — Attach your data

Upload your dataset, or ask the assistant in the chat to generate one. Templates that collect fresh data — recordings, photos, test sessions — do not need a dataset from you: the assistant creates one row per item you want collected and wires it to the pipeline.

![The project sidebar with the Datasets section, before any dataset exists.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/upload-dataset.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=b1e5f2537aa3badc7a6180ae502c5651)

For uploading your own file and setting up its fields, see [Create and manage datasets](https://docs.platform.toloka.ai/docs/core/datasets.md).

## Step 6 — Review each node

Open the pipeline and check every node before you launch. The template's defaults are a starting point, not a recommendation for your budget: price per task, time per task, the audience filters, the labeling interface, and the expert guidelines are all yours to change.

![A node's Audience & Pricing settings: expert filters, the expert count and recommended rate, time for task, price for task, and the per-expert cap.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/node-configuration.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=8eb3665f8071da5371e79220addfc2d9)

The expert count and recommended rate shown next to your audience filters tell you whether the audience is large enough and whether your price is in the range that pool expects.

## Step 7 — Deploy

Click **Deploy**.

![The Deploy button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/deploy-button.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=324536ed467191e3fe64e9614917881b)

If anything is wrong, an **Issues** panel opens instead of launching. Errors — in red — block the deploy. Warnings, in orange, do not.

![The Issues panel grouped by pipeline and node, listing errors and warnings, with the Fix all with agent button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/fix-all-with-agent.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=a39cd6d17d74bc064bd1da20a3a3c8c7)

Click **Fix all with agent** and the assistant works through the list. Then go back to Step 6, check what it changed, and deploy again.

Once no errors remain, you can launch with the warnings still open: tick **I want to deploy with unresolved warnings**, then click **Deploy**.

![The Issues panel with only warnings left, the “I want to deploy with unresolved warnings” checkbox, and the Deploy button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/deploy-with-warnings.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=2f5d9555f00013b5777ca0009a9a9423)

> [!WARNING]
>
> An unrun test check is a warning you can override; unfinished lints and failed checks block deployment. Review the [self-check results](https://docs.platform.toloka.ai/docs/data/concepts/self-check.md) before launching. If you need configuration changes afterward, clone the pipeline and deploy the copy. You still pay for billable work recorded on the original run.

## Step 8 — Confirm the cost

The cost breakdown opens, line by line, with an expected and a maximum total. If it is more than you want to spend, cancel, go back to Step 6, and lower the price per task or the item count.

![The cost breakdown: one line per cost component with expected and maximum totals, the review checkbox, and the Confirm and deploy button.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/confirm-and-deploy.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=3fdf6ab853d4d82b89207ac70ce0da9f)

Tick the review checkbox and click **Confirm and deploy**. Billing is pay-as-you-go: work is charged as the run processes items, so the final cost can differ from the forecast. See [Pipeline pricing](https://docs.platform.toloka.ai/docs/data/concepts/pricing.md) for what drives each line.

## Step 9 — Wait for the launch

**Launching Pipeline** appears and tracks the deploy step by step. It usually takes 5–15 minutes, and you can close the window and come back.

![The Launching Pipeline window: starting deployment, checking balance, connecting dataset, deploying nodes, preparing pipeline items.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/cookbook/preset-project/deploying.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=aba0fb026826fbc782b5b596129e7343)

When it finishes, the tasks are live for experts.

## What's next

* [Export your labeled results](https://docs.platform.toloka.ai/docs/data/guides/export-results.md) when the run has results.
* [Resume or cancel a pipeline run](https://docs.platform.toloka.ai/docs/data/guides/pause-resume-cancel.md) if you need to stop it.
* [Troubleshoot a pipeline run](https://docs.platform.toloka.ai/docs/data/guides/troubleshoot.md) if items are not getting done.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.