← All playbooks · Raw API

articles

# Articles — OM1


## Source packages (briefs, Drive, assets)

Before creating from an external brief or asset pack:

1. Follow **`task-source-readiness-review`** (inventory → beat sheet → GO / GO-WITH-GAPS / NO-GO → light human yes).
2. Map structure **faithfully** to this site's components — **do not rewrite source copy**.
3. Do not invent pair layouts or section titles absent from the source.
4. Prefer source order; use labeled placeholders when the verdict is GO-WITH-GAPS.

Routing and shared rules for **resource articles** under `/resources/`. Use specialized playbooks for create/edit workflows:

| Article family | Playbook |
|----------------|----------|
| Standard articles (topic in URL) | `cms-edit://customer/resource-article-pages` |
| Ebooks (no topic segment) | `cms-edit://customer/ebook-pages` |
| Events & webinars | `cms-edit://customer/events-webinars-pages` |

## Article types

Common article type slugs (verify with `cms-edit list --type articleType` after `index sync`):

| Article type slug | Use for |
|-------------------|---------|
| `case-studies` | Customer / evidence case studies |
| `blogs` | Blog posts and thought leadership |
| `publications` | Peer-reviewed and scientific publications |
| `whitepapers` | Downloadable whitepapers |
| `webinars-and-videos` | Webinar recordings and video content |
| `news-and-articles` | Press and news items |
| `podcasts` | Podcast episodes |
| `events` | Conference and event coverage |
| `ebooks` | Gated ebooks — **topicless URL** (see `ebook-pages`) |
| `books` | Multi-chapter books — special template (engineering-led) |

```bash
cms-edit list --type articleType
cms-edit index sync
```

## URL shape

Articles use **primary tag in the path** (`enablePrimaryTagPartOfSlug` is on), except ebooks:

```
/resources/{articleTypeSlug}/{primaryTopic}/{slug}/
```

**Ebooks omit the topic segment:**

```
/resources/ebooks/{slug}/
```

Examples:

- `/resources/case-studies/ai/bringing-treatment-resistant-depression-to-light-ai-driven-patient-discovery-in-real-world-data/`
- `/resources/blogs/registries/fda-draft-guidance-signals-a-new-era-for-post-approval-data-in-cell-gene-therapy/`
- `/resources/ebooks/{slug}/` — no topic segment

Tag-only listing URLs also exist: `/resources/{type}/{tag}/` and `/topics/{tag}/`.

## Primary tag rules

- Pick the **primary tag** that matches the listing URL editors expect
- When an article has no tags, the site uses default topic **`other`**
- Use `cms-edit list --type tag` after `index sync` to resolve tag IDs

## Shared article fields

| Field | Notes |
|-------|-------|
| `articleType` | Required — link to correct article type entry |
| `title` | Headline |
| `slug` | URL segment (lowercase, hyphenated) |
| `date` | Publication date |
| `description` | Meta description |
| `authors` | Ordered array of Person links — prefer over legacy `author` |
| `tags` | Topic filters (AI, registries, therapeutic areas, etc.) |
| `subtitle` | Display line below title where used |
| `summary` | RTF teaser / abstract |
| `content` | Article body components — see specialized playbooks |
| `featuredImage` | Hero / OG image |
| `externalLink` | Optional outbound link (webinars, publications) |

## Listing and discovery

```bash
cms-edit list --type article --sort date -n 20
cms-edit open --article-slug <slug>
cms-edit peek --article-slug <slug>
```

Fetch markdown: append `.md` to the public HTML path.

## Site default featured image

When no custom OG image: `featuredImageAssetId` in `project.json` (`6e4QB9rsOIMpotLdKcooXl`). Resolve after `index sync`.

## Publish handoff

`save` creates drafts only — publish in Contentful UI when ready.