# Work with Chapters

**Chapters** are used to organize Document Objects in a structure. A **Chapter** can contain Document Objects and other Chapters. When inserted into a Word Document, the chapter is converted to a heading in Word.

![](/files/-MOb-PkjnOarncJeVEXQ)

The Chapter path to a Document Object is displayed at the top of the Document Object Form.

{% hint style="info" %}
Note! The type name in the **Project Explorer** acts as a chapter and provides the function that normal chapters have. 
{% endhint %}

{% hint style="info" %}
Note! Changes to the Chapter structure are recorded in the **Project History**.
{% endhint %}

## How to add a Chapter

In the **Chapter View**, click on the **ellipsis** button of another Chapter or the root Chapter / Type and click **Add new Chapter**.

![](/files/-MOb0Iuq_hFp8eue59Zs)

This will prompt you to add a name for the Chapter. The Chapter name cannot be empty. Click **OK** to create the new Chapter. The Chapter will be displayed at the bottom of the current chapter list.

## How to rename a Chapter

Select an existing Chapter in the **Chapter View**. Use the **ellipsis** button to access the **Rename Chapter** button. You are now prompted to give the Chapter a new name. Click **OK** to commit the change.

## How to remove a Chapter

Select an existing Chapter in the **Chapter View**. Use the **ellipsis** button to access the **Remove Chapter** button. 

{% hint style="info" %}
Note! The chapter (or the corresponding subchapters) cannot be removed if it/they contain one or more Document Objects.
{% endhint %}

## How to move and reorder Chapters and Document Objects

In the **Chapter View**, use the ellipsis button in the root Chapter to click **Rearrange Chapters and Document Objects**. An Arrangement view will be displayed where you can use drag and drop to move and reorder Document Objects and Chapters. Click **OK** to commit the changes.

## Chapter Descriptions

As an optional feature, it is possible to add a text (rich text) to a chapter. This text will be displayed after the chapter (if so configured) when the chapter is inserted into a Word Document. 

Use the ellipsis menu to select **Edit Chapter Description** to access the text dialog in which to enter and modify the chapter description. If a Chapter has a chapter description, the chapter icon turns blue. It is then possible to view the chapter text by hovering with the mouse over the chapter icon.

Changes made to Chapter Descriptions are listed in the Project History.  

## Export and Import Chapter Structures

To reuse a Chapter structure for a different Document Object type, in a different Project, or in a different place in the current Chapter structure, use the **Export Chapter Structure** action in the Chapter View to download the structure originating from a selected Chapter as an xml file (.chs file in older versions of Aligned Elements). 

This file can then be applied in the **Import Chapter Structure** action in a different chapter.

The Chapter description, if existing, is included in the exported chapter structure file.

{% embed url="<https://youtu.be/YjWHxJaPGFo>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aligned.ch/aligned-elements-web-client-user-manual/2.6.176.20970/get-started/enter-design-control-items/work-with-chapters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.