# cms-edit — Content Type Field Reference

This page lists the content types managed by `cms-edit` and links to their field references.

---

## Content Types

| Content Type | Used For | Detail |
|---|---|---|
| `page` | Web pages with a slug and content tree | `cms-edit help fields-page` |
| `article` | Blog posts and news items | `cms-edit help fields-article` |
| `component` | Individual content sections (hero, text block, card, etc.) | `cms-edit help fields-component` |
| `collection` | Groups of components (card grids, timelines, etc.) | `cms-edit help fields-collection` |
| `link` | CTA button entries | Managed via `cms-edit links` |
| `template` | Reusable page shell (header, footer slots) | Used via `templateId` in `create from-json` |
| `navigation` | Site navigation entries | Managed via `cms-edit nav` |

---

## Type Discriminators

Many content types have a `*Type` field that picks a specific variant:

| Content Type | Discriminator Field | Values |
|---|---|---|
| `component` | `componentType` | `HeroSimple`, `TextBlock`, `CardGrid`, `Generic`, etc. |
| `collection` | `collectionType` | `CardGrid`, `Timeline`, `CategoryExplorer`, etc. |

Run `cms-edit schema types <content-type>` to see all valid discriminator values for the current space.

---

## Colour Fields

The `backgroundColour` and `textColour` fields accept named values, not hex codes.

Run `cms-edit schema colours` to see valid values for the current space.

Common values: `"Navy"`, `"White"`, `"Grey"`, `"Black"`, `"Brand"`.

---

## Ref Addressing

When a session is open (after `cms-edit open`), entries are addressed by `@ref`:

- `@c0` — the root page/article entry
- `@c1`, `@c2`, ... — entries in depth-first traversal order

Run `cms-edit snapshot` to see current refs.

---

## Field Detail Pages

- `cms-edit help fields-page` — page entry fields
- `cms-edit help fields-article` — article entry fields
- `cms-edit help fields-component` — component entry fields
- `cms-edit help fields-collection` — collection entry fields