Category Archives: Developers, APIs, RSS Feeds, Source Code

Hebcal.com offers a REST API for fetching Jewish calendar data. The output format is in JSON.

The basic URL format is as follows:

https://www.hebcal.com/hebcal?v=1&cfg=json&maj=on&min=on&mod=on&nx=on&year=now&month=x&ss=on&mf=on&c=on&geo=geoname&geonameid=3448439&M=on&s=on

As with all Hebcal.com REST APIs:

• Both HTTP and HTTPS (HTTP/1.1 and HTTP/2) are supported.
  • You may continue to use plain (port 80) HTTP for API requests if you wish to reduce CPU overhead on your client
• To encourage HTTP caching proxies, proper Cache-Control and Expires are generated in the response
• Compression is supported and encouraged; set the Accept-Encoding: br request header for brotli (best option) or Accept-Encoding: gzip (also very good)
• HTTP Keep-Alive is supported for multiple subsequent requests without the overhead of TCP handshaking

API Parameters

• v=1 – version. Required.
• cfg=json – output JSON instead of HTML
  • cfg=json for JSON format (described in more detail below)
  • cfg=fc for fullcalendar.io integration
  • cfg=rss for RSS (Atom 1.0)
  • cfg=ics for iCalendar RFC 5545
  • cfg=csv for Comma Separated Values

Date

Date range may be specified either using year or both start and end:

• year=now – “now” for current year, or 4-digit YYYY such as 2003
  • yt=G – Interpret year as Gregorian year (common era) – default
  • yt=H – Interpret year as Hebrew year (e.g. 5782)
  • month=x – default “x” for entire Gregorian year, or use a numeric month (1=January, 6=June, etc.)
  • ny=1 – number of years override (default 1)
• start=2021-12-29 – Gregorian start date in YYYY-MM-DD format
• end=2022-01-04 – Gregorian end date in YYYY-MM-DD format

Event options

All booleans, default off. To enable, specify either on (case-sensitive) or 1.

• maj=on – Major holidays
  • yto=on – Yom Tov only; suppresses all other event options
• min=on – Minor holidays (Tu BiShvat, Lag B’Omer, …)
• nx=on – Rosh Chodesh
• mf=on – Minor fasts (Ta’anit Esther, Tzom Gedaliah, …)
• ss=on – Special Shabbatot (Shabbat Shekalim, Zachor, …)
• mod=on – Modern holidays (Yom HaShoah, Yom HaAtzma’ut, …)
• s=on – Parashat ha-Shavuah on Saturday
  • leyning=off – reduce size of JSON by disabling the full kriyah/triennial Torah reading and aliyot details (default leyning=on when s=on)
• D=on – Hebrew date for dates with some event
• d=on – Hebrew date for entire date range
• o=on – Days of the Omer
• ykk=on – Yom Kippur Katan

Daily Learning options

All booleans, default off. To enable, specify either on (case-sensitive) or 1.

• F=on – Daf Yomi
• myomi=on – Mishna Yomi
• nyomi=on – Nach Yomi
• dty=on – Tanakh Yomi
• dps=on – Daily Tehillim (Psalms)
• dcc=on – Sefer Chofetz Chaim
• dshl=on – Shemirat HaLashon
• dr1=on – Daily Rambam
• yyomi=on – Yerushalmi Yomi
• dw=on – Daf-a-Week

Diaspora vs. Israel schedule for holidays and Torah Readings

Mutually exclusive options:

• i=off – Diaspora holidays and Torah readings (default if unspecified)
• i=on – Israel holidays and Torah readings

For more information What is the differerence between the Diaspora and Israeli sedra schemes?

Candle-lighting and fast start/end times

• c=on – Candle lighting times. Requires location, see below.
• b=18 – Candle-lighting time minutes before sunset (the default is 18). For Jerusalem, the default is b=40
• M=on – calculate Havdalah at nightfall – tzeit hakochavim, the point when 3 small stars are observable in the night sky with the naked eye (sun 8.5° below the horizon). This is the default, and this option is an excellent default for most places on the planet.
• m=50 – calculate Havdalah as fixed 50 minutes after sundown. This option is used by those whose minhag is to end Shabbat a fixed number of minutes after sundown. Typically one would enter 42 min for three medium-sized stars, 50 min for three small stars, 72 min for Rabbeinu Tam, or 0 to suppress Havdalah times. Set to m=0 (zero) to disable Havdalah times.

Location

