---
title: "PSML XRefs editor"
source: https://dev.pageseeder.com/guide/configuration/psml/psml_xrefs_editor.html
description: "The PSML XRefs editor is a specialized tool for creating cross-reference lists through the `<xref-fragment>` element. It can be customized using `<editor-config>` with `<xref-config>` elements that specify fragment types and xref configuration options."
last_updated: 2026-08-11T16:20:22+10:00
tokens: ~426
---

# PSML XRefs editor

This editor is specialized for the `<xref-fragment>` so that users can quickly create lists of [cross-references](../../../reference/glossary/cross_reference.md) to documents.

It can be customized using the `<editor-config name="PSMLXRefs">` element.

```xml

<editor-config name="PSMLXRefs">
  <xref-config fragmenttype="[fragment type or default]"
               [name=""]>
    <!-- xref config options -->
  </xref-config>
  ...
</editor-config>
```

The `<xref-config>` element has the same content as for the [Xref config](psml_xref_config.md) except that `@name` is optional and `@fragmenttype` is required if there are multiple `<xref-config>` elements.

If `@name` is specified, then the configuration from the PSML XRef config for the project (`xref-config.xml`) with the same name is used and this `<xref-config>` element should be empty.

If `@fragmenttype` is not `default`, then the config only applies to `<xref-fragment>` elements with that value in the `@type` attribute. The `@fragmenttype` is only used by the XRefs editor.

Example:

```xml

<editor-config name="PSMLXRefs">
  <xref-config fragmenttype="default">
    <xref type="transclude"/>
    <autosuggest questionfields="pstitle,pslabel,pscontent"
                 displayfields="psdocid,pslabel,psdescription,pscontent"/>
  </xref-config>
  <xref-config fragmenttype="special">
    <xref type="embed"/>
    <target documenttype="tutorial" />
    <autosuggest questionfields="pstitle,pslabel,pscontent"
                 displayfields="pslabel,psfolder,psfilename"
                 folder="books/*/tutorials" />
  </xref-config>
  <xref-config fragmenttype="suggested" name="related" />
</editor-config>
```