# How to annotate

{% hint style="info" %}
This 5-minute tutorial is a part of introduction to Supervisely series. You can complete them one-by-one, in random order, or jump to the rest of the documentation at any moment.

* [How to import](https://docs.supervisely.com/getting-started/how-to-import)
* How to annotate **(you are here)**
* [How to invite team members](https://docs.supervisely.com/getting-started/invite-member)
* [How to connect agents](https://docs.supervisely.com/agents/connect-your-computer)
* [How to train models](https://docs.supervisely.com/getting-started/how-to-train-models)
  {% endhint %}

{% hint style="success" %}
You can learn more about Labeling, such as labeling of videos and 3D point clouds, using AI-assisted labeling and more in [this section.](https://docs.supervisely.com/labeling/labeling-toolbox)
{% endhint %}

Once you've [uploaded your first images](https://docs.supervisely.com/getting-started/how-to-import), let's annotate them with our multiple **annotation tools** - [Bounding Box](https://supervisely.com/blog/bounding-box-annotation-for-object-detection/), [Polygon Tool](https://supervisely.com/blog/how-to-use-polygon-anotation-tool-for-image-segmentation/), [Brush and Eraser Tool](https://supervisely.com/blog/brush/), [Mask Pen Tool](https://supervisely.com/blog/mask-pen-tool/), [Smart Tool](https://supervisely.com/blog/smarttool-annotation/), [Graph (Keypoins) Tool](https://supervisely.com/blog/animal-pose-estimation/), effectively supports 1000+ objects per image.

Click on the project you've just created. This will open the list of datasets (subfolders) inside your project (you can learn more about data organization [here](https://docs.supervisely.com/data-organization/overview)). Depending on whether you uploaded a set of folders with images or just images directly, there may be one or more datasets.

{% hint style="info" %}
Don't worry - you can move and copy images between datasets (and even projects) using the “three dots” (⋮) or [Data Commander.](https://docs.supervisely.com/data-organization/data-commander)
{% endhint %}

<figure><img src="https://1080806899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4BHwRbuyIoH-xoF3Gv%2Fuploads%2FN70hau6FKJLPhQLOzfec%2Fdataset.png?alt=media&#x26;token=0a561d44-4e24-417b-b5fa-4a1f2165865f" alt=""><figcaption></figcaption></figure>

At the top of this page you will find more tabs, such as classes and tags. There you can define a meta information, shared across all of the datasets inside a particular project. Let's focus on [classes](https://docs.supervisely.com/getting-started/broken-reference) first.

A class allows you to define a type of your annotations. Every annotation object must have exactly one class. For example, you can define a class “Car” and limit it the shape “bounding box”: now, if you define a [labeling job](https://docs.supervisely.com/labeling/jobs) and assign your [team member](https://docs.supervisely.com/collaboration/members) to annotate a bunch of images with “Cars”, they will only be able to place bounding boxes and label them as “Cars” (unless you configure more classes, of course).

Now, let's go to the classes tab and click the `New` button. Let's enter some title to it, select a shape (let's select “bounding box” for this one) and click `Save`.

{% hint style="info" %}
You can select “Any Shape” - that will allow to mark annotations of any shape with this class, so can have both “bounding box” and “mask” marked as this class at the same time. Be worried, that could potentially create issues when you try to train a neural network.
{% endhint %}

<figure><img src="https://1080806899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4BHwRbuyIoH-xoF3Gv%2Fuploads%2F0zkoRtCouMhYng6KQgQw%2Fcreate-class.png?alt=media&#x26;token=ccc356c9-9714-4a1c-98cd-d891f12f72d4" alt=""><figcaption></figcaption></figure>

Awesome! Now, switch back to the **Data** tab and click on any dataset. Once you're inside the dataset, selecting any image or clicking the `Annotate` button will bring up a dialog asking you to choose a labeling toolbox ( yeah, we have lots!). Select an “Image labeling toolbox 2.0”. A new tab should appear with your dataset in the labeling toolbox.

{% hint style="info" %}
You can label all data in your project at once by using the `Annotate` button on the dataset page.
{% endhint %}

<figure><img src="https://1080806899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4BHwRbuyIoH-xoF3Gv%2Fuploads%2FEHZ8a8gBhrCHRoEFRc8X%2Fopen-toolbox.png?alt=media&#x26;token=673be66f-7012-43da-a177-6a453adf5bab" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can switch the dark theme to light or back at any time.
{% endhint %}

From the left toolbar select a tool that corresponds to your class shape, in our case, [<mark style="color:blue;">Bounding Box Tool</mark>](https://supervisely.com/blog/bounding-box-annotation-for-object-detection/) to create bounding boxes. You can hover your cursor over the particular tool button and check the description.

Now, let's hover the cursor over any object on your image and make two clicks to form a rectangle around it. You will see a new object in the right sidebar at the `Objects` tab. Done!

<figure><img src="https://1080806899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4BHwRbuyIoH-xoF3Gv%2Fuploads%2FjYETWn3b2RVaukAVHgdC%2Fcar-annotate%20(1).gif?alt=media&#x26;token=b05c1a22-96dd-4736-924d-bdf1d81b5ee6" alt=""><figcaption></figcaption></figure>

You can also check our blog post on how to label with bounding boxes:

{% embed url="<https://supervisely.com/blog/bounding-box-annotation-for-object-detection/>" %}

You rock! Now, you can explore other labeling tools (such as [polygons](https://supervisely.com/blog/how-to-use-polygon-anotation-tool-for-image-segmentation/), [<mark style="color:blue;">masks</mark>](https://supervisely.com/blog/smarttool-annotation/) or [<mark style="color:blue;">skeleton shapes</mark>](https://supervisely.com/blog/human-pose-estimation/)), more advanced tools, such as video or [<mark style="color:blue;">3D point clouds</mark>](https://supervisely.com/blog/3d-object-interpolation-in-point-clouds/) - or continue our journey and see how [collaboration](https://docs.supervisely.com/collaboration/members) works in Supervisely.
