Define Taxonomy
The next step is to define your project’s taxonomy. This is where you specify what labels and attributes will appear to labelers in the Studio tasking UI. There are sample annotations already set up to showcase what a completed taxonomy could look like. You’ll need to delete these and replace them with your own based on your project requirements.
You can set your taxonomy up in 3 ways:
- Visual Editor
- JSON Editor
- via API
Setup Using Visual Editor
Depending on your task type, the visual editor will look slightly different. You can use the UI to easily define your labels, attributes, fields, events, and any other parameters.
You can add taxonomy items on the "Edit" panel. Adding taxonomy items is done via the purple drop-down button ("Add label") on the top right. Then, you can preview the taxonomy by going to the "Preview" panel. Your changes will be auto-saved when you go to the "Preview" panel.
For more information on taxonomy set up for each task type, visit the Taxonomy page.

Setup Using JSON Editor
You can also specify your taxonomy using JSON. This is especially useful if you have a similar Scale project with labels / attributes in a JSON format that you’d like to copy and paste into your new Studio project. To learn more about Scale’s JSON format for your task type, see our API documentation.
Find JSON Formatting details for each task type below:
- Image Annotation
- Semantic Segmentation
- Video Annotation
- Classification/Text Collection
- Named Entity Recognition
- Document Transcription
- LiDAR Annotation
Similar to the visual editor, your edits to the JSON viewer will save when you press "Preview" on the left panel.

Setup Using API
You can specify taxonomy via API as well. Setup using the API also allows you to specify taxonomy at the task level, rather than at just the project level. By altering the param
and instruction
fields on the task object that can be created through the API, customers can provide dynamic parameters for tasks created under Rapid projects.
We have the following task object reference:
Updated 9 months ago