← All playbooks · Raw API

pages

# Pages — Highlander Health

General playbook for **marketing pages** (not resource articles or person profiles). Use specialized playbooks when the page type is known:

| Page type | Playbook |
|-----------|----------|
| Institute or Partners landing | `cms-edit://customer/institute-partners-pages` |
| Resource article | `cms-edit://customer/articles` |
| Person profile | `cms-edit://customer/people` |
| Legal / policy | `cms-edit://customer/legal-policy-pages` |

## When to use

- New or updated pages under `/`, `/about-us/`, `/highlander-health-institute/`, `/highlander-health-partners/`, `/resources/`
- Cloning structure from an existing page before tailoring copy

Read `cms-edit://customer/routing` and `cms-edit://customer/production-site` before editing. Fetch live markdown with `.md` appended to the public path (e.g. `https://www.highlanderhealth.com/about-us.md`). Until DNS cutover, staging is `https://highlander.localhost` and Vercel `develop`.

**Homepage:** CMS slug is **`index`** (public URL `/`). Open with `cms-edit open /` or `--page-slug /index`.

## Templates

```bash
cms-edit list --type template
```

Inspect with `cms-edit peek --page-slug /about-us`. Template supplies nav + footer — page body goes in `content`.

## Reference pages (clone sources)

| Public path | Category | Notes |
|-------------|----------|-------|
| `/` | Home | **Hero** (scrub video), **Large links**, **Articles** / **Related resources** |
| `/about-us/` | About | **Hero**, **Unnamed 1**, **Large links**, **Related resources** (See more) |
| `/highlander-health-institute/` | Institute | See `institute-partners-pages` |
| `/highlander-health-partners/` | Partners | See `institute-partners-pages` |
| `/resources/` | Resources hub | **Resources hero** / halfs variants, **Articles** listing |
| `/terms-of-use/` | Legal | See `legal-policy-pages` |
| `/privacy-policy/` | Legal | See `legal-policy-pages` |

Use `cms-edit://customer/task-clone-page` when the new page should mirror an existing layout.

```bash
cms-edit peek --page-slug /
cms-edit peek --page-slug /about-us
```

## Document section → component mapping

Map brief sections to **registered** types (see `components-index` / `collections-index`):

| Brief section | Component / collection | Notes |
|---------------|------------------------|-------|
| Full-bleed collapsing video hero | **Hero** | Home / About |
| Institute branded hero | **Institute hero** | Institute landing |
| Partners branded hero | **Partners hero** | Partners landing |
| Resources listing hero | **Resources hero**, **Halfs resources hero**, **2 section resources hero**, **3 section resources hero** | Resources hub |
| Intro band | **Text Intro** | Optional 8px visual slice from own `visual` or page video |
| Split image + copy | **Image and Text** / **Text and Image** | |
| Callout | **Callout** | |
| Body copy | **Rich text**, **Indented Rich Text**, **Q&A Rich text** | Legal pages: own visual only — no page-video colour strip |
| Article body | **Article Rich Text** | Resource articles |
| Title-only legal hero | **Text hero** | Do not attach page loop video as a slice |
| Two-up cards | **Link card**, **Large links** | Institute / Partners teases |
| Leadership | **Team** collection | |
| Columns / stats | **Columns** | |
| Resource listing | **Articles** collection | |
| Related resources + See more | **Related resources** | Cards from tags + fill; `links` for See more |
| Fallback | **Generic**, **Unnamed 1**, **Border Left**, **404** | |

Prefer **reusing existing component entries** when copy is unchanged.

## Creating pages

1. Read `cms-edit://customer/tasks-index` → `task-create-page` or `task-create-from-document`
2. `cms-edit index sync` if templates or assets may be stale
3. Pick the matching template; set `slug`, `title`, `description`, `featuredImage`
4. Build content stack with `add` + `set` / `rtf`
5. After each `add`, set `heading` then `cmsLabel`
6. `diff` → `save` (draft only)
7. `preview urls` → `task-preview-verify` → `task-publish-handoff`

Do not publish from cms-edit. Handoff is draft-only.

## Quality checks

- Homepage slug remains `index`
- No OM1 types (Pardot, masked-hero, split-content)
- Legal pages: **Text hero** + indented body; no page-video strip under the title
- Featured image set for social