#### 25.1.2 Specifying topic levels in ditamaps

To specify map levels for topics, assign a level number to each format that you map to a <title> element at the topic level in [DITAParaTags]; see §24.4.3 Mapping paragraph formats to DITA block elements. For example:

    [DITAMapLevels]
    ; para format = level of topics it starts in ditamap, default 1.
    Heading1 = 1
    Heading2 = 2

Each instance of a paragraph format assigned a level number generates a <topicref> that nests the lower <topicref> elements. For paragraph formats that are not listed here, but that are mapped to <title> elements at the topic level in [DITAParaTags], DITA2Go uses any level assignments you have provided for those formats in [HelpContentsLevels]. See §16.4.3 Setting contents levels for HTML-based Help.

If you direct DITA2Go to nest topics, DITA2Go adjusts map levels as follows:

- If a topic is nested in a glossary topic (which is invalid), the map level of the nested topic is decreased to make it a sibling of the glossary topic.
- If a topic is set to a level more than one deeper than the previous topic, its level is decreased so that no levels are skipped.

Any adjustments to map levels also affect the chapter ditamap.

See also:

§24.5.12 Specifying DITA element levels

Previous Topic: 25.1.1.5 Specifying a navigation title for a ditamap

Next Topic: 25.1.3 Specifying roles for topics in ditamaps

Parent Topic: 25.1 Configuring ditamaps

Sibling Topics:

25.1.1 Specifying options for ditamaps

25.1.3 Specifying roles for topics in ditamaps

25.1.4 Adding relationship tables to ditamaps

25.1.5 Providing navigation aids in ditamaps