---
title: Directory listing · Cloudflare Style Guide
description: Use <DirectoryListing /> to display the directory of a specific
  folder, which appears as a list of links.
lastUpdated: 2025-08-20T21:45:15.000Z
chatbotDeprioritize: true
source_url:
  html: https://developers.cloudflare.com/style-guide/components/directory-listing/
  md: https://developers.cloudflare.com/style-guide/components/directory-listing/index.md
---

Use `<DirectoryListing />` to display the directory of a specific folder, which appears as a list of links.

## Usage

## Props

### `folder`

**type:** `string`

The folder path to list contents from. If not provided, defaults to the current page's path.

### `descriptions`

**type:** `boolean` **default:** `false`

When enabled, shows the [frontmatter `description`](https://developers.cloudflare.com/style-guide/frontmatter/) field for each page in the listing.

### `maxDepth`

**type:** `number` **default:** `1`

Controls how many levels of nested pages to display. A value of `1` shows only direct children, while higher values will show deeper nesting levels.

### `tag`

**type:** `string`

Optionally, filter the listing to only pages with a specific tag.

## Associated content types

* [Navigation](https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/navigation/)
