Developer guide: Create a project via the Python SDK The project is where you orchestrate all of your labeling operations. Use this guide to learn how to create a project and configure all available project settings.

​
Create a new project

To create a project via the Labelbox UI, follow these steps: Note: If you want to create a new project using the settings of an existing project, go to Duplicate a project section instead of starting a new project from the beginning.

​
Step 1: Start a new project

Under the top-level Annotate page, select New project. This will open a modal where you can configure your project type. Note that you will only be able to attach data rows that match the data type you set here. For example, you cannot select video as the data type upon project creation and then send image data rows to this project later.
After selecting a project type, name your project, optionally enter a description and select the type of data you will be labeling. If creating an LLM data generation project, you will also input a number of data rows to be generated by labelers.

​
Step 2: Add project tags (optional)

Configure project tags to enable easier organization and retrieval of the project.
You can also modify your project tags after setting up your project. From the project home page, hover over Tags and select the edit icon to configure your project tags.

​
Step 3: Add data

Labelbox allows you to send a batch or batches of data rows to a project for labeling. When you click Add data you will be sent to Catalog, where you can select a batch of data rows and send it to the project you are configuring.
In this step, you can filter and search your data rows to curate a batch. Select the data rows you wish to send to the project, then select Queue batch of n to add the data rows to the labeling queue.

​
Step 4: Submit batch

Next, you will have the option to configure the data row priority settings. Select Submit to send this batch to your labeling project.

​
Step 5: Configure the editor / attach an ontology

The final required step is to select the labeling interface (editor) that your project will use. To learn more about the various editors available, see our docs on labeling editors.

When you select Standard Editor, you will see a screen that lists all ontologies in your organization that match your project’s data type. Select the best ontology for your project or create a new ontology. For instructions on creating an ontology, see Working with ontologies.

​
Duplicate a project

In addition to creating new projects from scratch, you can now duplicate an existing project with its settings. You can clone a project in two places:
  1. By clicking on the three dots on the right side of any project in the Annotate page.
  1. From the dropdown menu within an existing opened project.
Below are the settings that can get copied when you Duplicate a project:
SettingCopied when cloned
Project Name
Project Tags
Project Description
Ontology
Quality
Batches
Data rows
Workflow instructions/setup
Performance
Issues
Issue Categories
Notifications
Import labels
Export
Members (settings)
External workforces
Models (for Live multimodal chat projects)
After cloning a project and verifying the settings, you can add data rows as shown in Step 4: Add data. Once you finish these steps, the Start labeling button will be activated.

​
Choose human workforce configuration

​
Option 1: Labelbox labeling services

Many customers need to use a dedicated external data labeling team. Labelbox offers a premium data labeling service integrated tightly into the Labelbox Annotate platform. See Labeling services for more details.

​
Option 2: Internal data labeling team

To learn how to invite, set up, and manage your own data labeling team, see Manage members.

​
Modify project settings

To update project settings, go to the Settings tab from with a project.
Any time during the life of a data labeling project, you can easily update key project settings. Below are the most common things you will likely need to update:
  1. Add or remove data rows.
  2. Update the ontology.
  3. Manage the team members assigned to a project.
  4. Configure webhooks.

​
Delete a project

A project can only be deleted by an organization-wide admin. To delete a project, go to Settings > Danger zone, and proceed with the deletion.

​
Warning

Deleting a project will also delete all the annotations that have been submitted for a project.