# Capability: Edit scalar fields

## Intent phrases

- change a field on a page or article
- update title or description
- set a tracking field

## Requires capabilities

Always available.

## Prerequisites

- Open the target entry: `open --page-slug` or `open --article-slug`
- `snapshot` to find `@ref` IDs

## Steps

1. `cms_edit ["open", "--page-slug", "<slug>"]` (or `--article-slug`)
2. `cms_edit ["snapshot"]`
3. `cms_edit ["read", "@p0", "fieldName"]` — inspect current value
4. `cms_edit ["set", "@p0", "fieldName", "new value"]`
5. `cms_edit ["diff"]` — review all changes
6. `cms_edit ["save"]`

For unrelated entries in one session, use `batch set`:

```
cms_edit ["batch", "set", "<entryId>:description=New meta", "<entryId2>:title=New title"]
cms_edit ["batch", "save"]
```

## Confirmation gates

1. State which entry and field you will change
2. Show `diff` before `save`

## Out of scope

- Publish (human in Contentful UI)
- Rich text fields (use **Edit rich text** capability)

## Related resources

- `cms-edit://customer/routing`
- `cms-edit://customer/components-index`