Skip to content


Calendar or agenda display


  • options
    • query - Dispatch query
    • dayFormat - string array of day formats used to display the entry in the calendar
    • trackerDayFormat - tracker handle to format mapping for tracker based display
    • initialView - "agenda" | "month"
    • variant - "default" | "expanded" | "edit"

Day formats

  • :icon - tracker or swimlane icon
  • :color - color
  • :body - single line body
  • :bodyMultiline - multiline body truncated to 512 characters
  • :template - single line template (based on the Tracker)
  • :templateMultiline - multi line template

Default for mobile is [":default", ":color", ":body"]. The default for web is [":default", ":color", ":icon", ":body"]


Note that the dispatch query should not include a from clause. This will be added automatically to correspond to the user selected time frame.


    "title": "Calendar",
    "icon": "far fa-calendar",
    "target": "calendar",
    "options": {
        "query": "all users",
        "dayFormat": [":icon", ":templateMultiline"],
        "trackerDayFormat": {
            "photo": [":icon"]