> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit & Delete Labels

## Edit Labels

Editing labels after they have been created involves the following steps:

1. Find the label instance you want to edit.
2. Edit the value for the label.
3. Save the changes.

The script below shows how to update the location of an object's bounding box, and attribute values. Ensure you substitute the following values:

* `<private_key_path>` with the full path to your private key.
* `<project_hash>` with the name of the project you want to update labels in.
* `<file_name>` with the name of the file / data unit you want to edit labels for.
* `<object_name>` with the name of the object.
* `<attribute_name>` with the name of the attribute.
* `<option_name>` with the name of the radio button option of the attribute.

```python theme={"dark"}
# Import dependencies
from typing import List

from encord import EncordUserClient
from encord.objects import LabelRowV2, Object, ObjectInstance, OntologyStructure
from encord.objects.coordinates import BoundingBoxCoordinates

# Instantiate Encord client by replacing <private_key_path> with the path to your private key
user_client = EncordUserClient.create_with_ssh_private_key(
    ssh_private_key_path="<private_key_path>"
)

# Specify the project. Replace <project_hash> with the hash of your Project
project = user_client.get_project("<project_hash>")

# Specify the label row you want to edit labels for. This example takes the first label row
# Replace the <file_name.mp4> with the name of the file you want to change labels for
first_label_row = project.list_label_rows_v2(
    data_title_eq="<file_name>"
)[0]

# Download the existing labels 
first_label_row.initialise_labels()

# Get the first object instance in the label row
ontology_structure = first_label_row.ontology_structure

# Gets the object instance we want to edit the label for. This example uses the first
first_obj_instance = first_label_row.get_object_instances()[0]

# Specifies which Ontology object to change labels for
# Replace <object_name> with the name of your object. For example 'Flower'
my_object = ontology_structure.get_child_by_title(title="<object_name>")

# Sets coordinates for the specified object instance
# This example changes the location of a bounding box
first_obj_instance.set_for_frames(
    coordinates = BoundingBoxCoordinates(
        height=0.1474,
        width =0.1154,
        top_left_x=0.1097,
        top_left_y=0.3209
    ),
    # Overwrites if annotations are already present
    manual_annotation=False, overwrite=True
)

# Selects a Radio button attribute
# Replace <attribute_name> with the name of the attribute you want to edit. For example 'Flower species'
my_attribute = my_object.get_child_by_title(title="<attribute_name>", type_=RadioAttribute)

# Selects the radio button option of the attribute
# Replace <option_name> with the name of the option. For example 'Sunflower' 
attribute_option = my_attribute.get_child_by_title(title="<option_name>", type_= Option)

# Sets the attribute to the attribute_option defined above
first_object_instance.set_answer(attribute_option, overwrite=True)

# Once you have updated labels and attributes, save your changes
first_label_row.save()
```

***

## Delete Labels/Classifications

The following code deletes specific labels/classifications from data units.

<CodeGroup>
  ```python Labels theme={"dark"}

  from encord import EncordUserClient

  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"
  DATA_UNIT_NAME = "cherry-002.jpg"

  # Instantiate client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
  )

  # Specify Project
  project = user_client.get_project(PROJECT_ID)

  # Specify the data unit you want to modify labels for
  specific_label_row = project.list_label_rows_v2(
      data_title_eq=DATA_UNIT_NAME
  )[0]

  # Find the object to remove
  object_to_remove = None
  specific_label_row.initialise_labels()
  for object_instance in specific_label_row.get_object_instances():
      # Specify the label ID for the label to remove
      if object_instance.object_hash == '0pw0bHXR':
          object_to_remove = object_instance

  # Remove the object
  specific_label_row.remove_object(object_to_remove)

  # Save the changes
  specific_label_row.save()

  ```

  ```python Classifications theme={"dark"}

  from encord import EncordUserClient

  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"
  DATA_UNIT_NAME = "cherry-002.jpg"

  # Instantiate client
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
  )

  # Specify Project
  project = user_client.get_project(PROJECT_ID)

  # Specify the data unit you want to modify labels for
  specific_label_row = project.list_label_rows_v2(
      data_title_eq=DATA_UNIT_NAME
  )[0]

  # Find the classification to remove
  classification_to_remove = None
  specific_label_row.initialise_labels()
  for classification_instance in specific_label_row.get_classification_instances():
      # Specify the classification ID for the classification to remove
      if classification_instance.classification_hash == '0pw0bHXR':
          classification_to_remove = classification_instance

  # Remove the object
  specific_label_row.remove_classification(classification_to_remove)

  # Save the changes
  specific_label_row.save()

  ```
</CodeGroup>

## Delete All Labels/Classifications

The following code deletes all labels/classifications from the specified data unit.

