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. **Custom image** — set `featuredImage` or `featuredImageAssetFilename` on the article when the marketer provides a specific image
2. **Article type default** — if omitted, cms-edit inherits the linked **articleType** `featuredImage`
3. **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:** `6CljbZ9NpKWIwx9e61vFFC`

## Pages

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