The <stepsection> element provides expository text before a <step> element. Although the element is specialized from <li> and has the same content model as a list item, it is not intended to represent a step in a task.


DITA applications which render <stepsection> elements among the <step> elements must provide a way to number the steps without numbering the <stepsection> elements (although this does not need to be the only or default presentation).

Content models

See appendix for information about this element in OASIS document type shells.


- topic/li task/stepsection


  <step><cmd>Get out a bowl</cmd></step>
  <stepsection>The next two steps are very important!</stepsection>
  <step><cmd>Put on safety gloves</cmd></step>
  <step><cmd>Put on goggles</cmd></step>
  <step><cmd>Pour milk and cereal into the bowl</cmd></step>

The sample above would typically be rendered with "Get out a bowl" as step number one, "Put on safety gloves" as step number two, and "The next two steps are very important!" as an unnumbered item in between the first two items.


The following attributes are available on this element: Universal attribute group and @outputclass.

Was this helpful?