Specify the desired location using GeoNames.org numeric ID, United States ZIP code, or latitude/longitude. This page also describes how to enable/disable the optional elevation for sunset calculation.

Language

By default, event titles use a Sephardic transliteration. Append &lg=LANG to the URL to render the events titles using an alternate event language.

Miscellaneous

Add &hdp=1 to include heDateParts field on untimed (all-day) items in the response.

Callback

Optional callback parameter:

• callback=function – wraps the JSON output text in parentheses and a function name of your choosing. Callback function names may only use upper and lowercase alphabetic characters (A-Z, a-z), numbers (0-9), the period (.), the underscore (_).

Licensing

Content generated by the Hebcal.com web APIs is licensed under a Creative Commons Attribution 4.0 International License. This means that you can use you are free to copy and redistribute the material in any medium or format as long as you give appropriate credit to Hebcal.com.

Example output

{
  "title": "Hebcal São Paulo May 2015",
  "date": "2022-05-30T17:38:40.629Z",
  "location": {
    "title": "São Paulo, Sao Paulo, Brazil",
    "city": "São Paulo",
    "tzid": "America/Sao_Paulo",
    "latitude": -23.5475,
    "longitude": -46.63611,
    "cc": "BR",
    "country": "Brazil",
    "admin1": "Sao Paulo",
    "asciiname": "Sao Paulo",
    "geo": "geoname",
    "geonameid": 3448439
  },
  "range": {
    "start": "2015-05-22",
    "end": "2015-05-25"
  },
  "items": [
    {
      "title": "Candle lighting: 5:11pm",
      "date": "2015-05-22T17:11:00-03:00",
      "category": "candles",
      "title_orig": "Candle lighting",
      "hebrew": "הדלקת נרות",
      "memo": "Parashat Bamidbar"
    },
    {
      "title": "Erev Shavuot",
      "date": "2015-05-23",
      "hdate": "5 Sivan 5775",
      "category": "holiday",
      "subcat": "major",
      "hebrew": "ערב שבועות",
      "link": "https://hebcal.com/h/shavuot-2015?us=js&um=api",
      "memo": "Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"
    },
    {
      "title": "Parashat Bamidbar",
      "date": "2015-05-23",
      "hdate": "5 Sivan 5775",
      "category": "parashat",
      "hebrew": "פרשת במדבר",
      "leyning": {
        "1": "Numbers 1:1-1:19",
        "2": "Numbers 1:20-1:54",
        "3": "Numbers 2:1-2:34",
        "4": "Numbers 3:1-3:13",
        "5": "Numbers 3:14-3:39",
        "6": "Numbers 3:40-3:51",
        "7": "Numbers 4:1-4:20",
        "torah": "Numbers 1:1-4:20",
        "haftarah": "Hosea 2:1-22",
        "maftir": "Numbers 4:17-4:20",
        "triennial": {
          "1": "Numbers 2:1-2:9",
          "2": "Numbers 2:10-2:16",
          "3": "Numbers 2:17-2:24",
          "4": "Numbers 2:25-2:31",
          "5": "Numbers 2:32-2:34",
          "6": "Numbers 3:1-3:4",
          "7": "Numbers 3:5-3:13",
          "maftir": "Numbers 3:11-3:13"
        }
      },
      "link": "https://hebcal.com/s/bamidbar-20150523?us=js&um=api"
    },
    {
      "title": "Candle lighting: 6:05pm",
      "date": "2015-05-23T18:05:00-03:00",
      "category": "candles",
      "title_orig": "Candle lighting",
      "hebrew": "הדלקת נרות",
      "memo": "Erev Shavuot"
    },
    {
      "title": "Shavuot I",
      "date": "2015-05-24",
      "hdate": "6 Sivan 5775",
      "category": "holiday",
      "subcat": "major",
      "yomtov": true,
      "hebrew": "שבועות א׳",
      "leyning": {
        "1": "Exodus 19:1-19:6",
        "2": "Exodus 19:7-19:13",
        "3": "Exodus 19:14-19:19",
        "4": "Exodus 19:20-20:14",
        "5": "Exodus 20:15-20:23",
        "torah": "Exodus 19:1-20:23; Numbers 28:26-31",
        "haftarah": "Ezekiel 1:1-28, 3:12",
        "maftir": "Numbers 28:26-28:31"
      },
      "link": "https://hebcal.com/h/shavuot-2015?us=js&um=api",
      "memo": "Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"
    },
    {
      "title": "Candle lighting: 6:05pm",
      "date": "2015-05-24T18:05:00-03:00",
      "category": "candles",
      "title_orig": "Candle lighting",
      "hebrew": "הדלקת נרות",
      "memo": "Shavuot I"
    },
    {
      "title": "Shavuot II",
      "date": "2015-05-25",
      "hdate": "7 Sivan 5775",
      "category": "holiday",
      "subcat": "major",
      "yomtov": true,
      "hebrew": "שבועות ב׳",
      "leyning": {
        "1": "Deuteronomy 15:19-15:23",
        "2": "Deuteronomy 16:1-16:3",
        "3": "Deuteronomy 16:4-16:8",
        "4": "Deuteronomy 16:9-16:12",
        "5": "Deuteronomy 16:13-16:17",
        "torah": "Deuteronomy 15:19-16:17; Numbers 28:26-31",
        "haftarah": "Habakkuk 3:1-19",
        "maftir": "Numbers 28:26-28:31"
      },
      "link": "https://hebcal.com/h/shavuot-2015?us=js&um=api",
      "memo": "Festival of Weeks. Commemorates the giving of the Torah at Mount Sinai"
    },
    {
      "title": "Havdalah: 6:05pm",
      "date": "2015-05-25T18:05:00-03:00",
      "category": "havdalah",
      "title_orig": "Havdalah",
      "hebrew": "הבדלה",
      "memo": "Shavuot II"
    }
  ]
}

