`news`

A published story worth surfacing: headline, one line of context, a link out.

A news headline with optional standfirst and link.

A rendered news pane (news-v1) — news-v1

Fields in `data`

The envelope around data (publisher, label, expiresAt…) is the same on every type: see the envelope.

Field	Type		Notes
`variant`	`"v1"`	optional	Design variant to render (defaults to v1).
`headline`	`string`	required	1–240 chars
`standfirst`	`string`	optional	up to 400 chars
`read`	`string`	optional	up to 40 chars
`url`	`string`	optional	format: uri

Craft

Keep headline to 6–14 words. It's set at display size, and long headlines wrap into a wall.
standfirst is exactly one sentence saying why this matters — the fact the headline left out, not a re-statement of it.
Write the headline as the outlet would, in the present tense, without a trailing period.
publisher is the outlet ("Bloomberg", "The Verge"); label is the section or reason ("Markets", "Because you follow Rivian").
read is a formatted display string: "3 min read".
Include url whenever one exists — a news card the user can't open is a dead end.

Avoid

Don't editorialize in headline or add your own framing ("Interesting: …") — publish it the way the source wrote it.
Don't paste the article's opening paragraph into standfirst; write the one line that earns the tap.
Don't use news for your own summaries or updates — that's a quote, list, or kpi depending on shape.

Examples

Complete payloads for POST /api/v1/feed/items or the MCP publish_pane tool.

A market-moving story for someone who follows finance

{
  "type": "news",
  "publisher": "Bloomberg",
  "publisherInit": "B",
  "publisherColor": "#000000",
  "label": "Markets",
  "data": {
    "headline": "Fed signals two cuts before year-end as core inflation eases",
    "standfirst": "Powell told a Senate panel the path is now \"clearly disinflationary,\" opening the door to a September cut.",
    "read": "3 min read",
    "url": "https://www.bloomberg.com/news/example"
  }
}

Industry news matched to something the user tracks

{
  "type": "news",
  "publisher": "The Verge",
  "publisherInit": "V",
  "publisherColor": "#FA4B2A",
  "label": "Because you follow Figma",
  "data": {
    "headline": "Figma opens its design-system API to third-party tools",
    "standfirst": "Teams can now sync tokens and components into their own pipelines without exporting a file.",
    "read": "4 min read",
    "url": "https://www.theverge.com/example"
  }
}

news