Skip to main content


Configuration manual for PageSeeder

<publishing> element

This article describes how the <publishing> element can be modified to provide custom processing for different types of documents. The content on this element determines the options that are presented to users when the Publisher is invoked.

See also PSML Ant scripts.

<publishing> is valid in the following files:

  • document-config.xml – the <publishing> element is under the <document-config> element and controls processing for a specific document type.
    • To access this file, go to the Document types administration page, Config column, then select the row for the document type.
  • url-config.xml – the <publishing> element is under the <url-config> element and controls processing for a specific URL type.
    • To access this file,
      • Go to the Global template page, click Manage global types.
      • Or, go to the Document types administration page, click the Edit global types button at top right, under heading URL types then Config column, select the row for the URL type.
  • publish-config.xml– is the root element of the file and controls publishing across all groups, folders and documents or a batch of search results in a project.
    • To access this file, from the project, administration menu, select Template > Template files > publish folder, then select the edit option on the right of the config file.

The configuration follows the structure below:

  <action ... />*

When editing config files in PageSeeder, ctrl-space provides suggestions that are contextually correct at the insertion point. This ensures that the config file is valid.


The PageSeeder model allows the default functionality to be extended by adding the @override attribute to the <publishing> element.

<publishing override="true">
  <action ... />*

If the <publishing> element is not specified, or the config files doesn’t exist, options are inherited from the default files. To view the default document-config.xml and publish-config.xml, from the system administration menu, select Templates > Default files.

Element details


Each <action> defines:


One of the following actions (required)


or actions only valid in publish-config.xml


* The type upload-preview is deprecated as of PageSeeder v5.98 and only supported in the v5 UI. Use @previewname on <target> below instead.


In publish-config.xml, each <action> element must have a <source> element. The batch type requires PageSeeder v5.98 or higher and only works in the v6 UI. The <source> element can define:


The type of object (required)


extensionThe extension of the source file (required if type="document" )


Each <action> element must have one or more <target> elements that corresponds to each target in the Ant script. The <target> element defines:

nameMust match the target name in the Ant script (required)
previewnameThe target name in the Ant script for previewing the action (only supported in the v6 UI and only for upload actions)

Determines which perspective the target name is displayed in (to hide the target use none)


Values lab and standard have no effect in v6.

The minimal role required to run the process


configfileThe name of the config file in the same folder as the build.xml which can be edited by contributors (only word-export-config.xml, word-import-config.xml and pdf-export-config.xml are currently supported)
overrideIf true, this target overrides any target with the same name and action type (e.g. <target name="create-consolidated-docx" override="true"> overrides the default DocX export but leaves the other default exports available) - default false.

Each <target> element must have a <description> element to describe the process in the user interface. Each <target> element can have one or more <param> elements for the specified parameters.


Each <param> element can have the following attributes and can also contain an <autosuggest> element when @type="document" .

nameThe name of the parameter (required)
labelDisplayed next to the field (required)

One of the following values (default is text). See below for further detail.

text|select|checkbox| date|number|localdocumentversion| documentversion| documentlabel| documentstatus|fragmentlabel | localpublicationid | publicationid | document | folder

perspectiveWhich perspective the target name is to be displayed in.
placeholderGuidance text to display inside a field
patternA regular expression to constrain the value of a field
defaultThe default value of a field
minThe minimum value for a number field only
maxThe maximum value for a number field only
requiredWhether this parameter is required - true|false (default is false) requires PageSeeder v5.9807 or higher.
stepThe allowable value by which the minimum number can increment to the maximum number (default is 1).

Following are the available options when the value of @type is text:

  • text – displays an input box for text to be entered manually.
    • placeholder – can be used to display a hint in the box when no value has been specified.
    • pattern – can specify a regular expression that the value must match to be submitted. This can constrain the format or value of the field.

Where type="date", the pattern can override the date picker default (e.g. dd-mm-yyyy for 01-11-2017).

When the value of @type is select, the <param> element can have one or more <value> elements for the valid choices.

  • select – displays a drop-down list and allows only one value to be selected. The content of each <value> element is displayed as an option in the list.
  • checkbox – displays a checkbox which has possible values of true or false.
  • date – invokes a date picker interface and stores the value as ISO8601 (yyyy-mm-dd).
  • number – displays a number field which allows only valid numbers as defined by the @min, @max and @step attributes.

The following options provide additional flexibility for users to select content for processing:

  • documentversion – drop-down list of all document versions used in the current group.
  • localdocumentversion – drop-down list of document versions in the current document.
  • publicationid – drop-down list of all publication IDs in the current group.
  • localpublicationid – drop-down list of publication IDs for the current document.
  • documentlabel – drop-down list of document labels for the current group.
  • documentstatus – drop-down list of document status values for the current group.
  • fragmentlabel – drop-down list of fragment labels for the current group.
  • document or folder – allows selection of a document or folder through browse. Sends four parameters to the publish script by adding the following suffixes to the parameter name:, .uri.path,,, .uri.document.type (e.g. if the name was dest the params would be, dest.uri.path,,, dest.uri.document.type ). Requires PageSeeder v5.9802 or higher.

Auto-suggest configuration

This uses the same search as the search box. It is configured through the following attributes on the <autosuggest> element. Requires PageSeeder v5.99 or higher.

AttributeDescriptionDefault value

A comma-separated list of fields to display in the search results.

pstitle and psid are always displayed. To include the path, add these fields – psfolder, psfilename


A comma-separated list of filters (field:value) to focus search results. For example:



The project and group to search for target documents (for example, acme-specs)

[current group]
questionfieldsA comma-separated list of index fields to searchpstitle,psfilename, psdocid,psid


File document-config.xml

Following is an example of the <publishing> element deployed to a document-config.xml file:

  <action type="publish">
    <target name="psml-to-website">
      <description>Publish to website</description>
    <target name="psml-to-blog">
      <description>Publish to blog</description>
  <action type="export" >
    <target name="psml-to-pdf-columns" perspective="developer">
    <description>Export as PDF in 3 columns</description>
      <param name="depth"
             label="Depth of XRefs
             to publish"
             max="8" />
      <param name="isbn"
             placeholder="Enter a valid ISBN number (97xxxxxxxxxxx)"
             pattern="97[89][0-9]{10}" />
      <param name="in-stock"
             label="In Stock"
             perspective="developer" />
      <param name="language"

File publish-config.xml

Following is an example of the <publishing> element deployed to a publish-config.xml file:

  <action type="export">
    <source type="document" extension="psml" />
    <target name="psml-to-pdf-columns" perspective="developer">
      <description>Export as PDF in 3 columns</description>
  <action type="publish">
    <source type="folder" />
    <target name="psml-to-website">
      <description>Publish to website</description>
      <param name="depth"
             label="Depth of XRefs to publish"
             max="8" />
Created on , last edited on