---
title: "Tutorial - Container Bulk Update Annotations Values"
slug: "tutorial-container-bulk-update-annotations-values"
updated: 2026-09-09T14:04:58Z
published: 2026-09-09T14:04:58Z
canonical: "docs.discngine.com/tutorial-container-bulk-update-annotations-values"
---

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

# Tutorial - Container Bulk Update Annotations Values

## Introduction

In this tutorial, you will apply annotation values for plates and vials in bulk.

## Prerequisite

This tutorial assumes you have a basic knowledge of the Sample application and its functionality. For additional information about Sample workflows in general, see the Discngine Sample User Guide, or use the page and item help in the application.

The annotations must be pre-configured by a Sample Administrator.

## Workflow

### Job Creation

[Create a new job](/public/docs/jobs-overview#create-a-job) and select the `Container - Bulk Update Annotation Values` workflow.

### Requesting

- Choose source type: **Plate** or **Vial**
- Choose Request From: File/Job/List/Text
- Enter the container IDs based on your previous choice
- Click `Add IDs`

![Requesting page for bulk annotation update](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/sample-requesting-bkann-page.png?sv=2026-02-06&spr=https&st=2026-11-11T03%3A54%3A13Z&se=2026-11-11T04%3A54%3A13Z&sr=c&sp=r&sig=s8HpNyD9hr1b1t5yyusLslr5dSAQt9p5ZXLSXceueeI%3D)

If there are any errors (e.g., loading plate IDs while you choose `Vial` as a type, or unknown barcode), they will be displayed as invalid on the right side. The invalid items will be ignored for the rest of the process. You can continue by clicking the `Next` button in the top right corner.

### Task Requesting

Here you enter the values for the annotations.

- Select the barcodes on which the annotations must be defined (choose "All Barcodes" to apply to all of them)
- Enter the value or choose the controlled vocabulary
- Click `Add Task` for each annotation
- The previous values (if any) are displayed next to the new values

![Task requesting page for bulk annotation update](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/sample-task-requesting-bkann-page.png?sv=2026-02-06&spr=https&st=2026-11-11T03%3A54%3A13Z&se=2026-11-11T04%3A54%3A13Z&sr=c&sp=r&sig=s8HpNyD9hr1b1t5yyusLslr5dSAQt9p5ZXLSXceueeI%3D)

#### Warnings and Errors

Warnings are only for information and do not block the update process.

- Warning "An annotation value already exists": the previous annotation value will be erased.

Errors will block the update of the annotation value.

- Error "Invalid number format": when the annotation is defined as a Number and the value is not numeric. The annotation update will be ignored.

### Process & Quit

To apply the annotation values to your containers, click `Process & Quit` in the top right.

## Validation

Search for the plates or vials you added annotations to in the **Search** page. Click on the container to view the details. The annotation values should be displayed at the bottom of the Details page:

![Plate detail page showing annotation values](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/sample-plate-detail-page.png?sv=2026-02-06&spr=https&st=2026-11-11T03%3A54%3A13Z&se=2026-11-11T04%3A54%3A13Z&sr=c&sp=r&sig=s8HpNyD9hr1b1t5yyusLslr5dSAQt9p5ZXLSXceueeI%3D)