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

# Calendar: browse and export your upcoming games

> Browse games on a monthly or weekly calendar grid, filter by role and time, and export approved sessions to Google Calendar, Apple Calendar, or .ics.

The Calendar page gives you a visual overview of upcoming games laid out on a traditional calendar grid. You can browse games by day, filter to just your own sessions, and export any approved game to your personal calendar app — so you never miss a session.

## Viewing the calendar

Open **Calendar** from the main navigation. On desktop, the calendar defaults to a **Month** view. On mobile, it automatically switches to **Week** view for a better reading experience.

### Month view

In month view, each day cell shows up to 4 upcoming game events as colored pills. Games are color-coded by category:

| Category         | Color           |
| ---------------- | --------------- |
| Racquet & paddle | Primary (navy)  |
| Team sports      | Secondary       |
| Lawn & outdoor   | Accent          |
| Cards & tabletop | Success (green) |
| Other            | Muted           |

If a day has more than 4 games, a "+N more" indicator appears at the bottom of the cell. Click any day to see a full list of that day's games in a panel below the grid.

### Week view

In week view, each column represents one day of the current week. Each game is shown as a block with its start time and title. Clicking a day column header selects it and opens the same game list panel below.

### Navigating the calendar

* Use the **‹** and **›** arrow buttons to move backward or forward by one month (in month view) or one week (in week view).
* Click **Today** to jump back to the current date.
* Toggle between **Month** and **Week** with the view tabs (desktop only).

## Filtering calendar games

The Calendar page shares the same filter system as the Browse page. Open the **Search** button in the toolbar to access the filter panel.

<AccordionGroup>
  <Accordion title="Time filter">
    Choose **Upcoming**, **Past**, or **All** to control which games appear on the calendar. "Upcoming" is the default and shows only games whose start time is in the future.
  </Accordion>

  <Accordion title="Role filter">
    Choose **Hosting**, **Joined**, or **All** to limit the calendar to games you are involved in. "All" shows every public game (subject to your other filters), while "Hosting" or "Joined" focuses the view on your personal schedule.
  </Accordion>

  <Accordion title="Sport filter">
    Check one or more sports to show only games for those sports on the calendar.
  </Accordion>

  <Accordion title="Skill level">
    Select a skill level (Casual, Intermediate, Competitive, All Levels Welcome) or leave it at "Any skill" to show all levels.
  </Accordion>

  <Accordion title="Location and radius">
    Set a city and radius to show only games within that distance. You can type a city/state or use **Use my current location** to detect your position automatically. The radius slider runs from 5 to 100 miles.
  </Accordion>

  <Accordion title="Beginner-welcoming">
    Toggle this on to show only games marked as beginner-friendly by the host.
  </Accordion>
</AccordionGroup>

Click **Reset all filters** at the bottom of the filter panel to restore all filters to defaults, including clearing the role filter back to "All" and the time filter back to "All".

## Exporting a game to your calendar

Once a host approves your join request — or if you are the host yourself — you can add the game to your personal calendar app.

<Note>
  Calendar export is available **only** to the host and approved participants. If your request is still pending or you are on the waitlist, the calendar buttons are replaced with the message: "Add to your calendar once the host approves your request."
</Note>

The export options appear in the **Spread the word** section on the game's detail page:

<Steps>
  <Step title="Open the game detail page">
    Navigate to the game from the Calendar, Browse feed, or My Games list.
  </Step>

  <Step title="Find the calendar export buttons">
    Scroll to the **Spread the word** section. If you are the host or an approved participant, you will see two buttons: **Add to Google Calendar** and **Add to Apple Calendar**.
  </Step>

  <Step title="Add to Google Calendar">
    Click **Add to Google Calendar**. A new tab opens on the Google Calendar event-create page with the game title, start and end time, location, and a description pre-filled. If no end time was set by the host, the event defaults to a 2-hour duration. Review and save the event in Google Calendar.
  </Step>

  <Step title="Add to Apple Calendar or Outlook">
    Click **Add to Apple Calendar**. A `.ics` file is downloaded automatically. The filename is the game title with special characters replaced by hyphens (for example, `Friday-Pickleball-at-Riverside.ics`). Open the file to add the event to Apple Calendar, Outlook, or any calendar app that supports the iCalendar format.
  </Step>
</Steps>

<Tip>
  The `.ics` file works with Apple Calendar, Microsoft Outlook, Thunderbird, and most other calendar apps. If you use Google Calendar on desktop, both options produce the same result — use whichever is faster for you.
</Tip>

### What the calendar event contains

The exported event includes:

* **Title** — the game's title
* **Start and end time** — exact times in UTC, converted to your local time zone by your calendar app. If the host did not set an end time, the event ends 2 hours after the start time.
* **Location** — the full address (if you are approved and the address is not hidden), or the city/state
* **Description** — the host's game notes and a direct link back to the game page on Witt & Play