If you don’t want candle lighting times, just use c=off and omit the zip and m parameters.

Example 2: Daf Yomi only

To get only the Daf Yomi for a given day (and not holidays) you can construct a URL that looks like this:

https://www.hebcal.com/hebcal?cfg=json&v=1&F=on&start=2022-06-07&end=2022-06-07

Example output:

{
  "title": "Hebcal Diaspora June 2022",
  "date": "2022-06-03T15:52:37.011Z",
  "location": {
    "geo": "none"
  },
  "range": {
    "start": "2022-06-06",
    "end": "2022-06-06"
  },
  "items": [
    {
      "title": "Yevamot 91",
      "date": "2022-06-06",
      "hdate": "7 Sivan 5782",
      "category": "dafyomi",
      "hebrew": "יבמות 91",
      "link": "https://www.sefaria.org/Yevamot.91a?lang=bi&utm_source=hebcal.com&utm_medium=api"
    }
  ]
}

To display a Jewish calendar on your website, you can use event data from Hebcal.com and the open source JavaScript event calendar from fullcalendar.io.

Here’s a quick template to give you an idea of how to edit the HTML on your site.

<!DOCTYPE html>
<html lang="en"><head>
<meta charset="utf-8">
<title>Jewish Calendar</title>
<link href="hebcal-styles.css" rel="stylesheet">
</head>
<body>
<div id="calendar"></div>
<script src="https://cdn.jsdelivr.net/npm/fullcalendar@6.1.9/index.global.min.js" integrity="sha384-wv6yRjQC0TqzEnAjFQVXM2V0JrF6Nk0dh6QAGf1RwzTqPArdwU3luBZjVCi2YSVH" crossorigin="anonymous"></script>
<script>
document.addEventListener('DOMContentLoaded', function() {
  var calendarEl = document.getElementById('calendar');
  var calendar = new FullCalendar.Calendar(calendarEl, {
      initialView: 'dayGridMonth',
      headerToolbar: {
        left: 'title',
        right: 'prev,next today',
      },
      eventDisplay: 'block',
      events: {
          // add &c=on&geonameid=[locationID] for candle-lighting times
          url: "https://www.hebcal.com/hebcal?cfg=fc&v=1&i=off&maj=on&min=on&nx=on&mf=on&ss=on&mod=on&lg=s&s=on",
          cache: true
      }
  });
  calendar.render();
  // optional: bind keyboard left/right arrow keys
  // to move calendar forward/backward by a month
  document.addEventListener('keydown', function(e) {
    if (e.key === 'ArrowLeft' && !e.metaKey) {
      calendar.prev();
    } else if (e.key === 'ArrowRight' && !e.metaKey) {
      calendar.next();
    }
  });
});
</script>
</body>
</html>

Note on line 9 we use the CDN-hosted FullCalendar JavaScript. If you want to self-host the FullCalendar, you can do so following the FullCalendar Basic Usage instructions.

