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

# \<section-ref\>

## Summary

A reference to a [\<section\>](element-section.md) element in the document structure. Only appears when comparing documents.

*INFORMATIONAL - ignored by upload.*

## Usage context

| Element category | metadata |
| --- | --- |
| PSML level | portable |
| Permitted content | `<title> <fragment-ref>` |
| Permitted parent | `<structure>` |
| HTML equivalent |  |
| OpenXML equivalent |  |

*The \<title\> element was permitted here in PSML v1.4 in PageSeeder 6.00.*

## Attributes

This element includes the following attributes

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| id | [section-id](../datatypes/pageseeder_datatypes.md) | yes | The section ID. |
| title | [xs:string](../datatypes/xml_schema_datatypes.md) | no | The title for the section |

#### `@id`

The section ID which must be unique within the document.

### `@title`

A [section title](../../reference/glossary/section_title.md) that isn’t considered to be part of the content.

*This attribute was introduced in PSML v1.4 in PageSeeder 6.00.*

## Examples

```lang-xml

<section-ref id="content">
  <fragment-ref id="5"/>
  <fragment-ref id="2"/>
</section-ref>
```

## Schema

#### XML Schema

```lang-xml
<xs:element name="section-ref">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="title" minOccurs="0" type="xs:string"/>
      <xs:element ref="fragment-ref"
                  minOccurs="0"
                  maxOccurs="unbounded" />
    </xs:sequence>
    <xs:attribute name="id" type="section-id" use="required" />
    <xs:attribute name="title" type="xs:string" use="optional"/>
  </xs:complexType>
</xs:element>
```

#### Relax schema

```lang-relax
element section-ref {
   attribute id { section-id },
   attribute title { text }?,
   element title { text }?,
   element fragment-ref*
}
```

## Compatibility

This element was introduced in PSML beta 10 and is supported from PageSeeder 5.9.