← All playbooks · Raw API

task-featured-images

# Capability: Featured images

## Intent phrases

- set featured image
- social sharing image
- OG image for article

## Requires capabilities

`pages` or `articles`

## Prerequisites

- Read `cms-edit://customer/defaults` for article inheritance rules
- **Reuse-first:** `task-media-reuse-and-upload`

## Steps

**Articles — decision tree:**

1. Custom image on article when editor provides one
2. Else inherit from linked **articleType** featured image
3. Else site default from `editor.defaults`

**Pages:** **required** for new pages (reuse-first). No automatic fallback — set explicitly or via from-json.

```
cms_edit ["set", "@p0", "featuredImage", "<assetId>", "--links"]
```

Or in from-json: `featuredImageAssetFilename` after `index sync`.

## Confirmation gates

1. Confirm image choice (custom vs inherited)
2. `diff` before `save`

## Out of scope

- Publish

## Related resources

- `cms-edit://customer/defaults`
- `task-media-reuse-and-upload`