Note lines 18-22 where we specify the FullCalendar events configuration. We use a url on line 20 that fetches events from Hebcal. You can make other changes such as enabling candle-lighting times, Daf Yomi, etc and changing the event display language (default Sephardic transliterations). See the Jewish calendar REST API documentation for full details on what each parameter means. Remember to use cfg=fc for the FullCalendar format.

You won’t need to specify a year=YYYY parameter, as the fullcalendar.io script automatically sends start=YYYY-MM-DD and end=YYYY-MM-DD parameters for you.

For best performance, be sure to use cache: true (line 21).

If you’d like to include candle-lighting times for Shabbat and holidays, be sure to adjust the url parameter to include c=on and one of the location fields (such as geonameid=3448439 for São Paulo, Brazil).

We recommend some specific styles to make the page look prettier:

/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
html, body {
  margin: 0;
  padding: 0;
  font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif;
  font-size: 14px;
}
#calendar {
  max-width: 1000px;
  margin: 40px auto;
}
a:hover .fc-event-title {
  text-decoration: underline;
}
a:not([href]):hover .fc-event-title {
  text-decoration: none;
}
.fc-event {
    display: block; /* make the <a> tag block */
    font-size: .85em;
    line-height: 1.3;
    border-radius: 3px;
    color: #fff;
    border: 1px solid #3a87ad; /* default BORDER color */
    background-color: #3a87ad; /* default BACKGROUND color */
    margin: 1px 2px 0; /* spacing between events and edges */
    padding: 0 1px;
}
.fc-time {
  font-weight: bold;
}
.fc-event a {
    color: #fff;
}
.fc-event a:hover,
.fc-event a:focus {
    color: #fff;
}
.fc-event.hebdate, .fc-event.hebdate .fc-event-title,
.fc-event.omer, .fc-event.omer .fc-event-title {
  background-color:#FFF;
  border: 1px solid #FFF;
  color:#999;
}
.fc-event.dafyomi,
.fc-event.dafyomi a,
.fc-event.dafyomi .fc-event-title {
  background-color:#FFF;
  border: 1px solid #FFF;
  color:#08c;
}
.fc-event.dafyomi a:hover,
.fc-event.dafyomi a:focus {
    color: #005580;
}
.fc-event.mishnayomi,
.fc-event.mishnayomi a,
.fc-event.mishnayomi .fc-event-title {
  background-color:#FFF;
  border: 1px solid #FFF;
  color:#257e4a;
}
.fc-event.mishnayomi a:hover,
.fc-event.mishnayomi a:focus {
    color: #15713b;
}

.fc-event.holiday,
.fc-event.holiday .fc-event-title,
.fc-event.holiday.timed,
.fc-event.holiday.timed .fc-event-title {
  background-color:#3a87ad;
  border: 1px solid #3a87ad;
  color:#FFF;
}
.fc-event.fast {
  background-color:#fd7e14;
  border: 1px solid #fd7e14;
  color:#FFF;
}
.fc-event.timed,
.fc-event.timed .fc-event-title,
.fc-event.holiday.timed.fast,
.fc-event.holiday.timed.fast .fc-event-title {
  background-color:#FFF;
  border: 1px solid #FFF;
  color:#333;
}
.fc-event.holiday.yomtov,
.fc-event.holiday.yomtov a,
.fc-event.holiday.yomtov .fc-event-title {
  background-color:#ffd446;
  border: 1px solid #ffd446;
  color:#333;
}
.fc-event.parashat,
.fc-event.parashat .fc-event-title {
  background-color:#257e4a;
  border: 1px solid #257e4a;
  color:#FFF;
}
.fc-event.roshchodesh {
  background-color:#6f42c1;
  border: 1px solid #6f42c1;
  color:#FFF;
}
.fc-event.hebrew .fc-title {
  font-family:'SBL Hebrew',David;
  font-size:115%;
  font-weight:normal;
  direction:rtl;
}
.fc-event.hebrew .fc-time {
  direction:ltr;
  unicode-bidi: bidi-override;
}
.fc-event-time, .fc-event-title {
 padding: 0 1px;
 white-space: normal;
}
.fc .fc-event.fc-event-today .fc-event-title {
  background-color: rgba(255,220,40,0.15);
}

We offer a simple API for converting between Gregorian and Hebrew dates. Two output formats are supported: JSON and XML.

Note that this is a web API with the same functionality as the HDate API provided by the JavaScript @hebcal/core package. If you’re building a JavaScript application, consider using the native JS library instead of web APIs for a faster user experience.

1. Gregorian to Hebrew – single

To convert from Gregorian to Hebrew date use this URL format:

