w:lvlPicBulletId (Level Picture Bullet ID)

References a picture bullet definition (w:numPicBullet) to use as the bullet symbol for a numbering level.

Parent elements

w:lvl

Description

w:lvlPicBulletId links a list level (w:lvl) to a picture bullet definition (w:numPicBullet) by its integer ID. When present, the image from the referenced w:numPicBullet is rendered as the bullet for each list item at that level, instead of the character specified by w:lvlText.

It is defined in ECMA-376 Part 1 §17.9.10.

For picture bullets to display correctly:

w:numFmt must be set to bullet.
w:lvlText is typically set to a space (" ").

Attributes

Attribute	Type	Possible Values	Description
`w:val`	`xsd:integer`	Non-negative integer	Matches the `w:numPicBulletId` of the target `w:numPicBullet`.

Examples

<w:lvl w:ilvl="0">
  <w:start w:val="1"/>
  <w:numFmt w:val="bullet"/>
  <w:lvlPicBulletId w:val="1"/>
  <w:lvlText w:val=" "/>
  <w:lvlJc w:val="left"/>
  <w:pPr>
    <w:ind w:left="720" w:hanging="360"/>
  </w:pPr>
</w:lvl>

using DocumentFormat.OpenXml.Wordprocessing;

var level = new Level(
    new StartNumberingValue { Val = 1 },
    new NumberingFormat { Val = NumberFormatValues.Bullet },
    new LevelPictureBulletId { Val = 1 },
    new LevelText { Val = " " },
    new LevelJustification { Val = LevelJustificationValues.Left },
    new ParagraphProperties(
        new Indentation { Left = "720", Hanging = "360" }
    )
)
{ LevelIndex = 0 };

Notes

The w:numPicBullet definition referenced by w:val must exist in the same numbering.xml part.
w:lvlText for a picture level should be set to a whitespace character so text-only renderers show a fallback space.
See w:numPicBullet for how to define the picture itself.