EasyShul EasyShul Public APIs

📌 Today Widget

A compact widget that shows information about today only — the Gregorian and Hebrew date, parsha, holiday, Sefiras HaOmer count, today's events, and halachic times (zmanim). Embed it with a single <script> tag. It refreshes at midnight to stay current.

Need a full month grid? See the Calendar Widget. It shares the same zmanim options documented there (ZmanTypes, opinions, auto candle-lighting/havdalah/fasts).

🛠️ Code generator

Fill in the options and copy the generated HTML snippet, or click Preview.

Basics
Your *.easyshul.com subdomain (needed for events)
Sections to show
Molad (Shabbat Mevarchim)
Off by default. Uses the zip code's Friday sunset through Saturday havdalah, even when zmanim are hidden.
Independent of Hebrew date language.
Zmanim
Candle lighting, Shabbat/holiday ends, and fast times are auto-included when present unless their auto-inclusion attributes are disabled. Explicit zmanim selections (including "all") remain included. See the Calendar Widget docs for all ZmanTypes and opinion overrides.
External calendar subscriptions
Merge events from other iCal calendars. Name and color are optional.
Appearance

Generated code


    

      
      
    

    

    
Molad on Shabbat Mevarchim

    

      Enable data-show-molad="true" to show the upcoming month's molad announcement
      during Shabbat Mevarchim. It is off by default. data-molad-locale="en" (default)
      or "he" controls only the molad heading, details, notices, and
      Hebcal attribution,
      independently of data-hebrew-locale and other Hebcal content.
    

    

      With a US zip code in data-location-id, the display window begins at that
      location's Friday sunset (not candle-lighting time) and ends at
      Saturday havdalah. It honors data-havdalah-from-tzeis
      and the selected opinion, including when Tzeis or havdalah is not selected for display.
      An explicitly selected Tzeis opinion must have an available time; the molad window
      never substitutes a different opinion when that time is missing.
      Saturday's Tzeis may fall after midnight Sunday. In that case, the announcement remains
      visible until that actual cutoff rather than disappearing at civil midnight.
      The window follows the configured location, not the browser's time zone, and remains
      active even when data-show-zmanim="false" or no zmanim are selected.
      Already-known sunset and havdalah boundaries continue to update the display while
      a background refresh is pending, including after returning to a hidden tab.
    

    

      Without a zip code, the widget falls back to Saturday by the browser's local date and
      shows a localized sunset-timing-unavailable notice. A configured location with missing
      sunset, havdalah, or time-zone data instead reports timing as unavailable; it does not
      silently use the no-location fallback or invent a Shabbat window.
      Announcement metadata can still be recovered without location lookup, but that alone
      does not establish when to show it in the Today widget.
      If the announcement calendar fails, that failure is shown separately. If Shabbat Mevarchim
      is known but structured molad details are missing, its heading remains with a localized
      Molad details unavailable notice.
    

    

      Molad weekday, hours, minutes, and chalakim describe the traditional announcement,
      not a local civil-time instant or an astronomical new-moon prediction. The announcement
      itself is not time-zone converted. Every displayed announcement credits Hebcal.
      For printing, the Calendar Widget has a separate
      Include molad checkbox for Monthly grid and Daily agenda, even if the
      on-screen molad is disabled. Printing needs announcement data only, not location timing;
      partial or unavailable data requires acknowledgement. Zmanim table excludes molad and
      makes no extra molad requests.
    


    
    
Customization reference

    

      
AttributeDescriptionDefault

      
        
data-orgOrganization key (for events)—

        
data-location-idUS zip code for zmanim—

        
data-layoutinline or cardinline

        
data-show-dateShow Gregorian + Hebrew datetrue

        
data-show-parshaShow Torah portiontrue

        
data-show-holidayShow holiday nametrue

        
data-show-omerShow Sefiras HaOmer count (during the Omer)true

        
data-show-moladShow molad during the Shabbat Mevarchim window, independently of zmanim visibilityfalse

        
data-molad-localeMolad language (en or he), independent of Hebrew date languageen

        
data-show-eventsShow today's eventstrue

        
data-show-zmanimShow zmanimtrue

        
data-zmanimJSON array of ZmanType strings, or "all"none

        
data-zmanim-opinionsJSON {ZmanType: "Opinion"} overridesBaal HaTanya defaults

        
data-auto-candles / data-auto-havdalah / data-auto-fastsAuto-include special timestrue

        
data-havdalah-from-tzeisUse Tzeis opinion for Shabbat/holiday endfalse

        
data-subscriptionsJSON array of {url, name?, color?}[]

        
data-hide-hebrew / data-hebrew-localeHebrew date control (he/en)show / he

        
data-israelUse the Israel schedule (one-day Yom Tov, Israel parsha/holiday/havdalah)false

        
data-accent-color / data-bg-color / data-text-color / data-border-color / data-border-radius / data-max-width / data-event-colorAppearance—

      
    

    

      Note: the Sefiras HaOmer count is computed from the Hebrew date (Hebcal has no Omer
      field) and only appears between 16 Nisan and 5 Sivan.