https://www.hebcal.com/converter?cfg=json&date=2011-06-02&g2h=1&strict=1

• cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)
• g2h=1 – Convert from Gregorian to Hebrew date
• date=2011-06-02 – Gregorian date in YYYY-MM-DD format
• gs=on – After sunset on Gregorian date
• strict=1 – strict mode will return a 400 Bad Request error for invalid dates

As an alternative to specifying date=YYYY-MM-DD, clients may send gy=YYYY&gm=MM&gd=DD as follows:

• gy=2011 – Gregorian year
• gm=6 – Gregorian month (1=January, 12=December). Leading 0 is optional
• gd=2 – Gregorian day of month. Leading 0 is optional

2. Gregorian to Hebrew – range of dates

To convert a batch of Gregorian dates to Hebrew dates, use this URL format:

https://www.hebcal.com/converter?cfg=json&start=2021-12-29&end=2022-01-04&g2h=1

• cfg=json – output format is JSON (cfg=json)
• g2h=1 – Convert from Gregorian to Hebrew date
• start=2021-12-29 – Gregorian start date in YYYY-MM-DD format
• end=2022-01-04 – Gregorian end date in YYYY-MM-DD format

Results will be truncated to 180 days if the end date is more than 180 days after the start date.

3. Hebrew to Gregorian – single date

To convert from Hebrew to Gregorian use this URL format:

https://www.hebcal.com/converter?cfg=json&hy=5749&hm=Kislev&hd=25&h2g=1&strict=1

• cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)
• h2g=1 – Convert from Hebrew to Gregorian date
• hd=25 – Hebrew day of month
• hy=5749 – Hebrew year
• hm=Kislev – Hebrew month

Month names may be specified in Hebrew or transliterated as follows:

In leap years, specifying Adar is the same as specifying Adar2. In non-leap years, all three of Adar, Adar1, and Adar2 are considered equivalent and will be interpreted as Adar.

The API is somewhat lenient in what it accepts for Hebrew month names. You can specify sh%27vat or Sh%27vat or Shvat. It will always consistently generate Sh'vat in the response. Generally the API will accept month names with as few as 2 characters, as this is sufficient to disambiguate them from each other,.

Similarly, the API accepts all of Adar1, Adar 1, Adar I, Adar2, Adar 2, Adar II. Because the capital-i and the lowercase-L look the same in some fonts, we recommend using the numerals 1 and 2 in the API usage. In the generated responses, Hebcal always uses Adar I and Adar II for consistency and compatibility as we’ve done for over 20 years.

4. Hebrew to Gregorian – range of dates

To convert a batch of Hebrew dates to Gregorian dates, use the same URL format as the “Hebrew to Gregorian – single date” above, and add an additional ndays parameter.

https://www.hebcal.com/converter?cfg=json&hy=5749&hm=Kislev&hd=25&h2g=1&ndays=90&strict=1

• ndays=90 – calculate range of of days (between 2 and 180 inclusive)

5. Other API notes

By default, event titles use a Sephardic transliteration. Append &lg=LANG to the URL to render the events titles using an alternate event language.

Note also an optional callback parameter:

• callback=function – wraps the JSON output text in parentheses and a function name of your choosing. Callback function names may only use upper and lowercase alphabetic characters (A-Z, a-z), numbers (0-9), the period (.), the underscore (_).

As with all Hebcal.com REST APIs:

• Both HTTP and HTTPS (HTTP/2) are supported. Although most of the Web has moved to HTTPS, if you wish to reduce CPU overhead on your client you may continue to use plain (port 80) HTTP for API requests
• We encourage HTTP caching proxies. Proper Cache-Control and Expires are generated in the response
• We support both gzip and br (brotli) compression; set the appropriate Accept-Encoding header in your request to enable
• We support HTTP Keep-Alive for multiple requests

Content generated by the Hebcal.com web APIs is licensed under a Creative Commons Attribution 4.0 International License. This means that you can use you are free to copy and redistribute the material in any medium or format as long as you give appropriate credit to Hebcal.com.

6. Sample output in JSON and XML

{
  "gy": 2011,
  "gm": 6,
  "gd": 2,
  "afterSunset": false,
  "hy": 5771,
  "hm": "Iyyar",
  "hd": 29,
  "hebrew": "כ״ט בְּאִיָיר תשע״א",
  "heDateParts": {
    "y": "תשע״א",
    "m": "אייר",
    "d": "כ״ט"
  },
  "events": [
    "Parashat Nasso",
    "44th day of the Omer"
  ]
}

