---
title: "Element <document-fragment>"
source: https://dev.pageseeder.com/api/elements/element_document-fragment.html
description: "API Element reference for <document-fragment>"
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~409
---

# \<document-fragment\>

## Summary

This is the container element for a PSML document’s fragment and its metadata.

## Usage context

| Permitted content | [\<locator\>](../../psml/elements/element-locator.md), [\<fragment\>](../../psml/elements/element-fragment.md), [\<media-fragment\>](../../psml/elements/element-media-fragment.md), [\<properties-fragment\>](../../psml/elements/element-properties-fragment.md), [\<xref-fragment\>](../../psml/elements/element-xref-fragment.md) |
| --- | --- |
| Permitted parent |  |

## Attributes

No attributes.

## Examples

```lang-xml

<document-fragment>
  <locator id="325" fragment="4"/>
  <fragment id="4">
    <para>This is the fragment content</para>
  </fragment>
</document-fragment>
```

## Schema

### XML Schema

```lang-relax

<xs:element name="document-fragment">
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="locator"/>
      <xs:choice>
        <xs:choice minOccurs="0" maxOccurs="1">
          <xs:element ref="fragment"            minOccurs="0" />
          <xs:element ref="media-fragment"      minOccurs="0" />
          <xs:element ref="xref-fragment"       minOccurs="0" />
          <xs:element ref="properties-fragment" minOccurs="0" />
        </xs:choice>
      </xs:choice>
    </xs:sequence>
    <xs:attribute name="draft" type="xs:boolean" fixed="true" />
   </xs:complexType>
</xs:element>
```

### Relax Schema

```lang-relax

element document-fragment {
  attribute draft      { xs:boolean }?,
  element locator,
  (fragment | media-fragment| xref-fragment | properties-fragment)?
}
```

## Compatibility

No change since initial API release.