Skip to content

How to Add a WordPress Timeline?

Key Takeaways

  • Nexter Blocks Pro requires the Timeline block, and it is enabled under Nexter > Blocks in the WordPress dashboard.
  • Timeline events each take a date, a heading, and a description, and each event also sets its own side plus a pin icon or image.
  • Style 2 adds arrow styling, while Masonry layout switches the timeline to an isotope grid rather than a fixed column.
  • Custom HTML / Iframe Code renders as visible text, so an iframe appears as the literal tag; patterns work only when AJAX Base is off.
Table of Contents

A history, a roadmap or a process is a sequence, and a plain list flattens it — every step looks equally far from the one before.

A timeline keeps the order visible: events down a spine, alternating left and right, each with its own date, heading and content.

Before You Start

  • Edition: Pro — the Timeline block needs Nexter Blocks Pro.
  • Block to enable: Timeline, switched on under Nexter > Blocks in your WordPress dashboard.

Video Tutorial

Youtube video

Steps

  1. Add the Timeline block to your page.
Enabling the Timeline block in Nexter > Blocks
  1. Pick a Style and, on style 2, an arrow style.
The timeline style options
  1. Add your events. Each one takes a date, a heading and a description.
The event list settings
  1. For each event choose which side it sits on, and set its pin icon or image.
Pin and side settings for an event
  1. Choose what fills each event’s media area — an image, custom HTML, or a pattern.

Each event has two content settings and they are easy to mix up: Content Type controls the text side, while the media type setting controls what fills the media area — an image, custom HTML, or a pattern.

How It Behaves

SettingMeasured on a published page
Style 1 / Style 2Both render the events down a central spine; style 2 adds the arrow styling. Each event’s side is set per event, so you can alternate them or group them.
Masonry layoutSwitches the timeline to an isotope grid rather than a fixed column — measured, the wrapper gains the masonry layout attributes.
Pin StyleChanges the marker on the spine — measured rendering the chosen style class.
Media areaImage, Custom HTML/Iframe Code, or a pattern. Images and patterns both render correctly — measured.
  • Each event is its own row in the event list, so events can be reordered without touching their content.
  • The button needs its own toggle as well as its text. Measured: setting a URL and label alone rendered no button at all — the event’s Button toggle has to be on too. See the button doc.
  • Patterns let an event hold a full block layout rather than a single image — see using a pattern in a timeline.

Limitations

  • Custom HTML / Iframe Code is currently rendered as visible text, not as markup. Measured on a published page: an iframe pasted into that field appears on the page as the literal tag rather than an embedded frame. Until this is fixed, embed video and maps with the block made for them, or with a pattern. This is a known bug and has been reported to the development team.
  • Do not switch AJAX Base on. Measured on a published page: with AJAX Base enabled the event renders an empty container and the pattern never appears, because the loader script it depends on is never added to the page. Leave it off and the pattern renders normally. This is a known plugin-wide bug and has been reported to the development team.
  • The two content settings are separate — changing the media type does not change the text side, and vice versa.
  • A timeline is one vertical sequence; it does not branch or nest.

Troubleshooting

My iframe shows as text on the page

That is the known bug described above — measured, the field’s HTML is printed rather than rendered. Use a pattern, or the block built for that media type, until it is fixed.

My pattern event is empty

Switch AJAX Base off for that event. Measured: with it on, the event renders an empty container and the pattern never loads.

My button is not showing

The button needs its own toggle as well as its text. Measured: setting a URL and label alone rendered no button at all — the event’s Button toggle has to be on too.

The events are all on one side

Each event carries its own side setting rather than alternating automatically. Set them one by one if you want them to zig-zag.

Related Docs

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Related Frequently Asked Questions

What do I need before adding a WordPress timeline in Nexter Blocks?

The Timeline block is part of Nexter Blocks Pro, and the block has to be enabled under Nexter > Blocks in the WordPress dashboard. That matters because the tutorial is not about a generic timeline widget, it is about a specific Pro block that must be switched on first. If the block is missing, the usual cause is that Pro is not active or the Timeline block is still disabled in the blocks panel.

How do I make a WordPress timeline alternate left and right instead of staying on one side?

Each event has its own side setting, so the timeline does not auto-alternate by itself. That means zig-zag layouts are manual per event, while grouped layouts are also possible if you want several events on the same side. This is useful when you want to control visual rhythm rather than accept a fixed pattern.

Why does my timeline button not show up even though I added text and a URL?

The button needs its own toggle turned on, not just a label and link. In measured testing, setting a URL and label alone rendered no button at all. That makes this an easy miss when building events, because the button content and the button visibility are separate settings. The related guide is Add a button.

Why is my iframe showing as plain text in the WordPress timeline?

Custom HTML / Iframe Code is currently rendered as visible text instead of markup. In measured testing, an iframe pasted into that field appeared on the page as the literal tag rather than an embedded frame. Until that bug is fixed, use a pattern or the block made for that media type instead. The related guide is Custom HTML content.

What should I use for media in a timeline event: image, custom HTML, or pattern?

The media area can hold an image, Custom HTML / Iframe Code, or a pattern, but patterns are the safest choice when you need more than a single asset. A pattern lets an event hold a full block layout rather than just one image. That matters because the page also notes that images and patterns render correctly, while iframe code has a known rendering bug.

Why does my timeline pattern event stay empty after I add it?

AJAX Base should stay off for that event. Measured on a published page, enabling AJAX Base caused the event to render as an empty container because the loader script for the pattern was never added to the page. Leaving it off lets the pattern render normally. The related guide is Use a pattern.

Last reviewed: September 27, 2026

Related Docs