<?xml version="1.0" ?>
<hebcal>
  <gregorian year="2011" month="6" day="2" />
  <hebrew year="5771" month="Iyyar" day="29" str="כ״ט בְּאִיָיר תשע״א" />
</hebcal>

7. Sample output (batch API)

{
  "start": "2021-12-29",
  "end": "2022-01-04",
  "locale": "en",
  "hdates": {
    "2021-12-29": {
      "hy": 5782,
      "hm": "Tevet",
      "hd": 25,
      "hebrew": "כ״ה בְּטֵבֵת תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "טבת",
        "d": "כ״ה"
      },
      "events": [
        "Parashat Vaera"
      ]
    },
    "2021-12-30": {
      "hy": 5782,
      "hm": "Tevet",
      "hd": 26,
      "hebrew": "כ״ו בְּטֵבֵת תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "טבת",
        "d": "כ״ו"
      },
      "events": [
        "Parashat Vaera"
      ]
    },
    "2021-12-31": {
      "hy": 5782,
      "hm": "Tevet",
      "hd": 27,
      "hebrew": "כ״ז בְּטֵבֵת תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "טבת",
        "d": "כ״ז"
      },
      "events": [
        "Parashat Vaera"
      ]
    },
    "2022-01-01": {
      "hy": 5782,
      "hm": "Tevet",
      "hd": 28,
      "hebrew": "כ״ח בְּטֵבֵת תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "טבת",
        "d": "כ״ח"
      },
      "events": [
        "Shabbat Mevarchim Chodesh Sh'vat",
        "Parashat Vaera"
      ]
    },
    "2022-01-02": {
      "hy": 5782,
      "hm": "Tevet",
      "hd": 29,
      "hebrew": "כ״ט בְּטֵבֵת תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "טבת",
        "d": "כ״ט"
      },
      "events": [
        "Parashat Bo"
      ]
    },
    "2022-01-03": {
      "hy": 5782,
      "hm": "Sh'vat",
      "hd": 1,
      "hebrew": "א׳ בִּשְׁבָט תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "שבט",
        "d": "א׳"
      },
      "events": [
        "Rosh Chodesh Sh'vat",
        "Parashat Bo"
      ]
    },
    "2022-01-04": {
      "hy": 5782,
      "hm": "Sh'vat",
      "hd": 2,
      "hebrew": "ב׳ בִּשְׁבָט תשפ״ב",
      "heDateParts": {
        "y": "תשפ״ב",
        "m": "שבט",
        "d": "ב׳"
      },
      "events": [
        "Parashat Bo"
      ]
    }
  }
}

Our new Hebcal Shabbat Times WordPress plugin displays candle-lighting time, Torah Portion, and havdalah time in a WordPress widget. If you run a synagogue or other local Judaism-related website, you can get customized times based on your USA Zip code.

An alternative approach is to use the WordPress built-in RSS Widget and configure as follows:

Note: as of 2020, we recommend newer FullCalendar approach. These instructions are here for historical purposes.

You may use the HTML tags below, courtesy of Kevin Ilsen’ JavaScript Event Calendar to put a calendar on your website. See an example of what the event calendar looks like.

If you just want holidays and no candle-lighting times, put these tags in the <head> section of the page:

Then, somewhere in the <body> section of the page where you want the calendar to appear, use these tags:

To add candle-lighting times for your city or town, you can change lines 1 and 2 in the first code block above as follows to include a zip code.

Be sure to change 90210 to your shul’s zip code. For example,

Note the following customizable parameters and their meanings:

• nh=on – major holidays
• nx=on – Rosh Chodesh
• mf=on – minor fasts
• ss=on – special Shabbatot
• s=on– Parashat ha-Shavuah on Saturday
  • i=off – Diaspora sedra scheme
  • i=on – Israel sedra scheme
• c=on – candle lighting times
• zip=90210 – use zip code 90210 for candle lighting times
• m=72 – Havdalah 72 minutes after sundown. Set to m=0 (zero) to disable Havdalah times
• D=on – Hebrew date for dates with some event
• d=on – Hebrew date for entire date range
• o=on – Days of the Omer

Note mutually exclusive language parameter:

• lg=s – Sephardic transliterations
• lg=sh – Sephardic translit. + Hebrew
• lg=a – Ashkenazis transliterations
• lg=ah – Ashkenazis translit. + Hebrew
• lg=h – Hebrew only