Vedic Calendar: the KaliYuga date under every blog post

Long before July and August were named after Roman rulers, the astronomers of Vedic India were following the Sun through twelve signs of the sky. That way of keeping time never stopped. By its traditional count, the KaliYuga began in 3102 BCE, and the year that started this April is KaliYuga 5127.

Today we’re releasing Vedic Calendar, a small, free WordPress plugin that brings that calendar to your blog. It leaves your theme’s date exactly where it is and adds the same day in the Vedic calendar just below it:

November 3, 2026
Tula 17, KaliYuga 5127

It’s for anyone whose readers care where ideas come from: yoga teachers, Ayurveda practitioners, Sanskrit students, astrologers, temples and cultural centres, and families keeping traditions alive far from India. Every post becomes a small reminder that the way we count time has a much older story.

What the second line tells you

• The month is a solar month, named in Sanskrit after the sign of the zodiac the Sun is passing through: Mesha (Aries), Vrishabha (Taurus), Mithuna (Gemini), Karkataka (Cancer), Simha (Leo), Kanya (Virgo), Tula (Libra), Vrishchika (Scorpio), Dhanu (Sagittarius), Makara (Capricorn), Kumbha (Aquarius) and Meena (Pisces).
• The day is the day of that solar month.
• The year is the KaliYuga year. It turns at Mesha Sankranti in mid-April, the solar new year that much of South and Southeast Asia still celebrates, from Vaisakhi and Vishu in India to Songkran in Thailand.

One thing surprises readers who know Western astrology: these signs are measured against the stars, not the seasons. Over the centuries the two have drifted about 24 degrees apart, so the Vedic Mesha begins in mid-April rather than in March.

How the date is worked out

A solar month begins at the moment the Sun moves into the next sign. That moment is called the sankranti. The plugin works out where the Sun is using the VSOP87 planetary theory, the same mathematics astronomers use, together with the Lahiri ayanamsa, the standard of India’s national ephemeris.

Then it decides which day the month starts, using a rule from India’s traditional solar almanacs. Take the daytime, from sunrise to sunset, and cut it into five equal parts. If the sankranti falls in the first three, the month starts that same day. If it falls later, the month starts the next day.

Everything happens on your own server. Nothing is sent anywhere, and nothing about your visitors is collected.

How accurate it is

We didn’t want anyone to take this on faith. So we checked all 2,409 month starts between 1900 and 2100 against Swiss Ephemeris, a widely trusted astronomical reference. Every single one lands on the same day. The plugin also matches a published Indian solar calendar for 2024 and 2025.

Printed almanacs that use a different ayanamsa, or a different rule for the first day, can disagree by a day when the Sun changes sign close to the cut-off.

Get it

1. Download vedic-calendar.zip.
2. In WordPress, go to Plugins → Add New → Upload Plugin, pick the zip, then click Install and Activate.
3. That’s it. The Vedic date now shows under the dates on your posts and pages.

You can choose which post types show it, and how the line is worded, under Settings → Vedic Calendar. The month names can be translated like any other WordPress text. If you’d like the date somewhere else on a page, the [vedic_date] shortcode puts it there.

It works with both block and classic themes on WordPress 5.9 or later. It’s free and open source under the GPL, and the code is on GitHub. We’ve also sent it to the WordPress.org plugin directory, where it’s waiting for review.

If your blog celebrates yoga, Sanskrit, Indian philosophy, or simply the long story of how people have measured time, give it a try. We’d love to hear what you’d like it to show next.