---
title: "Section page | Writers' Toolkit documentation"
description: "Learn how to write a section page."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Section page

Section pages, also called landing pages, direct users to the most valuable resources contained within the section.

## Section structure

A *section* page includes the following elements:

- **Hero:** A banner across the top of the page that includes the section title and a brief description.
- **Overview:** A heading and one or two paragraphs that describe the resources contained within the section.
- **Explore:** A heading that contains cards.
  
  - **Cards:** Defined in the front matter, cards provide overviews of important pages and include links to those pages.

## Write a section page

To write a section, follow these steps:

1. Determine where you want to add the section, or find an existing section page to update.
2. If you’re creating a new section, create a directory that follows this naming convention:
   
   - The directory name matches the menu title planned for the section.
   - Use lowercase letters.
   - Add a hyphen between words.
3. Create an `_index.md` file within the section directory.
4. Add the usual front matter to the index file.
   
   For more information about front matter, refer to [Front matter](/docs/writers-toolkit/write/front-matter/).
5. Add the elements specific to a section page:
   
   - **Hero:** A [hero](/docs/writers-toolkit/write/shortcodes/#hero-simple) requires front matter and use of a shortcode.
   - **Cards:** A [card grid](/docs/writers-toolkit/write/shortcodes/#card-grid) requires front matter and use of a shortcode.

### Section page examples

Refer to the following pages for section page examples:

- [Grafana Explore](/docs/grafana/latest/explore/): A section page without an image in the hero.
- [Alerts and IRM](/docs/grafana-cloud/alerting-and-irm/): A section page with an image in the hero.

## Section template

When you’re ready to write, make a copy of the [Section template](https://github.com/grafana/writers-toolkit/blob/main/docs/static/templates/section-template.md) and add your content.