w:trPr (Table Row Properties)

Contains formatting properties that apply to the entire table row.

Parent elements

Description

w:trPr is the table row properties container, grouping all row-level formatting for a w:tr. It is defined in ECMA-376 Part 1 §17.4.82.

Common children include w:trHeight (row height), w:tblHeader (repeat as header), w:cantSplit (prevent row from breaking across pages), and w:ins/w:del (revision tracking at the row level).

Attributes

Attribute Type Possible Values Description
(none) — — Properties are expressed exclusively through child elements.

Examples

<!-- Header row: 600 twips high, repeats on each page -->
<w:trPr>
  <w:trHeight w:val="600" w:hRule="exact"/>
  <w:tblHeader/>
</w:trPr>
<!-- Regular data row: prevent split across pages -->
<w:trPr>
  <w:trHeight w:val="720" w:hRule="atLeast"/>
  <w:cantSplit/>
</w:trPr>

Notes

  • Height Rules: auto (fit content), exact (fixed), atLeast (minimum).
  • Table Header: w:tblHeader repeats row on every page; useful for multi-page tables.
  • Page Breaks: w:cantSplit prevents row from breaking across page boundaries.
  • Row-Level: Properties apply to entire row; cell-level properties override.
  • Revision Tracking: w:ins/w:del children track row insertions/deletions.
  • Property Scope: Contains only metadata; actual row content is in w:tc (cells).
  • Compatibility: All Office versions support row properties consistently.