A new improved embedded timeline

By Jacob Harding
Thursday, 25 February 2016

On March 3, we’ll update the embedded timeline to better showcase the stories you tell with Tweets. The new timeline features a clean, modern design which showcases expanded photos, videos, GIFs, and more. It’s fully responsive, and it includes support for several new media types, including polls.

This Tweet is unavailable
This Tweet is unavailable.

The new embedded timeline design on web

As part of this redesign, we are also deprecating the old ‘hide media’ option, so all Tweets with media will be expanded by default. This reduces the number of clicks between your users and your content, and makes it easier for your audience to engage with the Tweets you embed. We’ve also made it easier to share your content by putting the in-line share action front and center on every Tweet.

Starting March 3, you’ll be able to start embedding profiles, lists, collections, and more using the new timeline display. At that time, we’ll automatically upgrade all existing timelines to the new version as well. All of your current sizing and customization preferences will stay the same.

To see what your existing timelines will look like in the new design, simply add

This Tweet is unavailable
This Tweet is unavailable.
<meta name="twitter:widgets:new-embed-design" content="on">

to your page. You can also find out more here.

If you run into any issues, please let us know in our forum or by sending a Tweet to @TwitterDev. We look forward to hearing what you think, and can’t wait to see the stories that you tell with the new embedded timeline.

Update Mar. 3, 2016: As described above, the new embedded timeline design is now available to everyone. All existing timelines have also been upgraded to the new design. We’re looking forward to hearing your feedback and seeing the stories you tell!

This Tweet is unavailable
This Tweet is unavailable.

Jacob Harding


Senior Software Engineer