← All playbooks · Raw API

people

# People — HopSkipDrive

## Routing

| Concept | Value |
|---------|-------|
| People base | `/about/bio` |
| Profile URL | `/about/bio/{slug}/` |
| Markdown | `/about/bio/{slug}.md` |
| Person entries enabled | **Yes** (`enablePerson`) |
| People **index** listing | **Off** (`enablePeopleIndex` / `allowPeople` is false) — no full `/people` directory browse product surface |

Team bios live under **About**, not a separate `/team` or `/people` hub. About page (`/about`) may surface people via collections; individual profiles are person entries.

Read `cms-edit://customer/routing`.

## When to use

- Create or update **person** entries (leadership, authors, spokespeople)  
- Link `authors` on articles  
- Batch import via `task-authors-import` / `person-from-json`  

## Required / common fields

| Field | Notes |
|-------|-------|
| `name` | Display name |
| `slug` | URL segment under `/about/bio/` |
| `jobTitle` | Role (set for public bios) |
| `description` | Short bio / SEO-oriented description |
| `media` | Headshot asset — prefer existing CMS photography style |
| `emailAddress` / `phoneNumber` / `linkedIn` | Optional contact |
| `location` | Optional free-text location string |
| `content` | Optional component/collection/media stack for long-form bio pages |

## Profile guidance

- Warm, professional tone; people-first  
- Do not invent credentials or quotes  
- Headshots: CMS assets only; meaningful alt text on informative images  
- Keep job titles consistent with About / press usage  

## Linking authors to articles

```bash
cms-edit open --article-slug <slug>
cms-edit set @root authors <personId1>,<personId2> --links
cms-edit diff
cms-edit save
```

Prefer the **`authors`** array (ordered). Legacy single `author` is deprecated where dual fields exist.

## Batch import

```bash
cms-edit create person-from-json --file authors.json --dry-run
cms-edit create person-from-json --file authors.json --if-not-exists
```

See `cms-edit help person-from-json` and `cms-edit://customer/task-authors-import`.

## Reference workflow

1. `cms-edit list --type person -n 20` (or Contentful People list)  
2. Open by id; update fields; `diff` → `save`  
3. Preview `/about/bio/{slug}/` on staging  
4. Publish handoff in Contentful UI  

## Out of scope

- CareDriver city pages → `location-pages`  
- Full About marketing page layout → `pages` (clone `/about`)  
- Inventing bios for people not approved by HopSkipDrive  

## Publish handoff

`save` creates drafts only — publish in Contentful UI when ready. See `cms-edit://customer/task-publish-handoff`.