Skip to main content
An embedded Post supports customization in data-* attributes and JavaScript factory functions. This reference document describes parameters used in all formats. Reference the oEmbed API to set these parameters as part of an HTML response for a Post ID or URL.

​
Parameters

ParameterDescriptionExample
idThe numerical ID of the desired Post.20
cardsWhen set to hidden, links in a Post are not expanded to photo, video, or link previews.hidden
conversationWhen set to none, only the cited Post will be displayed even if it is in reply to another Post.none
themeWhen set to dark, displays Post with light text over a dark background.dark
widthThe maximum width of the rendered Post in whole pixels. This value should be between 250 and 550 pixels.325
alignFloat the Post left, right, or center relative to its container. Typically set to allow text or other content to wrap around the Post.right
langA supported X language code. Loads text components in the specified language. Note: does not affect the text of the cited Post.es
dntWhen set to true, the Post and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads.true

​
HTML example

<blockquote class="twitter-tweet" data-lang="en">
  <p lang="en" dir="ltr">just setting up my twttr</p>&mdash; Jack (@jack) <a href="https://x.com/jack/status/20">March 21, 2006</a>
</blockquote>

​
JavaScript factory example

twttr.widgets.createTweet(
  "20",
  document.getElementById("tweet-container"),
  {
    theme: "dark"
  }
);
The numeric Post ID should be passed as a string.