Use <Tweet> to embed a post from X (formerly Twitter) in your documentation. Pass the numeric tweet ID from the post URL; the component loads Twitter's embed script and renders the official widget.
<Tweet id="1513662173796605958" />Copy the numeric ID from the end of the post URL. For example, https://x.com/docsdotpage/status/1513662173796605958 has ID 1513662173796605958.
<Tweet id="1513662173796605958" />By default, link preview cards inside the tweet are hidden. Set cards to show them.
<Tweet id="1513662173796605958" cards />By default, thread context is not shown. Set conversation to include replies in the embed.
<Tweet id="1513662173796605958" conversation />You can enable both options on the same embed.
<Tweet id="1513662173796605958" cards conversation />The numeric ID of the post to embed. This is the number at the end of the post URL, for example 1513662173796605958 from https://x.com/docsdotpage/status/1513662173796605958.
<Tweet id="1513662173796605958" />Controls whether link preview cards inside the tweet are shown.
- omitted or
false: cards hidden (default)cardsorcards={true}: cards visible
<Tweet id="1513662173796605958" cards />Controls whether thread replies are included in the embed.
- omitted or
false: no thread context (default)conversationorconversation={true}: conversation shown
<Tweet id="1513662173796605958" conversation />| Condition | Result |
|---|---|
id omitted or empty | Renders an empty <div> |
| Embed script not yet loaded | Renders an empty <div> until widgets.js is ready |
Script loaded and id set | Creates the tweet widget inside a centered container |
| Site theme is dark | Widget uses Twitter's dark theme |
| Site theme is light | Widget uses Twitter's light theme |
The component loads https://platform.twitter.com/widgets.js once per page. While the script is loading, or when id is missing, nothing visible is rendered; readers see a brief empty area until the embed appears.
Embeds are created with Do Not Track (dnt: true) enabled. Twitter receives less tracking data for embedded posts than it would with DNT disabled.
Embedded tweets load content and scripts from X's servers. Readers who block third-party scripts or cookies may see an empty area instead of the tweet. Consider your audience and any privacy policies that apply when embedding social content.
- Components overview: when to use embeds, callouts, and media components