Once the company has enabled calendar integration, the agent can activate the integration and adjust its settings and scope:
- Open the calendar view by clicking the calendar icon in the top right corner.
- Click Activate the calendar integration.
- A user settings view will now open on the right side, where you can synchronize (connect) your personal calendar with Linear's calendar.
- Select which events recorded in Linear you want to sync to your personal calendar: Tasks, Meetings, and/or Showings. We recommend keeping all event types active to ensure your Gmail calendar stays fully updated.
- By enabling Retroactive synchronization, all events recorded in Linear within the last 30 days (and selected above) will be synced to your personal calendar.
- You can choose whether to import events from your personal (Gmail) calendar into Linear's calendar, such as vacation entries or dentist appointments. Other users will not see the events from your linked calendar in Linear.
- Decide whether to create a new calendar view for Linear events to clearly separate personal events from Gmail calendar events. This helps keep work and personal matters distinct. If you use an electronic booking calendar or want your colleagues to see your calendar events, we recommend not selecting this option.
- After selecting your desired options, click Sign in with Google.
Follow Google's instructions in your browser and log in to Gmail using your email address and password. After logging in, approve the integration between Google and Linear calendars:
After approval, you should see a pop-up message in Linear indicating that the integration has been established.
NOTE: Synchronizing calendars will take several minutes after setup, meaning old and new events will not immediately update between calendars. This delay only applies to the initial setup; there will be no similar delay when recording new events in the future.
Once the calendars are synchronized, and if you chose Create a new calendar view for Linear's calendar (step 7 in the top image), a new calendar named Linear: [Your Name] will appear in Gmail. Events created in Linear will only be visible in Gmail's calendar if the Linear calendar is activated. Activate Linear calendar events by clicking the "check" mark (✅) next to its name.
NOTE: If you enabled both Display events from the integrated calendar in the Linear calendar (step 6 in the top image) and Create a new calendar view for Linear's calendar (step 7 in the top image), it is important to create your personal calendar events, such as doctor appointments, in your main calendar (e.g., "Jarkko Toikkanen" in the example image). If you add events to the "Linear: Jarkko Toikkanen" calendar in Gmail, they will not be visible in Linear's calendar.