---
title: "<editing>"
source: https://dev.pageseeder.com/guide/configuration/psml/psml_document_config/document_editing.html
description: "How to use the <editing> element in the PSML document-config.xml file to configure custom PSML editors"
last_updated: 2026-08-11T16:01:49+10:00
tokens: ~537
---

# PSML document editing

This article describes how to use the `<editing>` element in the PSML `document-config.xml` file to configure custom PSML editors.

The element has the following structure:

```xml

<editing [override="true"]>
  <editor ... />*
</editing>
```

For further information on how to configure the editing environment, *see* [document template](../psml_document_template.md).

## Behavior

By default, the editing configuration extends the default configuration so that editors defined here are added to the base editors. To override the editing configuration, use the `@override` boolean attribute.

If the `<editing>` element is not specified or the `document-config.xml` doesn’t exist, then the editors are automatically inherited from the default configuration.

## Details

 Each `<editor>` element can define the following:

| Attribute | Description |
| --- | --- |
| `fragmenttype` | To bind a specific [fragment type](../psml_document_template.md) to a different editor |

*The attributes `name`, `mediatype` and `format` are obsolete as of PageSeeder v6.*

The following parameters can be sent to the editing software using the `<options>` element under `<editor>.`

| Attribute | Description |
| --- | --- |
| `editnote` | With the following allowable values: `optional` – user is not prompted to enter an edit note (default).`prompt` – user is prompted to enter an edit note but can save without typing or selecting an edit label.`required` – user is prompted to enter an edit note and must type something or select an edit label before saving. |

*The attributes `html` and `tidy` are obsolete as of PageSeeder v6.*

> **Note:** In PageSeeder v6 you can remove `<editor>` elements unless they have options above that are not obsolete.

## Default

This is the default editor configuration:

```xml

<editing>
</editing>
```

## Examples

Prompt for an edit note every time a fragment is edited and require one for fragments with type `details`.

```xml

<editing>
  <editor>
    <options editnote="prompt"/>
  </editor>
  <editor fragmenttype="details">
    <options editnote="required"/>
  </editor>
</editing>
```