<CodeGroup>
  ```python Labels theme={"dark"}

  from encord import EncordUserClient

  # Authentication
  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"

  # Authenticate
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
      )

  # Get Project
  project = Project = user_client.get_project(PROJECT_ID)

  # Get label rows
  label_rows = project.list_label_rows_v2()
  BUNDLE_SIZE = 100

  # Initialize label rows using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.initialise_labels(bundle=bundle)

  # Delete all objects from specific images
  for label_row in label_rows:
      # Check if this is an image you want to modify
      if label_row.data_title in ["cherry-002.jpg"]:  # Replace with your image names
          # Get all object instances
          objects_to_remove = label_row.get_object_instances()
          # Remove all objects
          for obj in objects_to_remove:
              label_row.remove_object(obj)

  # Save changes using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.save(bundle=bundle)

  ```

  ```python Classifications theme={"dark"}

  from encord import EncordUserClient

  # Authentication
  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"

  # Authenticate
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
      )

  # Get Project
  project = Project = user_client.get_project(PROJECT_ID)

  # Get label rows
  label_rows = project.list_label_rows_v2()
  BUNDLE_SIZE = 100

  # Initialize label rows using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.initialise_labels(bundle=bundle)

  # Delete all objects from specific images
  for label_row in label_rows:
      # Check if this is an image you want to modify
      if label_row.data_title in ["cherry-002.jpg"]:  # Replace with your image names
          # Get all object instances
          classifications_to_remove = label_row.get_classification_instances()
          # Remove all objects
          for clas in classifications_to_remove:
              label_row.remove_classification(clas)

  # Save changes using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.save(bundle=bundle)

  ```
</CodeGroup>

## Delete All Specific Labels/Classifications

The following code removes all labels/classifications of a specific type from data units.

<CodeGroup>
  ```python Labels theme={"dark"}

  from encord import EncordUserClient
  from encord.objects import Object

  # Authentication
  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"
  TARGET_CLASS_NAME = "Keypoint"
  DATA_UNIT_NAME = "cherry-002.jpg"

  # Authenticate
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
  )

  # Get the project
  project = user_client.get_project(PROJECT_ID)

  # Get all label rows in the project
  label_rows = project.list_label_rows_v2()

  BUNDLE_SIZE = 100

  # Initialize label rows using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.initialise_labels(bundle=bundle)

  # Retrieve the ontology object matching the target class name
  ontology_object = project.ontology_structure.get_child_by_title(
      title=TARGET_CLASS_NAME,
      type_=Object
  )

  # Loop through the label rows and delete only the object instances matching the ontology object
  for label_row in label_rows:
      if label_row.data_title == DATA_UNIT_NAME:
          
          # This returns only the instances of the specific ontology object
          objects_to_remove = label_row.get_object_instances(
              filter_ontology_object=ontology_object
          )

          print(f"Found {len(objects_to_remove)} '{TARGET_CLASS_NAME}' objects in '{DATA_UNIT_NAME}'")

          # Remove those objects
          for obj in objects_to_remove:
              label_row.remove_object(obj)

  # Save changes using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.save(bundle=bundle)

  print(f"Finished! Removed all '{TARGET_CLASS_NAME}' objects from '{DATA_UNIT_NAME}'.")


  ```

  ```python Classifications theme={"dark"}

  from encord import EncordUserClient
  from encord.objects import Classification

  # Authentication
  SSH_PATH = "/Users/chris-encord/ssh-private-key.txt"
  PROJECT_ID = "41397c50-d4d5-4c73-bf5d-cb2f72c0dc31"
  TARGET_CLASS_NAME = "Classification 2"
  DATA_UNIT_NAME = "cherry-002.jpg"

  # Authenticate
  user_client = EncordUserClient.create_with_ssh_private_key(
      ssh_private_key_path=SSH_PATH,
      # If you use the US Encord platform, change domain to https://api.us.encord.com
      domain="https://api.encord.com",
  )

  # Get the project
  project = user_client.get_project(PROJECT_ID)

  # Get all label rows in the project
  label_rows = project.list_label_rows_v2()

  BUNDLE_SIZE = 100

  # Initialize label rows using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.initialise_labels(bundle=bundle)

  # Retrieve the ontology object matching the target class name
  ontology_classification = project.ontology_structure.get_child_by_title(
      title=TARGET_CLASS_NAME,
      type_=Classification
  )

  # Loop through the label rows and delete only the classification instances matching the ontology classification
  for label_row in label_rows:
      if label_row.data_title == DATA_UNIT_NAME:
          # This returns only the instances of the specific ontology object
          classifications_to_remove = label_row.get_classification_instances(
              filter_ontology_classification=ontology_classification
          )

          print(f"Found {len(classifications_to_remove)} '{TARGET_CLASS_NAME}' classifications in '{DATA_UNIT_NAME}'")

          # Remove those classifications
          for clas in classifications_to_remove:
              label_row.remove_classification(clas)

  # Save changes using bundles
  with project.create_bundle(bundle_size=BUNDLE_SIZE) as bundle:
      for label_row in label_rows:
          label_row.save(bundle=bundle)

  print(f"Finished! Removed all '{TARGET_CLASS_NAME}' classifications from '{DATA_UNIT_NAME}'.")

  ```
</CodeGroup>