# Batches

Batches are a way to organize assets in categories.

Each asset can have multiple batches attached to them. Batches are optional to use, and by default, imported assets have no batch.

You can attach batches to assets to quickly find them later, to assign them all to a certain labeler, to filter performance reports by batch, and much more.

## How To Assign Batches to Assets on Import

### In bulk (the same batch for all assets being imported)

When [importing assets](https://docs.imerit.net/data/importing-assets) to Hub, be it [from your local machine](https://docs.imerit.net/data/importing-assets/asset-browser-import) or from [public](https://docs.imerit.net/data/importing-assets/asset-cloud-import)/[private cloud assets](https://docs.imerit.net/data/storages/importing-private-cloud-assets-gcp), you may attach a batch directly during import.

To do so, after clicking on *Add Data* in the *Assets* tab, click on the *Batch Name* dropdown and add the batches you wish to attach.

If you have existing batches, they will show up here. You may also create new batches from this menu.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FoNl83dzTaofJ01DmfbV9%2Fimage.png?alt=media&#x26;token=e3e0f641-0b7b-446a-89e8-0e4dc5762f04" alt=""><figcaption></figcaption></figure>

### Individually (pick which batch each asset will be assigned to)

When importing assets via the Cloud Import method, with either [public](https://docs.imerit.net/data/importing-assets/asset-cloud-import) or [private](https://docs.imerit.net/data/storages/importing-private-cloud-assets-aws) assets, you may indicate in the JSON you upload the batch(es) you'd like each asset to be assigned to. Please refer to the section *Preparing the JSON* in the docs page on&#x20;

{% hint style="info" %}
You may also assign batches during upload when using our SDK. See [upload\_files\_cloud](https://docs.imerit.net/sdk/sdk-documentation#upload_files_cloud-project_id-assets-integration_id-batches) for more information.
{% endhint %}

### How to Assign Batches After Import

From the *Assets* tab, toggle the checkmark next to the assets you wish to batch together (highlighted in green on the screenshot below). It may help to use the filters at the top of the list to narrow down your search.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FymCZseqOIiB8Qgrv4AFO%2Fimage.png?alt=media&#x26;token=d5bf6109-49d9-42f8-b23c-8b51cc3f4365" alt=""><figcaption></figcaption></figure>

You may click on the checkmark highlighted in red on the screenshot above to select all tasks in the current page.

{% hint style="warning" %}
Navigating to a different page of assets *will deselect* the checkmarks you have toggled earlier. Your checkboxes are not kept in memory when navigating between asset pages.

The maximum number of assets you may batch this way at any one time is 1000. This is accomplished by selecting *1000/page* from the bottom right corner of the page, then clicking on the *Select All* checkmark highlighted in red on the screenshot above.
{% endhint %}

From the *Item Actions* dropdown, click on *Set Batches*.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FER2meg424PCVyT1u5uzI%2Fimage.png?alt=media&#x26;token=6b36f376-852c-45c0-802e-9b2a53dfab53" alt=""><figcaption></figcaption></figure>

From the dialog that appears, you will be able to select the batches to add to the selected assets from a list of existing project batches.

{% hint style="info" %}
You may also assign batches after upload when using our SDK. See [assign\_batches](https://docs.imerit.net/sdk/sdk-documentation#assign_batches-project_id-asset_ids-batches) for more information.
{% endhint %}

### Creating and Editing Batches

To create and edit existing batches, navigate to the *Settings* tab and then to the *Batches* section.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2F2PTvvGxnP8KkHkEKdrWx%2Fimage.png?alt=media&#x26;token=9ad3c64d-8b98-41c4-8b28-bf9fbac64310" alt=""><figcaption></figcaption></figure>

* To add a new batch, click on *Add new batch*.
* To rename an existing batch, click on the <img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fxn7dm5AB5i7QoRy87JW5%2Fimage.png?alt=media&#x26;token=ec55656e-c41a-4e58-8c23-4beb4f56d2c7" alt="" data-size="line">icon next to the name of the batch you wish to rename.
* To delete a batch, click on *Delete* on the row of the batch to delete.

{% hint style="info" %}
Don't forget to click on *Save* or your changes will be lost when navigating away from the page.
{% endhint %}

{% hint style="info" %}
You may also create batches after upload by using our SDK. See [create\_batch](https://docs.imerit.net/sdk/sdk-documentation#create_batch-project_id-batch_name) for more information.
{% endhint %}
