# Labels

With physical memory cards and drives, you'd affix labels to media to stay organized during a shoot. Likewise, OffShoot lets you apply labels to sources, which you can use to build and extend your workflow.

### Adding a Label

To add a label to a Disk, click its name, type your label, and hit `Return`. Doing this will set that Disk as a Source. You can also click the hamburger menu and select `Add Label...`&#x20;

Your new label will appear in blue.&#x20;

![A Label has been set](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MZJw8kmKA5aGGgQViPT%2F-MZJyiklt1lKzS4g7AOu%2FScreenshot%202021-04-27%20at%2022.17.36.png?alt=media\&token=0bf220fd-c585-418c-b246-dac27e7e5287)

To add a label without making that Disk a Source, add the label, then click no some space somewhere outside the Disk. To cancel label creation, press `Escape`.

{% hint style="info" %}
Labels do not rename a Source's actual Volume Name.
{% endhint %}

To remove a label, click the blue label, press `Delete` or `Backspace`, and hit `Enter`. The Source will now revert back to its volume name. You can also click the hamburger menu and select `Clear Label`.

### Labels and your workflow

With your first transfer, you'll notice OffShoot used your label to name the parent folder on the Destination. You can also customize labels to create subfolders and add date-based information to a transfer.

| Element        | Description                                                                                                                               | Example    |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| `{YYYY}, {YY}` | Year                                                                                                                                      | `2021, 21` |
| `{MM}`         | Month                                                                                                                                     | `03`       |
| `{DD}`         | Day                                                                                                                                       | `23`       |
| `{hh}`         | Hour, in 24-hour format                                                                                                                   | `14`       |
| `{mm}`         | Minutes                                                                                                                                   | `01`       |
| `{ss}`         | Seconds                                                                                                                                   | `56`       |
| `/`            | When a Label contains a slash, it creates subfolders on the Destination. Useful when you want to have a subfolder for each camera or day. | `A/10w`    |

## Auto Labels

Auto Label allows you to automatically label a source with a specified format, whether sources are added manually or automatically through the Auto Source setting.

Whereas labels you set manually appear in blue, Auto Labels are shown within a white outline:

![Two sources with Auto Labels applied.](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MYtpEJhYX6jILHKPPB2%2F-MYu4WjAt_-4kd-fLo_f%2Fautolabel.png?alt=media\&token=a5a458d8-ddd5-4e24-9e00-adde31f9361a)

If an Auto Label format is part of [the active Preset](https://docs.hedge.video/offshoot/organization#presets), all new Sources will be labeled accordingly. <br>

<figure><img src="https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LStRji2w1AYja1bLBFv%2Fuploads%2FzRdWoyCGSYvh9UEMRaGc%2Fimage.png?alt=media&#x26;token=21415426-98bf-4269-b8c4-7eb4edb21824" alt=""><figcaption></figcaption></figure>

![Auto Label elements](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MYtVutM-GoeqnOYdbJD%2F-MYtbJiRjdv1IK1eYLBi%2F21-1%20-%20Preferences%20-%20Organize%20-%20Auto%20Label.png?alt=media\&token=c48c329b-db61-4392-800e-c731fa0b95e6)

| Element         | Description                                                                                                                                                                                                                                                       | Example    |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| `{Source Name}` | Volume Name                                                                                                                                                                                                                                                       | `UNTITLED` |
| `{Counter}`     | The Source Counter. Automatically increased with a value of 1. Set the initial value of the Counter in the `Organize` preference pane, including additional leading zeros if required.                                                                            | `002`      |
| `{YYYY}, {YY}`  | Year                                                                                                                                                                                                                                                              | `2021, 21` |
| `{MM}`          | Month                                                                                                                                                                                                                                                             | `03`       |
| `{DD}`          | Day                                                                                                                                                                                                                                                               | `23`       |
| `{hh}`          | Hour, in 24-hour format                                                                                                                                                                                                                                           | `14`       |
| `{mm}`          | Minutes                                                                                                                                                                                                                                                           | `01`       |
| `{ss}`          | Seconds                                                                                                                                                                                                                                                           | `56`       |
| `/`             | When a label contains a slash, and the `{Source Name}` element is used in the folder format so that a label will be part of the folder structure, slashes create subfolders on the destination. Useful when you want to have a subfolder for each camera, or day. | `A/10`     |

### Auto Labels are auto-updating

Some label elements (e.g. `{Counter}`, respond dynamically when:

* Sources are added or removed
* You change the counter value in `Settings`
* Time passes (i.e. when using date-based label elements)
* *You manually override an applied Auto Label*

#### Date-based label elements changed

It's midnight, but it's not the end of the shoot day. Perhaps you're offloading footage from a shoot, but it wasn't shot today. If you're using date-based label elements, go to `Preferences > General > Date` to set which date Auto Label will use for Today. You can also specify what time tomorrow starts so you can stay organized during those late-night shoots.

![Preferences > General > Date](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MZFSp8_uXx-p_k6tbBS%2F-MZFpQdvPF8cCECGEQIm%2FPreferences%20-%20General%20-%20Date.png?alt=media\&token=e7564aca-5b47-4a5d-b9b0-ffb9b4b981ae)

#### Manually changing an applied Auto Label

This is very powerful, and important to understand correctly.

Let's say you're importing cards from camera `A`, and you use an Auto Label format `A{Counter}`. Adding three Sources, each gets an Auto Label: `A001` `A002` and `A003`. But card two is *actually* `A010`, so you alter the second source's Label to give it a manual Label.

What now happens is the Auto Label of the third source detects this change and alters its own label to be `A002`, as that is the next counter available now that `A010` has entered the mix:

![Auto Labels auto-update when a manual Label is set.](https://1060439511-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LStRji2w1AYja1bLBFv%2F-MYu9PD0IC2y0bUS0S5F%2F-MYus7Wutpmd6s3ybmjG%2Flabel.png?alt=media\&token=076d4339-bbca-403a-9844-d068788fbc7d)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hedge.video/offshoot/features/labels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
