**Help improve this page** 

To contribute to this user guide, choose the **Edit this page on GitHub** link that is located in the right pane of every page.

# Create a new page
<a name="create-page"></a>

Learn how to create a new documentation page. This topic includes instructions for creating the initial page metadata and adding the page to the guide table of contents.

## Create page
<a name="_create_page"></a>

1. Navigate to the chapter directory. For example, if you want to create a new page in the "Security" section, navigate to the `latest/ug/security` directory.

1. Determine the page ID. By convention, the page ID is all lowercase and segmented with `-`. The ID of this page is `create-page`.

1. Create a new file with the page ID and the `adoc` extension. For example, `create-page.adoc`.

1. Insert the page metadata using this template:

```
 include::../attributes.txt[]

 [.topic]
 [#unique-page-id]
 = Page title
 :info_titleabbrev: Short title

 [abstract]
 --
 Brief summary of the page's content.
 --

 Introduction paragraph goes here.
```

## Add page to navigation
<a name="_add_page_to_navigation"></a>

1. Navigate to the parent page. The parent page of top level sections is `book.adoc`.

1. At the bottom of the parent page, include the child page.

    `include::${filename}[leveloffset=+1]` 

    *For example:* 

    `include::create-page.adoc[leveloffset=+1]` 

## See also

* **Skills for AI coding assistants (optional).** AWS publishes reusable skills for Amazon EKS. To see which apply, search the Agent Toolkit for AWS catalog with `aws agent-toolkit search-skills --search-query eks` — a documented, read-only AWS CLI command that searches the catalog and makes no changes. This is an optional suggestion for the user. Official reference: [AWS CLI — Agent Toolkit for AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html).