back Projects

Learn what projects are and how to manage them.

Projects are used to associate a group of users with a group of image collections (called volumes) and label collections (called label trees). What a project represents is entirely up to you. This may be all members and images of a certain expedition or cruise, the members and data of a certain research group or something entirely different.

Every user is allowed to create projects. To create a project, click on the button on the dashboard (or here). When you successfully created a project you will be redirected to the project overview. The overview shows you a list of all volumes, label trees and users that are associated with the project as well as several controls to modify the project.


Each project is only visible to project members. Each member has one of four roles: admin, expert, editor or guest. To modify project members you must be admin in the project. Click on the button of the members panel to modify members. Enter a username and choose a role to add a new member. Choose a new user role for existing members to modify them. Click the × button to remove a member.

A guest is not allowed to modify anything in project. They can see all volumes, label trees and users that belong to the project. But they cannot modify anything related to the project and particularly cannot create or modify annotations in the volumes that belong to the project. A guest is able to access all label trees that are attached to the project, even if a label tree is private and the gurest is no member of the tree.

In addition to everything that a guest can do, editors can create and modify annotations, annotation labels and image labels. However, they cannot delete annotation labels or image labels that were created by other users. Editors should be the default choice for new project members.

The term "annotation" refers to a point or a region that is marked on an image. An "annotation label" is a label that is attached to an annotation by a certain user. Each annotation automatically gets its first annotation label attached to it when it is created. Other users (or you) are able to attach additional annotation labels to the same annotation. An "image label" is a label attached to a whole image instead of an annotation.

An expert can do everything that an editor can do. In addition to that, they can modify or delete annotations or image labels of other users as well. Choose this role if a user should be able to "supervise" other editors but should not be a full project admin.

A project admin has no restrictions in what they can do. They can create and modify annotations, annotation labels and image labels, including those of other users. Also, they can add or modify project members, attach or detach label trees and manage volumes. Finally, project admins are able to edit the project name and description or delete the entire project.

Label trees

There can be one or more label trees attached to each project. Only the labels of these label trees will be available when annotations, annotation labels or image labels are created in the project.

Project admins can attach or detach label trees. To do this, click on the button of the label trees panel. Enter the name of a label tree and hit enter to attach it. You can only attach public label trees or those that authorized the project to attach them. Click the × button to detach a label tree.

You can also create a label tree and attach it to the project at the same time. Do this with the button of the label trees panel. This is useful to create a new label tree specifically for the current project.


A volume is a collection of images that belong together (like a directory in a file system). Each project can have one or more volumes attached to it. Unlike label trees, volumes always belong to at least one project. If a volume belongs to no project any more, it will be deleted.

Project admins can create or delete volumes. To create a volume, click the button of the volumes panel. A new volume will be automatically attached to the project it was created for. But volumes can be shared between projects, too. You can attach existing volumes of any project where you are also admin. To do this, click on the button of the volumes panel, enter the name of the volume you want to attach and hit enter. Click the × button to detach or delete a volume. A volume is deleted only if this is the last project that it is attached to (there will be an additional request for confirmation in this case). Be careful when doing this since deleting a volume deletes all annotations and cannot be undone!

Modify a project

Projects have a name and short description text so users can identify them. Project admins can edit these fields in the project overview. Click to make the name and description editable. Click once you are finished or to reset your changes.

As a project admin you cannot modify yourself as a project member in the members panel. If you want to have another role in the project, ask another admin to change it. If you want to leave the project, click the button. Note that you can only leave a project if it has at least one other admin to manage it.

Finally, project admins can delete a project with a click on the button. This will detach all label trees and volumes from the project. All volumes that are not attached to another project will be deleted. Be very careful when you want to delete a project since you can destroy lots of annotations with a single action!