---
title: "p.title.toc-chapter"
description: "## Syntax **p.title.toc-chapter** ## Purpose The p.title.toc-chapter annotation is used to tag an element as being the title of a chapter in the document. A chapter element exists in the bookmap’s metadata and contains one or more elements, which refer…"
url: "https://www.stilo.com/docs/migrate/task/p-title-toc-chapter/"
updated: "2023-12-11"
category: Annotations / Task
tags:
  - Annotations
---

# p.title.toc-chapter

## Syntax

**p.title.toc-chapter**

## Purpose

The p.title.toc-chapter annotation is used to tag an element as being the title of a chapter in the document. A chapter element exists in the bookmap’s metadata and contains one or more <topicref> elements, which refer to their associated DITA files. This defines what content is contained within a chapter in a bookmap.

 

This annotation should be applied to the heading of the section where you wish to begin a chapter. It will contain all following content until the next chapter, appendix, or backmatter element is created.

 

This annotation is not applied to the table of contents entry.

## Example

The following is an example of a time when you might want to use the annotation

![](https://www.stilo.com/wp-content/uploads/2023/12/stilo-dita-xml-annotation-p.title_.toc-chapter0.png)

 

The following is an example of a rule that will apply the annotation

![](https://www.stilo.com/wp-content/uploads/2023/12/stilo-dita-xml-annotation-p.title_.toc-chapter1.png)

The following is the DITA XML output for the rule:

<chapter>

<topicref href="Chapter_1_Overview_of_the_MacGuffin.dita">

<topicref href="The_MacGuffin.dita"/>

<topicref href="Usage_Scenarios.dita"/>

</topicref>

</chapter>