Insert a paragraph of text. The width of the paragraph is inherited from the surrounding element.

Child elements

A, Action, B, Barcode, Br, Clip, Color, Fontface, ForAll, Frame, HSpace, I, Image, Initial, Loop, NoBreak, Span, Sub, Sup, Switch, U, URL, Value

Parent elements

Case, ForAll, Function, Loop, Otherwise, SetVariable, Td, Text, Textblock, Until, While


allowbreak (text, optional)

(Experimental!) list of characters where a line break is possible. Space character is not implied when this attribute is set.

bidi (optional, since version 4.1.14)

Analyze direction of the text. Useful for mixing left-to-right and right-to-left text.


Analyze text.


Don’t handle mixed directions (default).

class (text, optional)

CSS class for this paragraph.

color (text, optional, CSS property: color)

Color of the paragraph. Must be defined with DefineColor before use.

direction (text, optional, since version 4.1.12)

The text direction (ltr or rtl)

font-outline (length, optional, since version 4.13.15)

Set the line width of the font outline.

fontfamily (text, optional, CSS property: font-family)

The name of the font family for the paragraph. The default is »text« (lowercase t).

html (optional, since version 4.1.2)

Set the HTML processing mode. Defaults to 'all'.


Interpret HTML starting from the current element.


Ignore the name of the outer element.


Switch off HTML in this paragraph. Use only the text value.

id (text, optional)

CSS id for this paragraph.

label-left (text, optional, since version 4.1.4)

A text to the left of the paragraph.

label-left-align (optional, since version 4.1.4)

Alignment of the text.


Left aligned


Right aligned

label-left-distance (length, optional, since version 4.1.4)

Horizontal distance between text and paragraph (if right aligned).

label-left-width (length, optional, since version 4.1.4)

Width of the text.

language (optional)

Name of the language for hyphenation and rendering.

padding-left (length, optional, since version 3.9.27)

Set the left padding, i.e. the inner distance to the allocated area.

padding-right (length, optional, since version 3.9.27)

Set the right padding, i.e. the inner distance to the allocated area.

parent (text, optional, since version 4.19.8)

The id of the parent structure element for tagged PDF

role (optional, since version 3.5.7)

The role for PDF/UA (accessibility, tagged PDF)

textformat (text, optional)

Name of the textformat that is applied to the paragraph. If none is specified the textformat text is used.


  <Paragraph fontfamily="Title">
    <Value>Hello World</Value>

See also

The section text formatting and the command Options for a list of all languages.