w:ind (Paragraph Indentation)

Description

w:ind controls the left, right, and first-line (or hanging) indentation of the paragraph. All distance values are in twentieths of a point (twips); 1 inch = 1440 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, the ECMA-376 standard specifies that w:firstLine takes precedence. This element appears in paragraph properties and in list level definitions (for list formatting).

Indentation can be specified in either twips (distance units) or character widths; distance-based attributes take precedence over character-width attributes when both are present.

Attributes

Examples

<!-- Hanging indent (0.5 in out, 0.25 in): typical bulleted list -->
<w:pPr>
  <w:ind w:left="720" w:hanging="360"/>
</w:pPr>

var pPr = new ParagraphProperties(
  new Indentation { Left = "720", Hanging = "360" });
// First line at left margin (720 - 360), subsequent lines at 720

<!-- First-line indent (0.5 in): essay/report style -->
<w:pPr>
  <w:ind w:left="1440" w:firstLine="720"/>
</w:pPr>

var pPr = new ParagraphProperties(
  new Indentation { Left = "1440", FirstLine = "720" });
// First line at 2160 twips (1440 + 720), subsequent at 1440

<!-- Block quote: left and right indent, 1 inch each -->
<w:pPr>
  <w:ind w:left="1440" w:right="1440"/>
</w:pPr>

var pPr = new ParagraphProperties(
  new Indentation { Left = "1440", Right = "1440" });

Common Indentation Patterns

Twips Conversion

Indentation Scenarios

Scenario 1: Bulleted List (Hanging Indent)

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

Effect: Bullet at left margin, text wraps to 0.5” from left.

Scenario 2: Block Quote (Left & Right Indent)

<w:pPr>
  <w:ind w:left="1440" w:right="1440"/>
</w:pPr>

Effect: Entire paragraph indented 1” on both sides.

Scenario 3: First-Line Indent (Essay Style)

<w:pPr>
  <w:ind w:left="1440" w:firstLine="720"/>
</w:pPr>

Effect: First line at 2.16”, subsequent lines at 1.44”; common in academic writing.

Scenario 4: Nested List (Multiple Levels)

<!-- Level 0 -->
<w:pPr>
  <w:ind w:left="0" w:hanging="360"/>
</w:pPr>

<!-- Level 1 (nested) -->
<w:pPr>
  <w:ind w:left="720" w:hanging="360"/>
</w:pPr>

<!-- Level 2 (deeply nested) -->
<w:pPr>
  <w:ind w:left="1440" w:hanging="360"/>
</w:pPr>

Effect: Each nested level indents an additional 0.5”.

Notes

• Mutual Exclusivity: Only w:firstLine OR w:hanging; w:firstLine takes precedence if both present.
• Negative Values: w:left and w:right can be negative (outdent into margin); used for special effects like margin notes.
• Character Width Override: *Chars attributes override distance-based attributes when both present; character-width is resolution-independent.
• Character Count Units: Fiftieths-of-character; 100 = 1 character width; allows indentation relative to font width.
• List Formatting: Hanging indent essential for proper bullet/number alignment; works with w:numPr.
• Paragraph Flow: Indentation applies all lines except where overridden by w:firstLine or w:hanging.
• Tab Stops Interaction: Indentation is independent of tab stops; both apply to layout.
• RTL Text: Indentation semantics mirror in right-to-left documents; left becomes right, etc.
• Accessibility: Indentation should reflect logical structure; use semantic list markup (w:numPr) for lists.
• Edge Case - Negative Hanging: A negative w:hanging value outdents the first line past the left margin (creates “hanging” opposite effect).
• Combined with Spacing: Use with w:spacing (before/after) for complete paragraph control.
• Performance: Extreme indentation values (>5”) may impact rendering; keep reasonable.
• Margin Interaction: Indentation is added to (or subtracts from) page margins.
• RTL Documents: Left/right semantics reversed in right-to-left text.
• Proportional Fonts: Character-width indentation more consistent than twips with varying fonts.
• Compatibility: All indentation types render consistently across Office versions.
• Character-based precedence: When both distance (w:left) and character-width (w:leftChars) attributes are present, character-width takes precedence in rendering.
• Lists: Hanging indentation is the standard for bulleted and numbered lists; the first line (number/bullet) sits at w:left, body wraps at w:left + w:hanging.
• Zero values: It’s valid to omit any attribute; missing attributes default to zero.
• Contextual spacing: Some styles use w:contextualSpacing to automatically adjust indentation in certain contexts (e.g., when inside a list).