> ## Documentation Index
> Fetch the complete documentation index at: /llms.txt
> Use this file to discover all available pages before exploring further.
# Chat Thread
> The measured conversation as one mountable scene at full fidelity: status bar, back badge, avatar and name pill, bubbles with real iMessage tails, a Delivered receipt, large emoji rows, a media placeholder, a link card, and typing dots holding the beat. Every message picks its type by prefix - recv:/sent: text, emoji: a large row, img media, card:Title~domain a link card - and heights are measured at mount so any thread fits
# Chat Thread
The measured conversation as one mountable scene at full fidelity: status bar, back badge, avatar and name pill, bubbles with real iMessage tails, a Delivered receipt, large emoji rows, a media placeholder, a link card, and typing dots holding the beat. Every message picks its type by prefix - recv:/sent: text, emoji: a large row, img media, card:Title\~domain a link card - and heights are measured at mount so any thread fits
**Chat Thread**
```html chat-thread.html theme={null}
Chat Thread
9:41
12
R
Rachel›
+
Message
```
Copy npx hyperframes add chat-thread to the clipboard
That writes one file: `compositions/components/chat-thread.html`.
## Paste it into your composition
Open `compositions/components/chat-thread.html` and copy what is inside into your own composition.
A component has no size or duration of its own. It takes both from the composition
you paste it into.
## Variables
Every one of these has a default, so the piece works untouched. Set the ones you
want to change on the element:
| Variable | Default | Accepts | What it does | | | | | | | | |
| - | - | - | - | - | - | - | - | - | - | - | - |
| `contact` | `Rachel` | string | Name in the thread header; the avatar shows its first letter. | | | | | | | | |
| `unread` | `12` | 0 to 99, step 1 | Count in the back-button badge. 0 hides it. | | | | | | | | |
| `messages` | \`recv:what r u using for the launch video?? | sent:wait look 👀 | card:HyperFrames — Write HTML, render pixel-perfect video\~hyperframes.heygen.com | recv:OMG IT'S HTML | emoji:🤯🤯🤯 | sent:renders in 4K. no editor\` | string | Pipe-separated thread. Each entry picks its type by prefix: recv: or sent: for a text bubble, emoji: for a large emoji row, img for a media placeholder, card:Title\~domain for a link card. Example: recv:hey | sent:look 👀 | card:HyperFrames\~hyperframes.heygen.com | emoji:🤯🤯🤯 |
| `beat` | `1.7` | 0.8 to 3, step 0.1 | Seconds between message arrivals. | | | | | | | | |
| `dots` | `on` | `on`, `off` | Show the three-dot indicator before received messages. | | | | | | | | |
| `receipt` | `on` | `on`, `off` | Show Delivered under the last sent bubble, as iMessage does. | | | | | | | | |
Set them with `data-variable-values` on the element that mounts it. These are the
defaults, so this behaves exactly like the preview above until you change one:
```html wrap theme={null}
```
Tagged `motion-primitive` `chat` `mock-ui` `conversation` `vertical`.
Created by Miao Yang.
## Related topics
* [Browse the complete Catalog](/catalog.md)
* [Add assets and Catalog items in the browser editor](/studio/assets-and-blocks.md)
* [Put blocks together into one video](/concepts/compositions.md)
## Related topics
- [Chat Message](/catalog/components/chat-message.md)
- [Message Thread Reveal](/catalog/blocks/message-thread-reveal.md)
- [Typing Indicator](/catalog/components/typing-indicator.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.