Embedded Timeline Parameter Reference
Customize an embedded timeline with data-* attributes added to a fallback anchor element or passed to a JavaScript factory function in an options object.
Parameters
chrome
Remove a display component of a timeline with space-separated tokens.
noheader
- hides the header
nofooter
- hides the footer, if visible
noborders
- removes all borders: around the widget, between Tweets, and inside a Tweet
noscrollbar
- crop and hide the timeline scrollbar, if visible
transparent
- remove background color
Example Values: transparent noborders
tweet-limit
Display an expanded timeline of between 1 and 20 Tweets.
Example Value: 5
aria-polite
Set an assertive ARIA politeness value for widget components and updates.
Example Value: assertive
lang
A supported Twitter language code.
Loads text components in the specified language. Note: does not affect the text of a Tweet displayed inside a timeline.
Example Value: es
theme
When set to dark
, displays Tweet with light text over a dark background.
Example Value: dark
border-color
Set the color of widget component borders, including the border between Tweets, with a hexadecimal color value.
Example Value: #a80000
width
Set the maximum width of the widget between 180 and 520 pixels.
Example Value: 300
height
Set the height of a displayed widget, overriding the value stored with the widget ID. Must be greater than 200 pixels.
Note: the height parameter does not apply when a tweet-limit
parameter is specified
Example Value: 400
Override Parameters
The following parameters override the data source for the specific widget ID.
screen-name
Display Tweets from a Twitter user specified by @username.
Applies to embedded user timelines.
Example Value: TwitterDev
user-id
Display Tweets from a Twitter user specified by ID.
Applies to embedded user timelines.
Example Value: 2244994945
list-owner-screen-name
Display a Twitter list belonging to a Twitter user specified by @username. Must be paired with a specific list provided by list-slug
or list-id
.
Applies to embedded list timelines.
Example Value: TwitterDev
list-owner-id
Display a Twitter list belonging to a Twitter user specified by ID. Must be paired with a specific list provided by list-slug
or list-id
.
Applies to embedded list timelines.
Example Value: 2244994945
list-slug
Display a Twitter list using a short identifier selected by its curator. Must be paired with a list curator provided by list-owner-screen-name
or list-owner-id
.
Applies to embedded list timelines.
Example Value: national-parks
list-id
Display a Twitter list using a unique identifier assigned by Twitter. Must be paired with a list curator provided by list-owner-screen-name
or list-owner-id
.
Applies to embedded list timelines.
Example Value: 207763459
custom-timeline-id
Display a collection of Tweets specified by a collection identifier.
Applies to embedded collection timelines.
Example Value: 539487832448843776
HTML example
<a class="twitter-timeline" data-widget-id="600720083413962752" href="https://twitter.com/TwitterDev" height="400" data-chrome="nofooter" data-link-color="#820bbb" data-border-color="#a80000"> Tweets by @TwitterDev </a>
JavaScript factory example
twttr.widgets.createTimeline( "600720083413962752", document.getElementById("container"), { height: 400, chrome: "nofooter", linkColor: "#820bbb", borderColor: "#a80000" } );