Embed Kerala Holidays on Your Site

Free, self-contained widget. One line of code. No API key. No tracking.

Live Preview

Widget reads today's date and shows real upcoming holidays.

Quick Start

Paste anywhere inside your page's <body>:

<div id="kerala-holidays-widget"></div>
<script src="https://holidayskerala.in/static/widget.js"></script>

Options

Customise with data-* attributes:

data-count 1–20 (default: 5) Number of upcoming holidays to show
data-theme light · dark (default: light) Colour theme
data-lang en · ml (default: en) English or Malayalam names
data-filter all · public · bank · school · festival Show only a specific category
data-compact true · false (default: false) Compact single-line mode

Examples

Bank holidays, dark theme

<div id="kerala-holidays-widget"
     data-filter="bank"
     data-theme="dark"
     data-count="3"></div>
<script src="https://holidayskerala.in/static/widget.js"></script>

Malayalam, compact

<div id="kerala-holidays-widget"
     data-lang="ml"
     data-compact="true"></div>
<script src="https://holidayskerala.in/static/widget.js"></script>

School holidays only

<div id="kerala-holidays-widget"
     data-filter="school"
     data-count="3"></div>
<script src="https://holidayskerala.in/static/widget.js"></script>

Technical Details

  • No external dependencies — pure vanilla JS
  • Holiday data is inline — no API calls, works offline
  • No cookies or tracking — fully private
  • ~8 KB — negligible page weight
  • CSS scoped to #kerala-holidays-widget — won't affect your styles
  • HTTPS — served from Cloudflare CDN

📋 Attribution

  • The widget footer includes a "Powered by holidayskerala.in" link. Please keep it — this sustains the free service.
  • For white-label versions contact us via holidayskerala.in.