OOXML.org

w:ind (Paragraph Indentation)

Sets the left, right, and first-line (or hanging) indentation for a paragraph in twentieths of a point.

Parent elements

Description

w:ind controls the left, right, and first-line (or hanging) indentation of the paragraph. All values are in twentieths of a point (twips). It is defined in ECMA-376 Part 1 §17.3.1.12.

First-line and hanging indentation are mutually exclusive: if both w:firstLine and w:hanging are present, w:firstLine takes precedence.

Attributes

Attribute Type Possible Values Description
w:left ST_SignedTwipsMeasure Integer in twips (e.g. 720 = 0.5 in = 36 pt). May be negative. Distance between the left margin and the left edge of the paragraph text.
w:right ST_SignedTwipsMeasure Integer in twips. May be negative. Distance between the right margin and the right edge of the paragraph text.
w:firstLine ST_TwipsMeasure Non-negative integer in twips. Additional indentation on the first line only (positive = indent in from w:left). Mutually exclusive with w:hanging.
w:hanging ST_TwipsMeasure Non-negative integer in twips. The first line is outdented by this amount relative to w:left (positive value). Used in list formatting.
w:leftChars xsd:integer Percentage in fiftieths of a character width (e.g. 100 = 1 character). Left indent specified in character widths; takes precedence over w:left when both present.
w:rightChars xsd:integer Percentage in fiftieths of a character width. Right indent in character widths.
w:firstLineChars xsd:integer Percentage in fiftieths of a character width. First-line indent in character widths.
w:hangingChars xsd:integer Percentage in fiftieths of a character width. Hanging indent in character widths.

Examples

0.5 in hanging indent (typical for lists)

<w:pPr>
  <w:ind w:left="720" w:hanging="360"/>
</w:pPr>

Notes

  • 1 inch = 1440 twips; 1 cm ≈ 567 twips.
  • w:firstLine and w:hanging cannot both be positive at the same time; w:firstLine wins if both appear.