Skip to main content

How to create and publish a task in Task Builder

Task Builder lets you get a dataset annotated by participants on Prolific, all in one workflow. This guide shows you how to build your task, set up your study, and publish it.

Before you start, you’ll need a dataset in CSV or JSON format. You can upload a file or paste JSON directly. For help formatting your data, read our guide on preparing your CSV file for Task Builder.


Part 1: Build your task

1. Add your dataset

Add your dataset in CSV or JSON format, or paste JSON and select ‘Apply JSON’ to create tasks.

Here's an example of what your CSV file might look like:


2. Map your dataset

After you upload your file, Task Builder shows the “Dataset Mapping” section. It lists each column in your file as a field, with a sample value from your data underneath.

  1. Check the “Fields” and “Items” counts at the top right. They show how many columns and rows Task Builder found in your file

  2. For each field, open the dropdown and choose how Task Builder uses it. Task Builder suggests an option based on your data and shows it below the dropdown, for example “Suggested: Text”

  3. Select the checkbox to confirm you’ve read and agreed to the Task Builder Terms and Conditions

  4. Select “Next”


3. Add your task details

After you map your dataset, Task Builder asks for the details participants see before they start your task.

  1. Enter a Task name

  2. Add a Task introduction to explain what your task is about

  3. Add Task steps with clear, detailed instructions for what participants need to do

  4. Select Next to continue


4. Build your task experience

After you add your task details, Task Builder opens the visual builder. Drag components onto the page to design what participants see and do.

The “Task components” panel has three groups:

  • Questions: Collect responses from participants

  • Content: Add images or formatted text

  • Dataset fields: Show data from your uploaded file

To build your task:

  1. Drag a dataset field, such as “Prompt,” onto “Page 1” to show that data to participants

  2. Add any extra context with an “Image” or “Rich text” component

  3. Drag a question component for each response you need, such as “Star rating” or “Multiple selection”

  4. Select the plus icon next to “Page 1” to add more pages

  5. Select “+ Intro” or “+ Outro” to add a welcome or closing page

  6. Check the counts on the right to see how many questions, content blocks, and pages you’ve added

  7. Select “Preview as participant” to see your task the way taskers will

  8. Select “Save as draft” to finish later, or select “Save & set up study” to continue

Dataset fields can sit next to each other, such as two model responses, so participants can compare them side by side. If your task needs more room, select the plus icon next to “Page 1” to split it across more than one page.


Part 2: Launching your task

1. Set the number of tasks per participant

Once you're ready to set up your study, you'll be asked to set a limit on the number of tasks each participant can take. This is a maximum limit, not a minimum requirement. For example, if you set the limit to 5, a single participant can complete up to 5 tasks in one session.

It's important to note that this limit is based on the number of annotations, not the time spent on tasks.

Saving this limit locks your task design and the number of tasks per participant. You can't change either after you save, so double-check both before you continue.


2. Choose a project

After you set your task limit, Task Builder asks which project to add your batch to.

  1. Choose “Existing project” and select a project from the dropdown, or choose “New project”

  2. Select “Set up study”

  3. Select your batch and annotators

On the study setup page, go to the “Task Builder” section, then:

  1. Keep “Batch annotation” selected under “Task format”

  2. Check the “Select your batch” dropdown shows the batch you just built

  3. Enter how many participants should annotate each task

A batch is the set of tasks Task Builder creates from your dataset.

Once you’ve finished setting up your study, you’re ready to publish. For help with the rest of your study settings, read our step-by-step guide to setting up a study.


3. Download your data

Download your annotated data once participants have completed your tasks. You can access the annotation data directly from the submissions page. Additionally, you can download demographic data in a separate file.

Did this answer your question?