orderedlist — A list in which each entry is marked with a sequentially incremented label.


orderedlist ::=


Common attributes and common linking attributes.

Additional attributes:

  • At most one of:
    • continuation (enumeration)
      • “continues”
      • “restarts”
    • startingnumber (integer)
  • inheritnum (enumeration)
    • “ignore”
    • “inherit”
  • numeration (enumeration)
    • “arabic”
    • “upperalpha”
    • “loweralpha”
    • “upperroman”
    • “lowerroman”
  • spacing (enumeration)
    • “compact”
    • “normal”

Additional Constraints

  • If this element is the root element, it must have a version attribute.


In an orderedlist, each member of the list is marked with a numeral, letter, or other sequential symbol (such as Roman numerals).

Processing expectations

Formatted as a displayed block.

The numeration attribute indicates the desired numeration. If it is not specified, Arabic numerals (1, 2, 3, …) are to be used.


The actual characters used in alphabetic numeration may be locale sensitive. Where the sequence “a”, “b”, “c” might be selected in an English locale, “ア”, “イ”, “ウ” might be selected if Katakana was implied by the current locale.

The continuation attribute indicates how numbering should begin relative to the immediately preceding list. If it is not specified, numbering is to be restarted at 1.


The preceding list is not required to be in the same parent. That is, a list in one chapter may be continued in the next, or indeed arbitrarily later in the document, provided no other list intervenes.

The inheritnum attribute indicates how items in nested lists should be numbered. If it is not specified, numbering is to ignore list nesting. Inherited numeration creates compound list item numbers.

If inheritnum is “inherit”, then the third item of a list inside the second item of a list inside the fourth item of a list might be enumerated as “4.2.3”. If inheritnum is “ignore”, then it would be simply “3” (with the numeration attribute handling the actual format of the numbers).

In nested lists, some publishers prefer to use Arabic numbers throughout (4.3.2) while others prefer to step through a sequence of numerations (4.b.iii). DocBook does not specify the sequence of numerations.


Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace


Indicates how list numbering should begin relative to the immediately preceding list

Enumerated values:

Specifies that numbering should begin where the preceding list left off


Specifies that numbering should begin again at 1


Indicates whether or not item numbering should be influenced by list nesting

Enumerated values:

Specifies that numbering should ignore list nesting


Specifies that numbering should inherit from outer-level lists


Indicates the desired numeration

Enumerated values:

Specifies Arabic numeration (1, 2, 3, …)


Specifies upper-case alphabetic numeration (A, B, C, …)


Specifies lower-case alphabetic numeration (a, b, c, …)


Specifies upper-case Roman numeration (I, II, III, …)


Specifies lower-case Roman numeration (i, ii, iii …)


Specifies (a hint about) the spacing of the content

Enumerated values:

The spacing should be "compact".


The spacing should be "normal".


Specifies the initial line number


These elements contain orderedlist: abstract, acknowledgements, annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, cover, danger, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, meta (db.meta.content), msgexplan, msgtext, note, orderedlist, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, result, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, topic, variablelist, warning.


The following elements occur in orderedlist: address, anchor, annotation, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, danger, destructorsynopsis, enumsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalgroup, formalpara, funcsynopsis, glosslist, important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, listitem, literallayout, macrosynopsis, mediaobject, methodsynopsis, msgset, note, orderedlist, packagesynopsis, para, procedure, productionset, programlisting, programlistingco, qandaset, remark, revhistory, screen, screenco, screenshot, segmentedlist, sidebar, simpara, simplelist, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, typedefsynopsis, unionsynopsis, variablelist, warning.

See Also

Related elements: calloutlist, itemizedlist, listitem, segmentedlist, simplelist, variablelist.


 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example orderedlist</title>
   |<orderedlist numeration="lowerroman">
 5 |  <listitem>
   |    <para>One</para>
   |  </listitem>
   |  <listitem>
   |    <para>Two</para>
10 |  </listitem>
   |  <listitem>
   |    <para>Three</para>
   |  </listitem>
   |  <listitem>
15 |    <para>Four</para>
   |  </listitem>
  1. One

  2. Two

  3. Three

  4. Four