###### 3.1.1.1.1 topic

The <topic> element is the top-level DITA element for a single-subject topic or article. Other top-level DITA elements that are more content-specific are <concept>, <task>, <reference>, and <glossentry>, all of which are specializations of the <topic> element.

###### Contains

Doctype | Content model
topic, concept, glossary, glossentry, glossgroup, reference, task, machineryTask, learningAssessment, learningOverview, learningPlan, learningSummary | ( (title) then (titlealts) (optional) then (shortdesc or abstract) (optional) then (prolog) (optional) then (body) (optional) then (related-links) (optional) then (topic) (any number) )
ditabase | ( (title) then (titlealts) (optional) then (shortdesc or abstract) (optional) then (prolog) (optional) then (body) (optional) then (related-links) (optional) then (topic or concept or task or reference or glossentry or glossgroup) (any number) )
learningContent | ( (title) then (titlealts) (optional) then (shortdesc or abstract) (optional) then (prolog) (optional) then (body) (optional) then (related-links) (optional) then ( (no-topic-nesting) (optional) ) (any number) )

###### Contained by

Doctype | Content model
topic (base), topic (technical content), concept, reference, task (strict), task (general), machineryTask | topic
ditabase | dita, topic, concept, task, reference
glossary, glossentry, glossgroup | topic, concept
learningAssessment, learningOverview, learningPlan, learningSummary | topic, learningBase
learningContent | learningBase, learningContent

###### Inheritance

- topic/topic

###### Example

    <topic id="topic">
     <title>Some little topic</title>
     <body>
      <p>Here's a little topic.</p>
      <ul>
       <li>Some item</li>
       <li>Another item</li>
      </ul>
     </body>
    </topic>

###### Attributes

Name | Description | Data Type | Default Value | Required?
id | This ID enables topics to be referenced uniquely by topicrefs in DITA maps. | ID |  | Yes
conref-atts attribute group (conref, conrefend, conaction, conkeyref) | A set of related attributes; includes all of the attributes described in 3.4.1.4 id-atts attribute group except for the id attribute. |  |  |
xmlns:ditaarch | Declares the default DITA namespace. |  | "http://dita.​oasis-open.​org/​architecture/​2005/" |
DITAArchVersion | Designates the version of the architecture that is in use. The default value will increase with each release of DITA. | CDATA | "1.2" | No
domains | Indicates the specialized domains that are included in the DTD or Schema. This value will differ depending on what domains are included in the current DTD or Schema. | CDATA | Varies based on the DTD or Schema; a sample value is "(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" | No
select-atts attribute group (props, base, platform, product, audience, otherprops, importance, rev, status) | A set of related attributes, described in 3.4.1.5 select-atts attribute group |  |  |
localization-atts attribute group (translate, xml:lang, dir) | A set of related attributes, described in 3.4.1.6 localization-atts attribute group. |  |  |
global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in 3.4.1.2 global-atts attribute group |  |  |
class, outputclass | Common attributes described in 3.4.1.9 Other common DITA attributes |  |  |

Previous Topic: 3.1.1.1 Basic topic elements

Next Topic: 3.1.1.1.2 title

Parent Topic: 3.1.1.1 Basic topic elements

Sibling Topics:

3.1.1.1.2 title

3.1.1.1.3 titlealts

3.1.1.1.4 searchtitle

3.1.1.1.5 navtitle

3.1.1.1.6 shortdesc

3.1.1.1.7 abstract

3.1.1.1.8 body

3.1.1.1.9 bodydiv

3.1.1.1.10 related-links

3.1.1.1.11 dita