# Content Organization

URL: /bengal/docs/build-sites/structure/organization/
Section: organization
Description: Pages, sections, and bundles explained

---

> For a complete page index, fetch /bengal/llms.txt.

Your folder structure becomes your site structure. No configuration required.

Note

Do I need this? Yes when planning site structure, menus, or content types.
Skip if you only write single pages in an existing scaffold — see
Writer Quickstart (/bengal/docs/get-started/quickstart-writer/) instead.

Frontmatter Reference

Complete reference for all frontmatter fields

(/bengal/docs/build-sites/structure/organization/frontmatter/)

Navigation Menus

Configure navigation menus in Bengal

(/bengal/docs/build-sites/structure/organization/menus/)

The Component Model

Understanding Bengal's Component Model: Identity, Mode, and Data.

(/bengal/docs/build-sites/structure/organization/component-model/)

Component Model Reference

Exhaustive type, variant, props, cascade, and skeleton examples for Bengal's component model

(/bengal/docs/build-sites/structure/organization/component-model-reference/)

## The Three Content Types

flowchart TB
subgraph "Your Files"
A["📄 about.md"]
B["📁 blog/_index.md"]
C["📦 gallery/index.md"]
end

subgraph "Your Site"
D["/about/"]
E["/blog/ + children"]
F["/gallery/ + assets"]
end

A --> D
B --> E
C --> F

- 📄 Page (#)

- 📁 Section (#)

- 📦 Bundle (#)

A single`.md`file → a single HTML page.

tree-sitter-query
TREE-SITTER-QUERY

```
content/
└── about.md  →  /about/
```
Use for: standalone pages like About, Contact, Privacy Policy.

A folder with`_index.md`→ a list page with children.

tree-sitter-query
TREE-SITTER-QUERY

```
content/
└── blog/
    ├── _index.md     →  /blog/ (list page)
    ├── post-1.md     →  /blog/post-1/
    └── post-2.md     →  /blog/post-2/
```
Use for: blog posts, documentation chapters, any collection.

A folder with`index.md`→ a page with co-located assets.

tree-sitter-query
TREE-SITTER-QUERY

```
content/
└── gallery/
    ├── index.md      →  /gallery/
    ├── photo-1.jpg   (co-located asset)
    └── photo-2.jpg   (co-located asset)
```
Use for: pages with images, data files, or other assets that belong together.

## Quick Reference

Pattern
File
Creates
Assets

Page
`name.md`
Single page
Use`static/`

Section
`name/_index.md`
List + children
Use`static/`

Bundle
`name/index.md`
Single page
Co-located

Tip

Key difference:`_index.md` creates a section (with children). `index.md`creates a bundle (with assets). The underscore matters!

Advanced: Nesting and Cascades

Sections can nest to any depth:

```
docs/
├── _index.md
├── getting-started/
│   ├── _index.md
│   └── installation.md
└── advanced/
    ├── _index.md
    └── plugins.md
```

Configuration cascades from parent to children:

yaml
YAML

```
---
title: Docs
cascade:
  type: doc
  toc: true
---
```
All pages under `docs/` inherit `type: doc` and `toc: true`unless they override it.

Seealso

- Component Model (/bengal/docs/build-sites/structure/organization/component-model/) — Understanding type, variant, and props

- Frontmatter Reference (/bengal/docs/build-sites/structure/organization/frontmatter/) — All frontmatter fields

- Menu Configuration (/bengal/docs/build-sites/structure/organization/menus/) — Navigation menus

## In This Section

Component Model Reference (/bengal/docs/build-sites/structure/organization/component-model-reference/)

Exhaustive type, variant, props, cascade, and skeleton examples for Bengal's component model

Frontmatter Reference (/bengal/docs/build-sites/structure/organization/frontmatter/)

Complete reference for all frontmatter fields

Navigation Menus (/bengal/docs/build-sites/structure/organization/menus/)

Configure navigation menus in Bengal

The Component Model (/bengal/docs/build-sites/structure/organization/component-model/)

Understanding Bengal's Component Model: Identity, Mode, and Data.

Related Pages

Write (/bengal/docs/build-sites/write/)

Author content, reuse snippets, and apply MyST directives

Related

Structure (/bengal/docs/build-sites/structure/)

Organize pages, collections, i18n, versioning, and site analysis

Related

Build Sites (/bengal/docs/build-sites/)

Write, structure, customize, and extend your Bengal site

Related

persona-writer (/bengal/tags/persona-writer/)