Embedded Tweet parameter reference

An Embedded Tweet 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 Tweet ID or URL.

Parameters

id required

The numerical ID of the desired Tweet.

Example Values: 20

cards optional

When set to hidden, links in a Tweet are not expanded to photo, video, or link previews.

Example Value: hidden

conversation optional

When set to none, only the cited Tweet will be displayed even if it is in reply to another Tweet.

Example Value: none

lang optional

A supported Twitter language code.

Loads text components in the specified language. Note: does not affect the text of the cited Tweet.

Example Value: es

dnt optional

When set to true, the Tweet and its embedded page do not influence Twitter targeting including suggested accounts.

Example Value: true

theme optional

When set to dark, displays Tweet with light text over a dark background.

Example Value: dark

width optional

The maximum width of the rendered Tweet in whole pixels. This value should be between 250 and 550 pixels.

Example Value: 325

align optional

Float the Tweet left, right, or center relative to its container. Typically set to allow text or other content to wrap around the Tweet.

Example Value: right

HTML example

<blockquote class="twitter-tweet"
  data-link-color="#55acee" lang="es">
<p lang="en">just setting up my twttr</p>
— Jack Dorsey (@jack)
<a href="https://twitter.com/jack/status/20">
  marzo 21, 2006
</a>
</blockquote>

JavaScript factory example

Note: the numeric Tweet ID should be passed as a string.

twttr.widgets.createTweet(
  "20",
  document.getElementById("tweet-container"),
  {
    linkColor: "#55acee"
  }
);