NumberingProperties Class

Defines the NumberingProperties Class.When the object is serialized out as xml, its qualified name is w:numPr.

Inheritance Hierarchy


Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)


<ChildElementInfoAttribute(GetType(NumberingLevelReference))> _
<ChildElementInfoAttribute(GetType(NumberingId))> _
<ChildElementInfoAttribute(GetType(NumberingChange))> _
<ChildElementInfoAttribute(GetType(Inserted))> _
Public Class NumberingProperties _
    Inherits OpenXmlCompositeElement
Dim instance As NumberingProperties
public class NumberingProperties : OpenXmlCompositeElement


The following table lists the possible child types:

  • NumberingLevelReference <w:ilvl>

  • NumberingId <w:numId>

  • NumberingChange <w:numberingChange>

  • Inserted <w:ins>

[ISO/IEC 29500-1 1st Edition] numPr (Numbering Definition Instance Reference)

This element specifies that the current paragraph references a numbering definition instance in the current document.

The presence of this element specifies that the paragraph inherits the properties specified by the numbering definition in the num element (§17.9.16) at the level specified by the level specified in the lvl element (§17.9.7) and shall have an associated number positioned before the beginning of the text flow in this paragraph. When this element appears as part of the paragraph formatting for a paragraph style, then any numbering level defined using the ilvl element shall be ignored, and the pStyle element (§17.9.24) on the associated abstract numbering definition shall be used instead.

[Example: Consider a paragraph in a document which should be associated with level 4 of a numbering definition with ID 0. Associating the paragraph with this numbering definition would be specified using the following WordprocessingML:

    <w:ilvl w:val="4" />
    <w:numId w:val="0" />

The numPr element specifies that this paragraph must contain numbering information, and its children specify that the numbering definition for that numbering information must have a numId of 0 and an ilvl of 4 within that numbering definition. end example]

Parent Elements

pPr (§; pPr (§; pPr (§; pPr (§; pPr (§17.9.23); pPr (§

Child Elements


ilvl (Numbering Level Reference)


ins (Inserted Numbering Properties)


numId (Numbering Definition Instance Reference)


[Note: The W3C XML Schema definition of this element’s content model (CT_NumPr) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also


NumberingProperties Members

DocumentFormat.OpenXml.Wordprocessing Namespace