---
title: "Element <labels>"
source: https://dev.pageseeder.com/psml/elements/element-labels.html
description: "PSML Element reference for <labels>"
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~321
---

# \<labels\>

## Summary

A comma-separated list of label values for a [document](../../reference/glossary/document.md), [note](../../reference/glossary/edit_note.md) or [fragment](../../reference/glossary/fragment.md).

The list of [labels](../../reference/glossary/labels.md) must not include any whitespace and must match the following regular expression:

```lang-regex
[a-zA-Z0-9_\-,]*
```

Empty label values are ignored, for example, if there are two successive commas.

## Usage context

| Element category | metadata |
| --- | --- |
| PSML level | metadata |
| Permitted content | [label-list](../datatypes/pageseeder_datatypes.md) |
| Permitted parent | `<locator> <compare> <compareto> <note>  <version> <uri>` |
| HTML equivalent | no equivalent |
| OpenXML equivalent | no equivalent |

## Attributes

This element does not have any attributes.

## Examples

The following note includes labels “important” and “spelling”:

```lang-xml

<note>
  <labels>important,spelling</labels>
</note>
```

## Schema

### XML Schema

```lang-xml

<xs:element name="labels" type="label-list"/>
```

### Relax Schema

```lang-relax

element labels { label-list }
```

## Compatibility

This element was introduced in the first draft of PSML and is well-supported from PageSeeder 5.1.