# Tags editor

Ultarstar stores metadata about the song (e.g. artist, title, tempo) in the form of tags. Different versions of the game may understand different sets of tags. The common ones are described in the [tags ](https://karedi.gitbook.io/karedi/next-level/txt-file-format/tags)section.

Day to day users do not really need to concern themselves with tags when working with Karedi. The application lets you change the standard metadata values from the menu hiding the technical details of the txt format.

## Editing tags values

To learn how to edit song metadata in a convenient way from the menu, please go to [this page](https://karedi.gitbook.io/karedi/next-level/editing-tags).

## Displaying tags values

If you are a more advanced user who likes to work on tags directly you can see the current list of tags with values in Tags editor.

Tag editor is located above the [*main editor*](https://karedi.gitbook.io/karedi/user-interface/middle-components/main-editor), on the right side. By default [*lyrics editor*](https://karedi.gitbook.io/karedi/user-interface/upper-components/lyrics-editor) tab is selected. To manage tags you need to switch to the second tab by clicking on the *Tags* tab caption.

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2F8Um8S0fddzS0N0WBDdmO%2Fimage.png?alt=media&#x26;token=dc09928d-3df6-4bf5-8f9a-a303f746901c" alt=""><figcaption></figcaption></figure>

Here you can see the full list of currently defined tags:

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FTg1UCFNjpkYvJ27svaPx%2Fimage.png?alt=media&#x26;token=632e48ac-590e-472a-97ba-eed83ee1704a" alt=""><figcaption></figcaption></figure>

## Adding a new tag

You can add any tag that is not already present in 2 ways:

1. Go to menu *Tags* -> *Add New\...*
2. Right click somewhere in the tag editor and choose *Add* option from the context menu

![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FgCgVybOKYVJ5qKZl7RuU%2Fimage.png?alt=media\&token=849ceae4-53b5-4856-a4b4-9339758d4808)

Either way you will see a popup in which you can add any tag you want.

<div align="left"><figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FAk9krs7udePNJb0tqaAj%2Fimage.png?alt=media&#x26;token=56d646a5-9d0a-4975-83d0-78cd47074a31" alt="" width="340"><figcaption></figcaption></figure></div>

If given tag already exists, its value will be simply updated.

Standard tags will be suggested and validated so for example if you choose START tag, which must be a number, you won't be able to input letters as a value.

{% hint style="info" %}
The set of suggested tag keys will depend on the song's [UltraStar format version](https://karedi.gitbook.io/karedi/next-level/txt-file-format/format-version) defined by VERSION tag.
{% endhint %}

<div align="left"><figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2F10jqBbtmrmAhhm7io9Ij%2Fimage.png?alt=media&#x26;token=ec7a4fc0-0bfe-4d75-a36e-a1fe3b381e40" alt="" width="375"><figcaption></figcaption></figure></div>

Some tags like e.g. LANGUAGE have value suggestions:

<div align="left"><figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FzikvDQlwTar7ZLg2feKK%2Fimage.png?alt=media&#x26;token=97f9ec69-e846-412f-88ca-9491157e7b36" alt="" width="375"><figcaption></figcaption></figure></div>

Since [UltraStar format version](https://karedi.gitbook.io/karedi/next-level/txt-file-format/format-version) 1.1.0 some tags support multiple values:

<div align="left"><figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FNWmjKFTkLlMbmZ0miXig%2Fimage.png?alt=media&#x26;token=af07ec0f-4b97-4351-859a-88d8eb46eebd" alt="" width="375"><figcaption></figcaption></figure></div>

## Editing tag value

{% hint style="info" %}
Standard tags are validated also on edit
{% endhint %}

To edit a tag double click on its value.

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FZ0vcBol0CcqG1GVWPTAA%2Fimage.png?alt=media&#x26;token=d1abe4b9-9ae6-4973-93f9-4bfc2b9512fd" alt=""><figcaption></figcaption></figure>

and confirm your change by pressing enter key.

### Editing numeric tag value using mouse scroll

For tags that accept numeric values you can use mouse scroll to adjust the value. To do so:

* select the tag you want to edit
* hover mouse over the value:\
  ![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FtV4ASRcdkz7TVlVgmKoi%2Fimage.png?alt=media\&token=54f29697-1ffe-46fa-8d7d-f4edba2e9170)
* use mouse scroll to adjust
  * *ctrl* modifier will speed up the change by 10
  * *shift* modifier will speed up the change by 100
  * *ctrl + shift* modifiers will speed up the change by 1000

Edit via scroll is active even if the tag editor is not focused:

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FCHqU9XZsqNPvfPsn3x88%2Fimage.png?alt=media&#x26;token=0de8709d-960f-4302-8ff1-24129dab5134" alt=""><figcaption></figcaption></figure>

## Removing a tag

To remove a tag:

1. Select it in tags editor and press delete key on your keyboard, or
2. Right-click on the tag in tags editor and choose *Delete* option from the context menu.
