w:smallCaps (Small Capitals)
Displays lowercase letters as small-sized capital letters.
Parent elements
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 text</w:t>
</w:r>new Run(
new RunProperties(new SmallCaps()),
new Text("small caps text"));<!-- Cancel small caps from parent style -->
<w:rPr>
<w:smallCaps w:val="false"/>
</w:rPr>new RunProperties(new SmallCaps { Val = false });Notes
- Text content unchanged; only visual rendering affected.
- Lowercase letters render as small capitals (typically 70-80% of cap height).
w:capsoverridesw:smallCapswhen both present.- Toggle property:
w:val="false"cancels from parent style. - Spell-checking uses original text, not rendered form.
- Professional typography use in headers, acronyms, publication titles.
- All Office versions support consistent rendering.