Calendar

The following is an example file that imports multiple entries/events.

Note the last entry contains complex rules for repeating events. Due to the complexity of the frequency selector, the values must be a JSON object. We have tried to illustrate possible values for the objects, but for further assistance on all the possible values, we suggest reaching out to the Solspace support team. These values mimic the POST data when saving an event in an entry.

If you are using the JSON import format (as in the example below), make sure to encode the values as a string (escape the quotes). If you are using the XML or CSV import formats you should not need to encode the string, but it must still be a JSON object. For example: {"byday": ["SU", "TH"]}

[
  {
    "title": "Event #1",
    "startTime": "03-01-2025 4:00 PM",
    "endTime": "03-01-2025 5:00 PM"
  },
  {
    "title": "Event #2",
    "startTime": "01-01-2026",
    "endTime": "01-02-2026"
  },
  {
    "title": "Event #3",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "exclude": "01-02-2026, 01-03-2026, 01-05-2026"
  },
  {
    "title": "Event #4",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "repeats": true,
    "freq": "daily",
    "interval": 1,
    "until": "01-01-2027",
    "exclude": "01-02-2026, 01-03-2026, 01-05-2026"
  },
  {
    "title": "Event #5",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "repeats": true,
    "freq": "dates",
    "interval": 1,
    "until": "01-01-2027",
    "include": "05-15-2026, 05-16-2026, 05-17-2026"
  },
  {
    "title": "Event #7",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "repeats": true,
    "freq": "weekly",
    "weekly": "{\"byday\": [\"FR\", \"SA\"]}",
  },
  {
    "title": "Event #8",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "repeats": true,
    "freq": "monthly",
    "monthly": "{\"bymonthdayorbyday\": \"bymonthday\", \"bydayinterval\": \"1\"}",
  },
  {
    "title": "Event #8",
    "startTime": "01-01-2026",
    "endTime": "01-25-2026",
    "allDay": true,
    "repeats": true,
    "freq": "yearly",
    "yearly": "{\"bydayinterval\": \"1\"}"
  }
]

Last updated

Was this helpful?