Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# feedback Card

# Feedback Cards

Feedback cards capture user responses inside the box.

Frontmatter:
- `type-of-feedback:` — `query-response`, `comment`, or `brief`.
- `target:` — `{ref}` pointing at the target element. The ref uses
  the `path#fragment` form, e.g.
  `/_content/briefings/2026-02-01.briefing.card#q1`.
- `source:` — `text` or `voice`.
- `timestamp:` — when the feedback was submitted.
- `transcription:` — populated by the transcribe pre-action for
  voice feedback. `{text, language?, transcribed-at?}`.
- `transcription-error:` — set if transcription failed.

Body (markdown): the user's typed text. For voice feedback the body
may be empty; `transcription.text` is the source of truth.

## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.