# excerpt-of (/catalog/edges/excerpt-of)

Joins a highlight, quote or clip to the one item it was taken from.



## excerpt-of [#excerpt-of]

Says that an item is a highlight, quote or clip taken from another item, such as a quote from a book.

An excerpt is an **Excerpt from** one item, and that item lists its **Excerpts**. An excerpt comes from at most one item, so a second `excerpt-of` edge from it is refused with `400 edge_constraint_violation`. An item can have any number of excerpts. [Edges](/build/edges#edge-types) says when to use it and when another edge type fits.

## In the bin [#in-the-bin]

An excerpt holds its own text, so it stays where it is when the item it came from goes to the bin or is purged. A purge removes the edge.

## In a folder [#in-a-folder]

The excerpt's file writes the edge as an `excerpt-of` line.

## Example [#example]

A highlight taken from a book:

```json
{
  "edge_type": "excerpt-of",
  "from_id": "01a1f139-b223-7383-8088-a3253b3e9009",
  "to_id": "01a1f139-b217-74ef-b7ca-f406c1e2d8a3"
}
```
