#Calendar Integrations

Calendars play a critical role in managing our workflows, especially when juggling numerous meetings and appointments. Associating notes with events not only helps maintain organization but also ensures important tasks and details are not overlooked.

AFFiNE's calendar integration provides you with a more efficient way to get an overview of your events every day and create documents from events in your calendar. Let your event information efficiently become part of the AFFiNE knowledge base and be linked in the Journal of the event day.

#How does it work

The AFFiNE Calendar integration displays your scheduled events for the day, providing a comprehensive overview of all your activities.

From AFFiNE Calendar though, you can create docs linked to the day’s journal directly from calendar events, enabling more efficient association between event details and their corresponding dates.

From AFFiNE Calendar though, you can create documents linked to the day’s journal directly from calendar events, enabling more efficient association between event details and their corresponding dates.

Please note that event synchronization between your calendar and AFFiNE is not real-time. If updated events do not appear immediately, we recommend refreshing the application or switching the focus to another section and then back to the Journal to prompt an update.

#Setup

To set up calendar integrations, go to Settings > Integrations > Calendar and follow the instructions there.

After completing the setup, navigate to the 'Calendar' button and ensure that the right sidebar is open. This section will display your scheduled events.

AFFiNE currently supports the following calendar integrations:

• WebCal standard

• iCal standard

AFFiNE does not support uploading .ics files from local.

#How to get the subscription URL

AFFiNE currently supports event integration only through URL subscriptions. To integrate events into AFFiNE, you must obtain the subscription link from your corresponding calendar product.

The following are the locations for generating subscription links in popular calendar products:

#Google Calendar

You can access it through the Settings in the upper right corner, click on Settings for my calendars to find Integrate calendars. Please note that Google Calendar supports integration via URL, Embedding, and iCal. You can choose either the URL or iCal.

#Microsoft Outlook

You can access Calendar through the Settings in the upper right corner, and click on Shared calendars to generate your subscription link.

#Apple Calendar

You can right-click to expand the menu and click Share Calendar. By checking Public, you will get a subscription link.

#Calendar integration settings

Once your calendar integration is subscribed, you can customize its settings to suit your specific preferences.

• Calendar settings: In the calendar integration settings, you can choose which calendar events to display in AFFiNE, as well as whether to show all-day events. You can also customize event colors and calendar names to better suit your preferences.

#What are calendar integrations for?

AFFiNE's calendar integrations aim to seamlessly connect notes and events, enabling AFFiNE to efficiently record event details through its Event feature. Leveraging built-in functionalities such as Collections and the Edgeless feature, AFFiNE facilitates enhanced management and visualization of this content.

#What are calendar integrations NOT for?

Calendar integrations in AFFiNE are not intended to fully replace dedicated calendar, to-do applications. Instead, AFFiNE focuses on managing documents and contextual information related to events and meetings.

• To manage events, we recommend using a calendar app

• We recommend creating documents in AFFiNE and using tasks within those documents as templates that can be inserted into other documents as needed.

#Calendar integrations won't replace your calendar app

In AFFiNE's calendar integration, if an event in your calendar is updated, AFFiNE will simultaneously update the corresponding event. However, you cannot modify or create events directly within AFFiNE.

Limitations and things you need to noticed:

• AFFiNE does not permit event management through its calendar interface: You can view events and create notes from them, but AFFiNE does not support creating or fully editing events in your Google, Outlook, or Apple Calendar. To create events without notes, set up recurring events, move events, or edit event properties, you must use your calendar application.

• AFFiNE does not support creating multiple synchronized documents for the same event: If you create multiple documents from an event, these documents are independent and cannot share information. To maintain consistent updates, please edit the relevant document directly.

#Calendar provider requirements

AFFiNE requires a connection to your calendar provider to ensure reliable event synchronization across devices. Your provider and organization must support external calendar access. If your organization restricts external access to only displaying the status of calendar events, AFFiNE's calendar integration will not be available at this time.

#FAQs

• I am unable to subscribe to a calendar via URL in AFFiNE - Please ensure that you are using a Public URL in your calendar product or verify that your email permissions are set to Public. (If using a corporate email, restrictions may apply.)

• I am unable to subscribe to a calendar via URL in AFFiNE - Please ensure that you are not subscribing to the same URL multiple times, as AFFiNE does not support duplicate subscriptions to the same URL.

• All events I see in AFFiNE are marked as 'Busy' - Please ensure that you are using a Public URL in your calendar product or verify that your email permissions are set to Public. (If using a corporate email, restrictions may apply.)