Calendar Event Format

Explore the complete JSON format and property list for managing calendar events. This guide outlines every available field to help developers efficiently create, update, and organize events within the library.

Example

let event = {
    from: new Date(),
    to: new Date(),
    title: "A New Event",
    description: "A description of the event"
};

calendarInstance.addEvent( event );

Options

Type:Name:Description:
stringidThe ID for the event (set automatically if not available).
stringtitleThe title of the event.
ObjectfromThe date that the event occurs from.
ObjecttoThe date that the event runs until.
stringdescriptionThe in-depth description of the event.
stringlocationThe location of the event.
stringcolorThe color that should be used for the event (overrides all others).
stringcolorTextThe color that should be used for the event text (overrides all others).
stringcolorBorderThe color that should be used for the event border (overrides all others).
booleanisAllDayStates if this event is for all-day.
numberrepeatEveryStates how often the event should repeat (0 = Never, 1 = Every Day, 2 = Every Week, 3 = Every 2 Weeks, 4 = Every Month, 5 = Every Year, 6 = Custom).
number[]repeatEveryExcludeDaysStates the days that should be excluded when an event is repeated.
Object[]seriesIgnoreDatesStates the dates (string format) that should be ignored when an event is repeated.
ObjectcreatedThe date that the event was created.
stringorganizerNameThe name of the organizer.
stringorganizerEmailAddressThe email address of the organizer.
ObjectrepeatEndsThe date when a repeating series should end.
stringgroupThe name of the group the event belongs to.
stringurlThe URL that is associated with the event.
numberrepeatEveryCustomTypeStates the custom repeating period (0: Daily, 1: Weekly, 2: Monthly, 3: Yearly)
numberrepeatEveryCustomValueStates the custom repeating period value (for example, 1 day, week, month, or year).
ObjectlastUpdatedThe date that the event was last updated.
booleanshowAlertsStates if browser notifications should be shown for this event (defaults to true).
booleanlockedStates if this event is locked and cannot be edited (it can still be removed, defaults to false).
numbertypeStates what event type this is (0: Normal, 1: Meeting, 2: Birthday, 3: Holiday, 4: Task).
ObjectcustomTagsStores custom tags (any object format) that can be assigned to the event (they are not used in the calendar).
booleanshowAsBusyStates if the calendar should show the events time period as busy (defaults to true).
numberalertOffsetStates the number of minutes before the “from” date/time to show a browser notification (defaults to zero).