Manage Your Recipes
  • 15 Aug 2025
  • Dark
    Light
  • PDF

Manage Your Recipes

  • Dark
    Light
  • PDF

Article summary

This page helps you to edit, export ontology, clone recipes, etc. used across your datasets and annotation projects.

Edit a Recipe

  1. Click on the Recipes from the lift-side menu.

  2. Locate or search for the desired recipe in the list.

  3. Click on the ⋮ Three Dots and select Edit Recipe from the list.

  4. Make required changes and click Save.

Export Ontology

  1. Click on the Recipes from the lift-side menu.

  2. Locate or search for the desired recipe in the list.

  3. Click on the ⋮ Three Dots and select Export Ontology from the list. A JSON file will be downloaded.

Clone Recipes

  1. Click on the Recipes from the lift-side menu.

  2. Locate or search for the desired recipe in the list.

  3. Click on the ⋮ Three Dots and select Clone Recipe from the list.

  4. Click Clone Recipe. The cloned recipe will be created and listed. A [Clone] prefix will be added to the cloned recipe’s name.

Copy Recipe ID

  1. Click on the Recipes from the lift-side menu.

  2. Locate or search for the desired recipe in the list.

  3. Click on the ⋮ Three Dots and select Copy Recipe ID from the list. The recipe ID will be copied.

Delete a Recipe

  1. Click on the Recipes from the lift-side menu.

  2. Locate or search for the desired recipe in the list.

  3. Click on the ⋮ Three Dots and select Delete Recipe from the list.

  4. Click Delete to confirm. Deleting a recipe from a dataset will also remove it from any other datasets where it has been set as the active recipe.

Switch a Recipe in the Dataset

To change the recipe linked from one dataset to another:

  1. Click on the Data from the lift-side menu.

  2. Locate or search for the desired dataset in the list.

  3. Click on the 3-dots action button of a dataset entry (from either the project overview or the Datasets page).

  4. Select Switch Recipe.

  5. Select a different recipe from the list and approve.


Updating the Ontology with a Label Thumbnail Using the SDK

The following code snippets demonstrate how to add a new label with a thumbnail and how to update an existing label to include thumbnail display data using the Dataloop SDK.

Adding a Label with a Thumbnail

import dtlpy as dl
dataset = dl.datasets.get(dataset_id="65f82c9fc26fd1bc97ea9915")
ontology = dataset.ontologies.list()[0]
ontology.add_label(label_name='dog', color=(34, 6, 231), icon_path=r"C:\Datasets\Dogs\dog.webp")

Updating an Existing Label with a Thumbnail

import dtlpy as dl
dataset = dl.datasets.get(dataset_id="65f82c9fc26fd1bc97ea9915")
ontology = dataset.ontologies.list()[0]
# Add label if not already existing
ontology.add_label(label_name='dog', color=(34, 6, 231), icon_path=r"C:\Datasets\Dogs\dog.webp")
# Create a label object with display data
label = dl.Label(tag='dog',
                 display_label='dog',
                 display_data={'displayImage': {'itemId': '65fa86e310864a269c607064',
                                                'datasetId': "65f82c9fc26fd1bc97ea9915"}})
# Update the label in the ontology
ontology.update_labels(label_list=[label], update_ontology=True)

Import Ontology

To import an ontology as a JSON file:

  1. Open the respective recipe.

  2. From the bottom right side, select the import ontology.

Import Labels

To import labels/attributes from the platforms' interface:

  1. Imported labels should be in a TXT file, following these guidelines:

    1. Every label in a new line.

    2. Labels hierarchy is by separating them with ".". For example, "Car.Type.SUV".

  2. Open the respective recipe.

  3. From the Labels and Attributes tab, select the import option for labels.

  4. Select a TXT file.