<num> (Numbering Definition Instance)

This element specifies a unique instance of numbering information that can be referenced by zero or more paragraphs within the parent WordprocessingML document.

This instance requires the referencing of a base abstract numbering definition through the @abstractNumId child element (§2.9.2). This element also can be used to specify a set of optional overrides applied to zero or more levels from the abstract numbering definition inherited by this instance second though the optional <lvlOverride> child elements (§2.9.9).

example:
<w:numbering>
  ...
  <w:num w:numId="2">
    <w:abstractNumId w:val="0" />
  </w:num>
  <w:num w:numId="3">
    <w:abstractNumId w:val="1" />
  </w:num>
  <w:num w:numId="4">
    <w:abstractNumId w:val="4" />
  </w:num>
  <w:num w:numId="5">
    <w:abstractNumId w:val="4" />
  </w:num>
</w:numbering>

As shown above, the first two numbering definition instances reference @abstractNumId values of 0 and 1 respectively, and the last two both reference the abstract numbering definition with an @abstractNumId of 4. ]

example:
<w:num w:numId="6">
  <w:abstractNumId w:val="4" />
  <w:lvlOverride w:ilvl="0">
    <w:lvl w:ilvl="0">
      <w:start w:val="4" />
      <w:lvlText w:val="%1)" />
      <w:lvlJc w:val="left" />
      <w:pPr>
        <w:ind w:left="360" w:hanging="360" />
      </w:pPr>
    </w:lvl>
  </w:lvlOverride>
</w:num>

The <lvlOverride> element specifies an override for level 0 of the abstract numbering definition. ]

Parent Elements

<numbering>2.9.17)

Child Elements

Subclause

<abstractNumId> (Abstract Numbering Definition Reference)

§2.9.2

<lvlOverride> (Numbering Level Definition Override)

§2.9.9

Attributes

Description

<numId> (Numbering Definition Instance ID)

Specifies a unique ID which any numbered paragraph which wishes to inherit these numbering properties shall reference using the <numPr> element (§2.3.1.19).

<w:p>
  <w:pPr>
    <w:numPr>
      <w:ilvl w:val="0" />
      <w:numId w:val="5" />
    </w:numPr>
  </w:pPr></w:p>

This paragraph references a numbering definition instance with a @numId attribute of 5:

<w:num w:numId="5">
  <w:abstractNumId w:val="4" />
</w:num>

The numbering definition instance with a @numId attribute of 5 correlates with the numbered paragraph with the numbering definition instance referent element with a @val of 5, so the numbered paragraph inherits its properties. ]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Num">
	<sequence>
	<element name="abstractNumId" type="CT_DecimalNumber" minOccurs="1"/>
	<element name="lvlOverride" type="CT_NumLvl" minOccurs="0" maxOccurs="9"/>
	</sequence>
	<attribute name="numId" type="ST_DecimalNumber" use="required"/>
</complexType>