w:lvl (Numbering Level)
Defines the number format, alignment, indentation, text template, and paragraph/run properties for one level of a list.
Parent elements
Description
w:lvl defines the format, indentation, and text pattern for one level of a multi-level list within w:abstractNum. It is defined in ECMA-376 Part 1 §17.9.6.
Each w:lvl has a w:ilvl attribute (0-based level index) and contains child elements: w:start (starting value), w:numFmt (number format), w:lvlText (label pattern), w:lvlJc (label alignment), w:pPr (paragraph indent), and optionally w:rPr (label run properties).
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
w:ilvl |
ST_DecimalNumber |
0–8 |
Zero-based index of this level within the list (0 = outermost). |
w:tplc |
ST_LongHexNumber |
8-digit hex | Template code used by Word UI (informational). |
w:tentative |
ST_OnOff |
true / false |
When true, this level definition is not yet used; format may change on first use. |
Examples
<!-- Level 0: numbered 1. 2. 3. -->
<w:lvl w:ilvl="0">
<w:start w:val="1"/>
<w:numFmt w:val="decimal"/>
<w:lvlText w:val="%1."/>
<w:lvlJc w:val="left"/>
<w:pPr>
<w:ind w:left="720" w:hanging="360"/>
</w:pPr>
</w:lvl>new Level(
new StartNumberingValue { Val = 1 },
new NumberingFormat { Val = NumberFormatValues.Decimal },
new LevelText { Val = "%1." },
new LevelJustification { Val = LevelJustificationValues.Left },
new ParagraphProperties(
new Indentation { Left = "720", Hanging = "360" }))
{ LevelIndex = 0 };