Skip to main content

 Element reference

PSML elements from <author> to <xref>



Metadata of a fragment referenced by its locator.

Matching fragments

To match a locator to its fragment, use the @fragment attribute so that it is equal to the fragment ID being processed.

When processing a fragment, you can find the locator using the following XPath:

//locator[@fragment = $fragment/@id]

There is at most 1 match.

Usage context

Element categorymetadata
PSML levelmetadata
Permitted content<notes> <reversexrefs> <compare> [<labels> DEPRECATED]
Permitted parent<fragmentinfo>
HTML equivalent no equivalent
OpenXML equivalent no equivalent

The <labels> element is DEPRECATED here. Use the @labels attribute on the fragment instead.


This element includes the following attributes

editidxs:longnoThe XLink ID for the latest edit
fragmentfragment-idnoThe fragment ID
idxs:longnoThe Locator ID
modifiedxs:dateTimenoThe last edit date

This element contains informational attributes. 


The ID of the latest edit. An XLink ID is unique within a PageSeeder instance. INFORMATIONAL - ignored by upload.

This attribute value is specific to a PageSeeder server as it refers to the XLink representing the last edit.


The ID of the fragment. It is unique within the document.

Use this attribute to identify the fragment content associated to this locator. 


The ID of this locator in PageSeeder. INFORMATIONAL - ignored by upload.

This value is specific to a PageSeeder instance.


The date this fragment was last modified. It corresponds to the date of the last modified XLink. INFORMATIONAL - ignored by upload.


A locator with system specific identifiers and last modified date of a fragment:

<locator id="113"


XML Schema

<xs:element name="locator">

      <xs:element ref="labels" minOccurs="0"/>
      <xs:element ref="notes" minOccurs="0"/>
      <xs:element ref="reversexrefs" minOccurs="0"/>
      <xs:element ref="compare" minOccurs="0"/>

    <xs:attribute name="id" type="xs:long"/>
    <xs:attribute name="fragment" type="xs:string"/>
    <xs:attribute name="modified"
    <xs:attribute name="editid" type="xs:long" use="optional"/>

Relax Schema

element locator {
   attribute id { xs:long },
   attribute fragment { text },
   attribute modified { xs:dateTime },
   attribute editid { xs:long }?,
   element labels?,
   element notes?,
   element reversexrefs?,
   element compare?


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

Created on , last edited on