Embeddable timelines make it easy to display a listing of your latest posts to your website with one line of code.

They allow your visitors to get an overview of your content, follow your blog, and like your content directly from your pages.

Embeddable timelines work for both WordPress.com blogs and self-hosted WordPress sites using Jetpack blogs.

Creating an Embeddable Timeline

The easiest way to create an embeddable timeline is to use our Timeline Creation tool.

If you prefer to code things by hand, you must include a copy of our “platform.js” JavaScript for these embeds (and future embeds) to work correctly.

You can do so by putting

<script type="text/javascript" src="http://widgets.wp.com/platform.js"></script>

in the <head> tags of your page.

Once you are loading “platform.js” you can load your posts with a single line of HTML:

&amp;lt;a class="wordpress-timeline" href="http://en.blog.wordpress.com" data-theme="light" width="400" height="600" lang="en" data-show-gravatars="true"&amp;gt;Recent Posts&amp;lt;/a&amp;gt;

This will show the latest posts for http://en.blog.wordpress.com. There are a couple of options that you can configure to customize the widget:

  • data-theme: Set this to “light” or “dark” to match the color scheme of your site. The default is ‘light’.
  • data-link-color: Allows you to set the link color for content to better match your site.
  • width: Sets the width dimension of your widget. Units are pixels. Default is 300px.
  • height: Sets the height dimension of your widget. Units are pixels. Default is 500px.
  • lang: If the content of your site is in a different language, you can pass a different locale here for some of the interface strings (“Like”, “Follow”, “Following”).
  • data-show-gravatars: Toggle the display of Gravatars (profile images). Useful if you have a multiple users and want to show their profile images, or hide them on single user blogs. Default is off.


&amp;lt;a class="wordpress-timeline" href="http://matt.wordpress.com"&amp;gt;Recent Posts&amp;lt;/a&amp;gt;
Recent Posts on http://matt.wordpress.com
&amp;lt;a class="wordpress-timeline" href="https://wordpress.com/blog/" data-theme="dark" data-show-gravatars="true"&amp;gt;Recent Posts&amp;lt;/a&amp;gt;
Recent Posts on https://wordpress.com/blog/
&amp;lt;a class="wordpress-timeline" href="https://developer.wordpress.com" data-show-gravatars="true" width="600"&amp;gt;Recent Posts&amp;lt;/a&amp;gt;
Recent Posts on https://developer.wordpress.com

18 thoughts on “Embedded Timelines

  1. Hello. I have just started getting this error: {“code”:403,”headers”:[{“name”:”Content-Type”,”value”:”application\/json”}],”body”:{“error”:”authorization_required”,”message”:”An active access token must be used to query information about the current user.”}}
    Any ideas?


Comments are closed.