Embedded Post parameter reference

An embedded Post supports customization in data- attributes and JavaScript factory functions. This reference document describes parameters used in all.

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

Parameter	Description	Example
id	The numerical ID of the desired Post.	20
cards	When set to hidden, links in a Post are not expanded to photo, video, or link previews.	hidden
conversation	When set to none, only the cited Post will be displayed even if it is in reply to another Post.	none
theme	When set to dark, displays Post with light text over a dark background.	dark
width	The maximum width of the rendered Post in whole pixels. This value should be between 250 and 550 pixels.	325
align	Float the Post left, right, or center relative to its container. Typically set to allow text or other content to wrap around the Post.	right
lang	A supported X language code. Loads text components in the specified language. Note: does not affect the text of the cited Post.	es
dnt	When 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.