App

Calendar Sync

Understanding Calendar Sync

OneCal Calendar Sync allows users to synchronize multiple iCloud, CalDAV, Outlook or Google Calendars in real-time, automatically.

Grainy Texture
 Calendar Sync Illustration
Illustration of synced Google Calendar with an Outlook Calendar.

Good To Know

You do NOT need to set up Calendar Sync in order to use OneCal's Booking Links or Unified Calendar View features.


Supported Providers

  • Google Calendar
  • Microsoft Outlook
  • iCloud Calendar
  • CalDAV calendars, such as Fastmail, Nextcloud or Zoho

Good To Know

OneCal is approved by Google and Microsoft and uses Official APIs to access your calendars. We act as a proxy and don't store or analyze any of the calendar data or events.


Sync Directions

OneCal supports one-way and multi-way calendar syncs.

One-Way Sync Direction

The one-way calendar sync allows you to sync one calendar to another, or to multiple calendars. The calendar sync would look like this:

  • Calendar A -> Calendar B
  • Calendar A -> Calendar B, Calendar C, Calendar D (and more calendars...)

Here is what the UI looks like:

Grainy Texture
Choose Calendar Sync Direction
Choose Calendar Sync Direction
Grainy Texture
Choose Source Calendar and Target Calendar(s)
Choose Source Calendar and Target Calendar(s)

Example 1:

You have a work calendar and a personal calendar. You can:

  • Create a one-way sync to sync Personal -> Work, by removing all event information, and just blocking the time in your Work calendar for personal events.
  • Create another one-way sync to sync Work -> Personal, by sending all event information to your personal calendar.

Example 2:

You have two work calendars and a personal calendar. You can:

  • Create a one-way sync to sync Personal -> Work1, Work2, by removing all event information, and just blocking the time in your Work calendars for personal events.
  • Create a one-way sync to sync Work1 -> Personal, by sending all Work1 information to your personal calendar.
  • Create a one-way sync to sync Work2 -> Personal, by sending all Work2 information to your personal calendar.

This configuration allows you to block time on your work calendars for personal events, and block time on your personal calendar for work events.

Your privacy is intact when blocking time on your work calendars for personal events, as all event details are stripped.

Multi-Way Sync Direction

The multi-way calendar sync allows you to sync multiple calendars under the same sync configuration.

Here is what the UI looks like:

Grainy Texture
Choose Calendar Sync Direction
Choose Calendar Sync Direction
Grainy Texture
Choose Calendars to Sync
Choose Calendars to Sync

Example:

You have 3 work calendars and a personal calendar. You want to sync all calendars by showing 'Busy' for clone events. You could create a multi-way calendar sync and select the calendars you want to sync. OneCal handles the rest.

One Sync per Calendar Pair

We strongly recommend syncing each calendar pair, in the same direction, with only one calendar sync. Syncing a pair that another calendar sync already covers can result in multiple clone events for the same original event.

This only concerns syncs covering the same pair in the same direction. Syncs in opposite directions, like Work -> Personal and Personal -> Work, are safe to combine: OneCal never clones its own clone events, so events cannot bounce back and forth between your calendars. See Does OneCal clone its own clone events?.

Sync Configuration

Both One-way and Multi-way calendar syncs have the same sync configuration.

Grainy Texture
Calendar Sync Configuration
Calendar Sync Configuration

Sync Configuration Settings

The filters are grouped in the Event filters section of the sync configuration. Click Show to open it. The section shows how many filters are active. OneCal never copies its own clone events, so you don't need to filter them out.

Grainy Texture
The Event filters section of the sync configuration with every filter
The Event filters section.

How Often Do the Syncs Run?

The Calendar Sync is automatic. For Google and Outlook calendars it is real-time: as soon as a change happens in your source calendar(s), OneCal syncs all the target calendars. Changes on iCloud and CalDAV calendars are detected about every 10 minutes, since these calendars do not provide a real-time API.

Preview the sync

While you create or edit a calendar sync, the preview next to the configuration summarizes what the sync copies and which filters apply. Click Preview on my calendars to open the full preview. It shows your real events before and after the sync, from this week up to the end of the sync window, and marks the events OneCal will create as clones. Drag the handle to compare the two states, and click an event to see why it is or is not synchronized.

Grainy Texture
The Sync preview with the before and after view of a calendar
The Sync preview.

The preview is read-only. Nothing is written to your calendars until you save the calendar sync.

Previous
Set Your Default Calendar