w:smallCaps (Small Capitals)

Displays lowercase letters as small-sized capital letters.

Parent elements

w:rPr

Description

w:smallCaps renders lowercase letters as small uppercase glyphs at a reduced size. It is an on/off toggle property defined in ECMA-376 Part 1 §17.3.2.36.

Like w:caps, the underlying stored text is not modified — only the visual rendering is affected. The exact reduction factor is font-dependent, typically around 70–80 % of the full cap height. w:caps takes precedence over w:smallCaps when both are set.

Attributes

Attribute	Type	Possible Values	Description
`w:val`	`ST_OnOff`	`true`, `1`, `on` (enabled) / `false`, `0`, `off` (disabled). Omitting the attribute is equivalent to `true`.	Toggles Small Caps on or off.

Examples

<w:r>
  <w:rPr>
    <w:smallCaps/>
  </w:rPr>
  <w:t>small caps</w:t>
</w:r>

new Run(
  new RunProperties(new SmallCaps()),
  new Text("small caps"));

Notes

Stored text is unchanged; only the glyph rendering is affected.
w:caps overrides w:smallCaps when both are present.