w:basedOn (Base Style)

Specifies the styleId of the parent style from which this style inherits all unoverridden properties.

Parent elements

Description

w:basedOn specifies the parent style from which a style inherits all properties. It is defined in ECMA-376 Part 1 §17.7.4.3.

When a style is based on another, it inherits all paragraph and run properties of the parent, and only needs to specify the differences. This creates a style hierarchy. Most document styles are ultimately based on Normal.

Attributes

Attribute Type Possible Values Description
w:val ST_String The styleId of the parent style. References the style this style inherits from.

Examples

<w:style w:type="paragraph" w:styleId="MyCustomStyle">
  <w:basedOn w:val="Normal"/>
  <!-- only override properties here -->
</w:style>