Skip to main content

Setting up a project

General Information#

If in the course of working through this guide you find anything is unclear or does not work as expected, do not hesitate to reach out to us at

In this document we use annotation and label interchangeably.

Create a Login#

Visit the Encord login page and click continue with Google. Go through Google's authentication process to complete registration. Alternatively, visit the Encord registration page, enter your email address, desired password and click register. You will be sent a confirmation email. Click on the link in the email to complete registration.

Introduction to setting up a project#

Setting up a project follows an 4-step process. We will discuss each step in detail in this document.

  1. Dataset: Create a dataset that you want to annotate
  2. Ontology: Create an ontology (taxonomy, label protocol). The ontology contains the information and structure about the annotation task.
  3. Annotation Project: Create a project and attach the dataset and ontology.
  4. Team Management: Add team members to the project (annotators, reviewers, administrators) and define roles and responsibilities.

1. Dataset#

To create a new dataset, click the + New dataset button in the Datasets view. This initiates the dataset creation flow, a simple step-by-step process for turning your files into datasets.

Enter details#

In the 'Enter details' screen, enter a dataset title and optional description. A clear title and description helps keep your data organized and helps collaborators find what they are looking for. When you are happy, click Next.

Upload data#

The 'Upload data' screen allows you to upload your data files.

You can upload files directly from your computer or integrate with your own private cloud data provider by toggling the Private cloud toggle.

Upload videos from a computer#

Click the upload rectangle or drag video files into it to add your files. Once uploaded, files will appear in the Dataset data section on the right. Successful uploads will have a green tick; unsuccessful one will have a red cross.

Upload images from a computer#

Click on the Image upload button to launch the 'New image group' pop-up.

Images in Encord are organised into 'Image groups'. An image group is a collection images compressed into a sequence of frames, allowing for more efficient annotation of semantically similar images. You can still label each image individually, however.

Click the upload rectangle or drag image files into it to add your files. Once you are happy with your image group, click the Create image group button. Similar to video files, files will appear in the Dataset data section on the right once uploaded.


Images in a group are all assumed to be the same resolution. If the resolutions of the images don't match, they will be separated into different groups of matched resolutions.

Connect to private cloud storage#

You can also link data that you have stored in a cloud provider by toggling the Private cloud toggle above the upload section.

We provide integrations for Azure, Google Cloud Platform, Amazon's S3 and Open Telekom Cloud. Please check the Private Cloud Integration section on how to integrate your cloud data.

Create the dataset#

Once you have uploaded or connected all your data, click the Create dataset button to create your dataset. This will now appear as a row in the Datasets view with the appropriate title and description.

2. Ontology#

Create an ontology (taxonomy, label structure). The ontology contains the information and structure about the annotation task. Our Ontology documentation offers a detailed overview.

Ontologies (label structures) are hierarchical structures which capture concepts and categories present in your data, and allow for nested attributes for fine-grained differentiation or detailed annotations.

  • Objects are used in object detection and segmentation, when you want to annotate not only the category but also the location.
  • Classifications (sometimes known as frame level classifications on Encord) annotate whether or not something is present in a given frame, but don't require localization data.
  • Nested classifications can be nested under objects, classifications, and even other nested classifications to create deeply nested structures capable of modeling complex and even conditional attribute relationships.

Start creating the ontology#

The ontology creation flow starts with the 'Enter details' screen, where you enter the title and description. Descriptions are optional, but clear descriptions can help you and your team stay organized. There is no need to be perfect, you can always edit the title and description after creation as well. Press Next to move on once you're satisfied.

Screenshot of ontology details step

The 'Configure the editor' screen is where you intialize your ontology's structure. Use the '+' buttons under the Objects and Classifications section to add them to the structure. You can use nested classifications to create expressive, hierarchically descriptive structures and attach classification modifiers to aid in the annotation process or dynamically annotate data, as necessary. Reference the structure. Use the '+' section of the documentation below for full details on the significance and configuration details of each component.

Screenshot of ontology structure

As you are editing the structure, the 'Sandbox' view will offer a preview of how the ontology will appear to your annotators in the label editor. You can expand and contract individual elements by clicking on them to confirm the tree structure of the ontology. You can also view the ontology's JSON representation by toggling the ‘Display json’ toggle on the upper right. This may be useful if you are using Encord's SDK or API.

