← All playbooks · Raw API

news-images

# News images — Headwater Science

Branded **portrait** (grid/hero) and **landscape** (OG/social) composites for `resources/news` articles.

## Field mapping

| Output | CMS field | Aspect | Use |
|--------|-----------|--------|-----|
| Portrait composite | `visuals[0]` (Media entry) | 320:427 (960×1281 uploaded) | News grid, article hero |
| Landscape composite | `featuredImage` (Asset) | 1200×630 | Open Graph / social share |

Always set **both**. Image assets use composite names (`News composite — …`), not article titles.

## Composite reuse

Same source + treatments + colour → **one portrait asset, one landscape asset, and one Media entry** (`visuals[0]`) shared across all matching articles. Search assets for `News composite —` before uploading. **Never create a new Media entry per article** when the composite already exists.

## Hosted MCP workflow

Read `cms-edit://customer/task-media-reuse-and-upload` for staged upload. Summary:

1. `index sync` → search `News composite —` assets
2. `list --type media --asset-id <portraitAssetId>` → reuse **one** media entry ID for `visuals[0]`
3. Link same media entry + landscape asset to each article (`set @root visuals <mediaId> --links`, `asset set @root featuredImage <assetId>`)
4. Upload + `create media` **once per composite**, not per article; never use `--with-media` per article

## News Image Studio

Dev/preview: `/cms/news-images`

1. Select article
2. Review suggestion (abstract source photos only)
3. Adjust treatments / colour / source
4. Apply (reuses existing composite when matched) or **Replace existing images**

## Style and logos

- **Photo** — default for most news
- **Logo** — conference/partner when logo ≥ 400px wide; low-res logos fall back to photo style

## Source photos

Abstract-only auto-pool (`ABSTRACT_FILENAMES`). Curated overrides: `content/headwater-website/news-image-matching.md`.

## Defaults (placeholder only)

Until composites are applied: `visuals` default media `7Gjr8l44cfJBVaVUqlNRkm`, `featuredImage` `1AnckDjqLhoUCca15RKh52` — replace via studio for production articles.

## Related

- `cms-edit://customer/news-pages`
- `cms-edit://customer/articles`