# Design Annotation

> A short note on a design. It says what the picture cannot, like how a part works.

**Field:** Design  
**Category:** Product Development  
**Also known as:** Annotations, Design Notes, Annotated Wireframe

## Think of it like

It is like sticky notes on a map. They say watch out here, or turn left at the tree.

## Definition

A design annotation is a short note placed on a design to explain what the picture alone cannot. It might say what a button does, where data comes from or why a choice was made. Notes are usually numbered and linked to the spot they describe. They help builders, testers and reviewers who were not in the design meetings. Good notes cover behavior and edge cases, not what is plain to see.

## Example

On Ben's wireframe, note 3 points at the search box: shows results after 3 letters, newest first.

## Why it matters

A picture shows how a screen looks, not how it works. Notes carry the thinking to people who were not in the room.

## Common mistake

Annotating the obvious, like this is a button. Spend notes on behavior, rules and odd cases.

## Three principles

- **Explain the unseen.** Behavior, data, reasons.
- **Numbered and pinned.** Linked to the spot.
- **Skip the obvious.** Notes are for the hard parts.

## Related terms

- [Design Spec](https://learn.benibix.com/term/design/design-spec)
- [Wireframe](https://learn.benibix.com/term/design/wireframe)
- [Design Handoff](https://learn.benibix.com/term/design/design-handoff)
- [Design Review](https://learn.benibix.com/term/design/design-review)

![A row of steps from left to right: design, review, sign-off, spec, build. A dashed arrow from review loops back to design. The spec box holds a small screen with sizes marked in red lines.](https://learn.benibix.com/diagrams/design-review-flow.svg)

---

Source: https://learn.benibix.com/term/design/design-annotation
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