Ontology JSON Preview
{  "objects": [    {      "id": "1",      "name": "Apple",      "color": "#D33115",      "shape": "bounding_box",      "featureNodeHash": "dfa43291",      "attributes": [        {          "id": "1.1",          "name": "Color",          "type": "radio",          "required": false,          "featureNodeHash": "3a2d7e3e",          "options": [            {              "id": "1.1.1",              "label": "Red",              "value": "red",              "featureNodeHash": "d262efe3"            },            {              "id": "1.1.2",              "label": "Green",              "value": "green",              "featureNodeHash": "05e37fad"            }          ]        }      ]    }  ],  "classifications": [    {      "id": "1",      "featureNodeHash": "621710a2",      "attributes": [        {          "id": "1.1",          "name": "Orientation",          "type": "radio",          "required": false,          "featureNodeHash": "2313aee5",          "options": [            {              "id": "1.1.1",              "label": "Top view",              "value": "top_view",              "featureNodeHash": "cc336600"            },            {              "id": "1.1.2",              "label": "Side view",              "value": "side_view",              "featureNodeHash": "02d60e6f"            }          ]        }      ]    }  ]}

Edit ontologies#

You can continue to edit and update the ontology after you've created it. Please refer to corresponding section in our documentation Editing Ontologies.

3. Annotation Project#

To create a new project, click the + New project button in the Projects view. This initiates the project creation flow, a simple step-by-step process for creating new projects.

Enter details#

In the 'Enter details' screen, enter a project title and optional description. A clear title and description helps keep your projects organized and helps collaborators find what they are looking for.

If you're part of an organization, you will see an optional project tags dropdown. Project tags are useful for categorizing your projects. Select as many tags as are relevant to your project.

If you would like to enable multiple label reviews at a time, please press the 'Display multiple reviews' toggle switch. Please note this feature is currently in beta.

When you are happy, click Next.

Select datasets#

The 'Select datasets' screen is where you attach datasets to your project. You can select from a list of datasets you have already created, or you can create a new dataset by clicking the '+ New dataset' tab which initiates the dataset creation flow. Identify the datasets you would like to incorporate and click the Add button to attach them. Attached datasets will appear in a list on the right.

Select ontology#

The 'Select ontology' screen is where you specify your label structure (also called an ontology). Encord offers support for objects and frame level classifications, all with arbitrarily deep nested attributes.

You can reuse a pre-existing ontology, or create a new one by clicking the + New ontology tab which initiates the ontology creation flow. Choose the ontology you want to use and click Select to use it with the project. You can see the preview of the label editor sandbox on the right.

Create the project#

Once you are happy with your label structure, click Create project to complete the process.

4. Team Management#

The Encord platform has a variety user types with different access to the platform and its features. Depending on the type of user access (annotator, reviewer, admin), the person needs to be added to different parts of the platform. We will discuss this in detail below.

The Organization documentation offers a detailed overview.

Project User Roles#

  • Annotator: Creates labels/annotations
  • Reviewer: Reviews annotations
  • Annotator and reviewer: Has access to both annotator and reviewer features
  • Team manager: Access to certain team management features
  • Admin: Full access to all project interfaces and features, usually used by those who setup the ontology, datasets and assign various team members. In order to successfully attach ontologies and datasets to a given project, a user must have Admin permissions against each target resource.
PermissionAdminTeam managerReviewerLabelerLabeler + Reviewer
Import data/create new datasetsX
Attach a dataset to a projectX
Detach a dataset from a projectX
Create/modify ontologiesX
Add/edit/delete projectsX
Add/modify member rights on a projectXX
Create/modify labels, access labeling queueXXXX (own only)X
Review labels, access labeling queueXXX (own only)X
Delete labels, access review queueXXXX
View own & team's performance metricsXXX (own only)X (own only)X (own only)
Import and export of dataX

Add users to your project#

You are able to add different user groups to a project depending on your status:

  • Admins: can add admins, annotators, reviewers, annotator + reviewers and team members directly to a project.
  • Team managers: can add annotators, reviewers, annotator + reviewers directly to a project.
  • Annotator, reviewers and annotator + reviewers: cannot add anyone to a project.

You can add new users by going to the Projects tab, and then to Settings and Team. Click on invite collaborators and add the email address. Then define their role.

How to add Admins#

In this walkthrough we've discussed the permissions of Admins in relation to projects, but also mentioned that users need to be assigned a role in relation to the various resources on the platform. Because the resources on the platform can be linked to each other in a many-many-many fashion (.e.g a specific ontology can be assigned to multiple projects), we've provided this fine-grained access control functionality to ensure there are no accidental or unintended changes to your various ontologies (link), datasets (link) and projects (link).

Only admins of a specific resource can add other admin users to that resource -- with the exception of Organizational level admins -- who can add themselves as an Admin to any resource owned by your organization. Once someone is an Admin for a given resource, they can not be removed. If you must remove an admin, please reach out to