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

# \<properties-fragment\>

## Summary

The `<properties-fragment>` element is a [fragment](../../reference/glossary/fragment.md) which only contains `<property>` elements.

Other kind of fragment elements are as follows:

- `<fragment>`
- `<media-fragment>`
- `<xref-fragment>`

See [How to create a properties fragment](../../get_started/tutorials/how_to_create_a_properties_fragment.md) tutorial.

## Usage context

| Element category | structure |
| --- | --- |
| PSML level | portable |
| Permitted content | `<property>` |
| Permitted parent | `<section>` |
| HTML equivalent | no equivalent |
| OpenXML equivalent |  |

## Attributes

This element includes the following attributes:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| id | [fragment-id](../datatypes/pageseeder_datatypes.md) | yes | The fragment ID |
| type | [fragment-type](../datatypes/pageseeder_datatypes.md) | no | The template type |
| labels | [label-list](../datatypes/pageseeder_datatypes.md) | no | A list of fragment label values |

### `@id`

The fragment ID, which must be unique within the document.

### `@type`

The type of properties fragment, which might reflect the type of template.

## Examples

An example:

```lang-xml

<properties-fragment id="3">
  <property name="part-id" value="FY765A"/>
  <property name="part-category" value="Industrial"/>
</properties-fragment>
```

A more comprehensive example:

```lang-xml

<properties-fragment id="4" >
  <property name="title"
            title="Title"
            value="Alice's Adventures in Wonderland"/>
 
<property  name="isbn" title="ISBN" value="0000000000001"/>
  <property  name="author" title="Author" value="Lewis Caroll"/>
  <property name="language" title="Language">
    <value>English</value>
    <value>Spanish</value>
  </property>
  <property name="country" title="Country" value="Australia"/>
  <property name="available-date"
            datatype="date"
            title="Available date"
            value="2012-01-01"/>

  <property name="related"
            count="n"
            datatype="xref"
            title="Related">
    <xref href="book4.psml" frag="default"/>
    <xref href="book7.psml" frag="default"/>
  </property>
</properties-fragment>
```

## Schema

### XML Schema

```lang-xml

<xs:element name="properties-fragment">
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="property"
                  minOccurs="0"
                  maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="id" type="fragment-id" use="required"/>
    <xs:attribute name="type" type="fragment-type"/>
    <xs:attribute name="labels" type="label-list"/>
  </xs:complexType>
</xs:element>
```

### Relax Schema

```lang-relax

element properties-fragment {
   attribute id { fragment-id },
   attribute type { fragment-type }?,
   attribute labels { label-list }?, 
   element property*
}
```

## Compatibility

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