This command is similar to PlaceObject and is currently limited to output text which can be broken across positioning frames and which can wrap around objects.

Child elements


Parent elements

AtPageCreation, AtPageShipout, Case, Contents, ForAll, Loop, Otherwise, Record, SavePages, SetVariable, Until, While


allocate (optional)

Should text flow around already allocated objects? This currently works on the current page only.


Regular behavior: the text does not flow around objects.


Text flows around allocated objects.

area (text, optional)

The name of the positioning frame for the text.

balance (optional, since version 3.2.1)

Balance text on the last page (experimental)


Balance the last page


Do not balance the last page (default)

last-padding-bottom-max (length, optional, since version 3.2.1)

The maximum padding on the last page when valign-last is set to bottom

row (number, optional)

The starting row for the text.

valign-last (optional, since version 3.2.1)

When balancing: align the last columns at the top (default) or bottom (experimental).


Top alignment (default)


Align at the bottom


<Pagetype name="page" test="true()">
    <Margin left="1cm" right="1cm" top="1cm" bottom="1cm"/>
    <PositioningArea name="text">
      <PositioningFrame width="9" height="4" row="1" column="1"/>
      <PositioningFrame width="9" height="4" row="1" column="11"/>
      <PositioningFrame width="9" height="4" row="6" column="1"/>
      <PositioningFrame width="9" height="4" row="6" column="11"/>
  <Record element="data">
    <Output area="text">
        <Paragraph fontfamily="text">
          <Value>A wonderful serenity has taken possession of my entire soul,...</Value>

See also

The command <Text> in the basics chapter.