A complete reference of PageSeeder's markup language PSML



Metadata of a fragment referenced by it 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 will be 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
PSStandard equivalent <fragment> under <fragmentinfo>


The <labels> element is DEPRECTAED 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.


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

<locator id="113" editid="548" 
   fragment="4" modified="2015-05-21T12:35:21+10:00"/>


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" type="xs:dateTime" use="optional"/>
      <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.

PS Standard XML

Fragment metadata used to be scattered throughout the document in PS Standard XML but is now consolidated under the <fragmentinfo> info containing the underlying locator for each fragment.

See also

Created on , last edited on