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

# webpage Card

# Webpage Cards

A webpage card is a **captured external web page**, stored in the box. The
card's body is the readable markdown rendering of the page; a frozen,
self-contained HTML snapshot lives beside it in the card's attach scope. It is
a snapshot taken at capture time — treat the body as a record of what the page
said, and edit it only to fix capture artifacts, not to rewrite the page.

## Frontmatter

- `source:` — required. The original page URL.
- `captured:` — optional. Full ISO instant of capture; rendered in the
  viewer's local timezone.
- `siteName:` / `byline:` / `excerpt:` — optional capture metadata.
- `frozen:` — optional in-box ref (`attach/page.frozen`) to the frozen
  snapshot of the page, served sandboxed.
- `title:` — optional human label; defaults to the captured page title.

## Body

The readable rendering lives **inline in the .webpage.card body**, after the
frontmatter — plain markdown, like a `doc` card. Don't store it in a separate
`attach/readable.md` file; the card *is* the page.

## Commentary

The boxholder's remarks about the page are **not** in this card. They live in a
separate `.commentary.card` inside this card's attach scope
(`<basename>.attach/`), and the webpage view surfaces them inline. A
commentary anchor (`{% source %}`) with no `ref`/`href` points at *this*
page — the containing document is the default target.

## Layout on disk

```
_content/inbox/My_Page.webpage.card          # readable body + provenance
_content/inbox/My_Page.attach/page.frozen    # frozen snapshot
_content/inbox/My_Page.attach/My_Page.commentary.card   # remarks (optional)
```

## 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.