WP-RelativeDate
Displays relative date alongside with your post/comments actual date.
Use with caution
WP-RelativeDate works, but test it on a staging site before relying on it in 2026. It runs on 100+ sites, is rated 3/5 and was last updated 3 months ago, and scores 54/100 on our health check.
- Small user base (100+ active installs)
- Very few reviews so far
- Needs PHP 8.2 or newer
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where WP-RelativeDate stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| ago | #20 |
| comments | >100 |
| date | >100 |
| relative | #15 |
| time | >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 3 from 2 reviews
About WP-RelativeDate
From the official readme · v2.0.0Description
WP-RelativeDate rewrites your post and comment dates as how long ago they were: ‘Today’, ‘Yesterday’, ‘2 Days Ago’, ‘2 Weeks Ago’, ‘2 Hours Ago’, ‘2 Minutes Ago’, ‘2 Seconds Ago’.
There is nothing to configure and no settings screen. WP-RelativeDate rewrites your post and comment dates as soon as it is activated, and leaves anything more than a month old, or from a previous year, exactly as your theme printed it.
Features
- Post/Comment Date
- Today
- Yesterday
- X days ago
- X weeks ago
- Post/Comment Time
- X seconds ago
- X minutes ago
- X hours ago
Donations
I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.
Usage
You need not do anything. WP-RelativeDate will automatically modify your post/comment date or time display. No text will be added if the post or comment is more than a month old.
Examples
- Post/Comment Date
- Today
- Yesterday
- 10th January 2007 (2 days ago)
- 25th January 2007 (2 weeks ago)
- Post/Comment Time
- 21:10 (2 seconds ago)
- 21:15 (5 minutes ago)
- 22:15 (2 hours ago)
Shortcodes
[relativedate][relativedate date_format="jS F Y" ago_only="false"]
-
[relativetime][relativetime time_format="H:i" ago_only="false"]
ago_only drops the date or time and leaves only the relative phrase. It accepts
true/false,1/0,yes/noandon/off.
Template Tags
relative_post_the_date( $format, $before, $after, $ago_only, $display )— a drop-in replacement forthe_date().$beforeand$aftercarry markup, exactly as they do inthe_date().
Turning It Off For One Template
The plugin has no settings screen. To leave a template’s dates alone, remove the filter before the loop:
remove_filter( 'get_the_date', 'relative_post_date', 999 );
The four callbacks are relative_post_date on get_the_date, relative_post_time on get_the_time, relative_comment_date on get_comment_date and relative_comment_time on get_comment_time, all at priority 999.
Removing the get_the_date filter also covers the_date(), which builds its output by calling get_the_date(). The same goes for the_time(), comment_date() and comment_time().
Installation
- Install and activate the plugin.
That is the whole of it. There is no settings screen and nothing to configure: your post and comment dates are rewritten as soon as the plugin is active, and anything older than a month is left exactly as your theme printed it.
Changelog
Requires WordPress 6.8 and PHP 8.2. Relative dates will start appearing where they never did before. Since 1.20 the plugin hooked the_date() and the_time(), which almost no modern theme calls — every default theme since Twenty Nineteen builds its post meta from get_the_date() instead. The plugin now hooks the getters, so a theme that showed plain dates for years will show "Today" and "3 days ago" the moment you update. To switch it off for one template, see "Turning It Off For One Template" above. If you had turned the plugin off for a template, the line has changed. remove_filter( 'the_date', 'relative_post_date', 999 ) no longer removes anything; use get_the_date, and likewise get_the_time in place of the_time. The two comment filters are unchanged. ago_only="false" now does what it says. Until 2.0.0 the shortcode read the string "false" as true, so [relativedate ago_only="false"] printed only "3 days ago" instead of the date. Change those shortcodes to ago_only="true" if you were relying on it. Markup passed to relative_post_the_date() reaches the page again. Since 1.51.1 the tag escaped its own $before and $after arguments, so a theme passing `` got the literal characters printed. The plugin now stores one row, wp_relativedate_version, and deletes it on uninstall. There is still no settings screen, and no template tag or shortcode changed name.
2.0.0
- BREAKING: Requires WordPress 6.8 and PHP 8.2, up from 6.0 and 7.4.
- BREAKING: The post callbacks moved from
the_date/the_timetoget_the_date/get_the_time. If you opted a template out withremove_filter( 'the_date', 'relative_post_date', 999 ), name the getter instead. - NEW: Restructured into
includes/, with the date and time calculations in aWP_RelativeDate_Coreclass. - NEW: Added the
wp_relativedate_versionrow, and anuninstall.phpthat deletes it on a single site and across a network. - NEW: Added a PHPUnit test suite and GitHub Actions CI.
- CHANGED: The two shortcode callbacks are now methods on the
WP_RelativeDateclass. Shortcodes are removed by tag, soremove_shortcode( 'relativedate' )is unaffected. - FIXED: Post dates now work on any theme using
get_the_date()orget_the_time(), which is every classic theme since Twenty Nineteen. The plugin previously only hookedthe_date()andthe_time(), so it appeared to do nothing on most themes. - FIXED: Comment dates now work on block themes. Core’s Comment Date block passes the comment as an argument and never sets the global the plugin used to read.
- FIXED:
relative_post_the_date()no longer escapes$beforeand$after, which had been rendering<h2>and friends as literal text since 1.51.1. - FIXED:
ago_only="false"now means false. The documented spelling had always been read as true. - FIXED: Post and comment dates no longer raise “Attempt to read property on null” when there is no post or comment in scope, which a recent-comments widget could trigger.
- FIXED: Content dated ahead of the server clock no longer renders “(-300 seconds ago)”.
- FIXED: Removed
load_plugin_textdomain(), which trips_doing_it_wrongon WordPress 6.7 and later.
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best WP-RelativeDate alternatives
All ago plugins →| Rank | Plugin | Active installs |
|---|---|---|
| 1 |
|
10K+ |
FAQ
WP-RelativeDate: quick answers
Straight answers, pulled from live WordPress.org data.
Source: WordPress.org
Is WP-RelativeDate free?
Yes. WP-RelativeDate is free to download and use from the official WordPress.org plugin directory.
Is WP-RelativeDate safe to use in 2026?
WP-RelativeDate works, but test it on a staging site before relying on it in 2026. It runs on 100+ sites, is rated 3/5 and was last updated 3 months ago, and scores 54/100 on our health check.
How many websites use WP-RelativeDate?
WP-RelativeDate is active on 100+ WordPress websites and has been downloaded 43,486 times since it launched in February 2006. It was downloaded 198 times in the last 30 days.
Does WP-RelativeDate work with WordPress 7.1?
WP-RelativeDate is officially tested up to WordPress 7.0.9, while the latest release is 7.1.5. It may still work, but try it on a staging site first.
What PHP version does WP-RelativeDate need?
WP-RelativeDate requires PHP 8.2 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was WP-RelativeDate last updated?
The latest version, 2.0.0, was released on August 9, 2026 (3 months ago).
Who makes WP-RelativeDate?
WP-RelativeDate is developed and maintained by Lester Chan.
What are the best alternatives to WP-RelativeDate?
The most popular alternatives to WP-RelativeDate are Meks Time Ago (10K+ installs).
Powered by PageForge
One template and a spreadsheet. A real page for every search.
PageForge turns each row of a CSV into a WordPress page with its own title, URL, SEO fields and schema, built on the layout you already designed. Free on WordPress.org.
- CSV and XLSX, plus Google Sheets on Professional and Enterprise
- Its own title, URL, SEO fields and schema for every page
- Works with the block editor, Elementor, Divi and Avada
- Free on WordPress.org, no credit card


