defaults

# Site defaults

Rules for featured images, article types, and when to use Contentful UI vs Claude.

## Contentful UI — publish only

Marketing editors should use **Claude + cms-edit** for copy, structure, and assets.
Open Contentful only to **publish** approved drafts (cms-edit cannot publish).

**Assets:** search and reuse existing files first (`asset search`, `index sync`).
Upload via cms-edit when no match (`asset upload --if-exists-by-filename`).

Do not edit page or article copy directly in Contentful.

## Article types (required)

Every article must link to an **articleType** entry. Before creating an article:

1. Run `cms-edit index sync` (if the catalog may be stale)
2. Run `cms-edit list --type articleType` — pick the correct type by name or slug
3. Use `--article-type-slug` or `articleTypeSlug` in JSON (preferred for marketers)

## Featured images — decision tree

When creating or updating an article:

1. **News articles** — a “custom image” means a **source CMS asset** for composites (`task-news-images`). Do **not** link the raw source as `featuredImage` alone. Curated title→stock tables are **not** product core.
2. **Non-news custom image** — set `featuredImage` or `featuredImageAssetFilename` when the marketer provides a specific image
3. **Article type default** — if omitted, cms-edit inherits the linked **articleType** `featuredImage`
4. **Site default** — if the article type has no image, use the site default below

When the site articles playbook requires both `featuredImage` and `visuals`, set **each field explicitly** on the article (use the site default asset ID for `featuredImage` when no custom OG image is provided).

`featuredImage` used for OpenGraph / social sharing should be **landscape** (wider than tall) for correct card cropping.

Read `cms-edit://customer/articles` for `visuals` defaults and which components belong in article `content` vs the article type template.

## Site default featured image

- **Asset ID:** `6vN4Yu2yEKYUhe8xId6xmP`

## Pages

Page `featuredImage` is optional (social sharing). No automatic fallback.