back Download and import

Learn more on how you can download a label tree and use it elsewhere.

To download a label tree, click in the dropdown menu at the top of the label tree overview. This will start the download of the label tree export file. The label tree export file can be useful in many scenarios. You can use it to publish the label tree on platforms like Zenodo so it gets a DOI and can accompany one of your publications. You can also use the export file to import the label tree in another BIIGLE instance.

To import a label tree from an export file, first click the button on your dashboard. Next, click the button in the create label tree view. In the next view, you can select the export file of the label tree that you wish to import. Click to upload the file and perform the import. Label trees that already exist in a BIIGLE instance cannot be imported again. You can fork the label tree in this case.

Label tree export format

A label tree export file is a ZIP archive that contains two files, label_tree.json and labels.csv.


This is a JSON file that contains the following properties of the label tree:

  • id: The ID of the label tree in the BIIGLE database.
  • name: The name of the label tree.
  • description: The description of the label tree. May be empty.
  • created_at: The date and time when the label tree was created.
  • updated_at: The date and time when the label tree was last modified.
  • uuid: The globally unique identifier of the label tree (UUID4).
  • version: An object that contains the id, name and doi of the version of the label tree. This is null if the label tree has no version.


    "id": 240,
    "name": "CATAMI",
    "description": "The CATAMI classification scheme.",
    "created_at": "2019-06-13 08:55:41",
    "updated_at": "2019-06-13 09:20:30",
    "uuid": "620b4105-124e-43a8-af43-16964a9fa192",
    "version": {
        "id": 122,
        "name": "v1.4",
        "doi": "10.5281/zenodo.3374162"


This is a CSV file that contains a list of all labels of the label tree. The CSV file has the following columns:

  1. id: The ID of the label in the BIIGLE database.
  2. name: The name of the label.
  3. parent_id: The ID of the parent label of this label. The ID must match one of the IDs in the first column. May be empty if the label has no parent.
  4. color: The RGB color code of the label in hex notation.
  5. label_tree_id: The ID of the label tree to which the label belongs. This must match the ID of the label tree in label_tree.json.
  6. source_id: An arbitrary identifier of the label in an external database like WoRMS. May be empty.


id name parent_id color label_tree_id source_id
17406Articulated calcareous1755352bef9240
17409Bacterial mats1741869f0ba240
17411Barnacle plates17417f3c064240