> ## Documentation Index
> Fetch the complete documentation index at: https://docs.planeconnection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Use the Calendar

> View and manage crew schedules, aircraft availability, maintenance windows, training events, and trip timelines from the shared operations calendar.

By the end of this guide, you will have navigated the shared operations calendar, filtered events by type, created custom events, set up recurring events, and exported the calendar to external applications.

<Info>
  The Operations module must be enabled for your workspace. You also need the appropriate operations
  permissions. Contact your workspace administrator if you cannot access these features.
</Info>

<Info>
  Any workspace member can view the calendar. Creating and editing events requires the
  `calendar.manage` permission.
</Info>

## Prerequisites

* Your workspace must have active trips, crew, or aircraft for the
  calendar to display operational data.
* Training events and safety committee meetings populate
  automatically from their respective modules when those modules
  are enabled.

## Navigate to the calendar

Open the **Calendar** item in the sidebar navigation. The calendar
page loads with a toolbar at the top and the calendar grid below.

## Calendar views

Use the toolbar toggle buttons to switch between **Month**, **Week**, and **Day** views. List-based views (**List Week** and **List Month**) display events as a flat, chronological scrollable list.

## Navigate between periods

The toolbar displays the current period label (e.g., "March 2026"
for month view or "Mar 8 - 14, 2026" for week view) with navigation
controls:

* **Left arrow** -- Move to the previous period.
* **Right arrow** -- Move to the next period.
* **Today** button -- Return to the current date. This button
  appears in the toolbar whenever you have navigated away from
  today.

## Event types and color coding

Events are color-coded by type: **Trips** (blue), **Maintenance** (orange), **Training** (purple), **Safety Meetings** (green), **Crew Unavailable** (red), and **Custom Events** (user-selected color). All-day events appear as colored bars at the top of the day column, while timed events appear as blocks proportional to their duration.

## Filter events

Click the **filter icon** in the toolbar to open the filter panel. You can filter by **Event Type**, **Aircraft**, **Crew Member**, and **Status**. Active filters are indicated by a red dot badge on the filter icon. Click **Reset Filters** to clear all filters.

<Note>
  Filter selections persist during your session. When you close and reopen the calendar, filters
  reset to show all event types.
</Note>

## View event details

Click any event on the calendar to open a detail popover showing the
event title, type badge, date and time range, description, and
associated resource (aircraft, crew member, or meeting attendees).
Trip and maintenance events include a direct link to the source
record.

For trip events, the popover also displays the route (ICAO codes),
assigned PIC and SIC, aircraft tail number, and trip status label.

## Create a custom event

<Steps>
  ### Step 1: Open the event form

  You can create events in two ways:

  * Click the **"+"** button in the toolbar to open a blank event form.
  * Click and drag across a time range on the calendar grid (in Week
    or Day view) to pre-fill the start and end times.

  ### Step 2: Fill in event details

  Fill in the **Title**, **Description**, **Start** and **End** date/time, and optionally toggle **All Day** or pick a **Color**. The end must be after the start.

  ### Step 3: Save the event

  Click **Save** to create the event. It appears on the calendar
  immediately. Click **Cancel** to discard without saving.
</Steps>

## Edit or delete events

### Edit an event

1. Click the event on the calendar to open the detail popover.
2. Click **Edit** in the popover.
3. The event form opens pre-filled with the current details.
4. Make your changes and click **Save**.

You can also **drag and drop** events to a new date or time on the
calendar grid (in Week or Day view). The event's start and end times
update automatically. To resize an event's duration, drag the bottom
edge of the event block up or down.

<Note>
  Trip, maintenance, and training events are managed from their respective modules. Editing these
  events on the calendar redirects you to the source record (e.g., the trip detail page) where you
  can make changes.
</Note>

### Delete an event

1. Click the event to open the detail popover.
2. Click **Delete** in the popover.
3. A confirmation dialog appears. Click **Delete** to confirm.

Only custom events can be deleted from the calendar. System-generated
events (trips, maintenance, training) must be cancelled or removed
from their source module.

## Recurring events

When creating or editing a custom event, toggle **Recurring** to set
a recurrence pattern. Select a frequency (**Daily**, **Weekly**,
**Bi-weekly**, or **Monthly**), choose specific days for weekly
recurrence, and set an end date or choose indefinite recurrence.

Editing a single occurrence prompts you to choose between **This
Event Only** or **All Future Events**. Deleting follows the same
pattern.

<Tip>
  Use recurring events for standing meetings like weekly safety committee sessions or monthly
  management reviews.
</Tip>

## Calendar integration (iCal export)

You can subscribe to your PlaneConnection calendar from external
calendar applications (Google Calendar, Apple Calendar, Outlook)
using the iCal feed URL.

<Steps>
  ### Step 1: Generate the iCal feed URL

  1. Click the **settings gear** icon in the calendar toolbar.
  2. Select **Calendar Export**.
  3. The export dialog displays a unique iCal feed URL for your
     workspace calendar. Click **Copy URL** to copy it to your
     clipboard.

  ### Step 2: Subscribe from an external calendar

  Add the URL as a calendar subscription: **Google Calendar** (Settings >
  Add calendar > From URL), **Apple Calendar** (File > New Calendar
  Subscription), or **Outlook** (Add calendar > Subscribe from web).
  The external calendar polls the feed periodically and displays
  PlaneConnection events alongside your personal schedule.
</Steps>

<Warning>
  The iCal feed URL contains a unique authentication token for your account. Do not share it
  publicly. If you suspect the URL has been compromised, click **Regenerate URL** in the Calendar
  Export dialog to invalidate the old URL and generate a new one.
</Warning>

## Calendar settings

Workspace administrators can configure calendar defaults (week start day, default view, time format, time zone display, and business hours) under **Settings > General > Calendar**.

## Related

<CardGroup cols={2}>
  <Card title="Manage the Schedule" href="/how-to/ops/manage-schedule">
    View the crew and aircraft assignment schedule organized by resource.
  </Card>

  <Card title="Create a Trip" href="/how-to/ops/create-trip">
    Trips appear on the calendar automatically after creation.
  </Card>

  <Card title="Track Due Items" href="/how-to/ops/track-due-items">
    Maintenance due items populate the calendar as events.
  </Card>

  <Card title="Manage Training" href="/how-to/sms/manage-training">
    Training events from the safety module display on the calendar.
  </Card>
</CardGroup>
