> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/reference/operations/calendar.md).

# Calendar

The calendar shows time-based activity for your solution. It plots [service schedules](/reference/operations/schedules.md) and [flow schedules](/reference/flows/schedules.md) alongside past and scheduled [deploys](/reference/operations/deploy.md) and Appfarm platform maintenance windows on a day, week, or month grid.

The calendar is read-only. Click any entry to open a popover with its details and a button to navigate to its source.

<figure><img src="https://29237295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiLU-xcHu0eLZiTxcmZ%2Fuploads%2FgpOwUGa869hNl3WALO8p%2Fimage.png?alt=media&amp;token=5beb6c3b-d468-4d0d-bf3a-7469d0683305" alt=""><figcaption><p>The Calendar in Appfarm Create</p></figcaption></figure>

## Views

The selector in the top-right of the toolbar switches between **Day**, **Week**, and **Month**. All three views show the same items at different time resolutions.

**Today** returns the calendar to the current date. The arrow buttons step forward and back by the selected resolution.

## Filters

Two drop-down menus in the toolbar narrow down which entries the calendar shows. Filters apply to the day, week, and month views.

**All sources** filters by entry type. Select one or more of:

* **Flow schedules**
* **Service schedules**
* **Deployments**
* **Maintenance**

**All Flows and Service** filters schedule entries by the flow or service they belong to. The list is grouped under **Flows** and **Services**, includes a search field, and shows only flows and services with schedules. Selecting a flow shows the schedules of all flow actions in that flow. Deploys and maintenance windows are not affected by this filter.

In both menus, **Show all** clears the selection and shows all entries again.

## What appears on the calendar

Items from every [environment](/reference/configuration/environments.md) are shown together on a single calendar.&#x20;

### Schedules

Service and flow schedules appear at the times they are configured to run, along with a description of the schedule and its time zone.

Service schedules have their own name. The calendar entry shows the schedule name, marked with a yellow dot. Flow schedules do not have a name; the calendar entry shows the name of the [flow](/reference/flows.md) [action](/reference/actions.md) that is scheduled, marked with a blue dot. A flow action can carry multiple schedules — each appears as its own entry in the calendar.

The popover shows the schedule description, the time zone, and the parent service or flow as a link. **Go to Schedule** opens the schedule itself.

If a schedule runs more than once within an hour, a multiplier is appended to the entry — for example, `(2×)` or `(30×)` indicates 2 or 30 runs within that hour.

Disabled schedules still appear on the calendar, but are grayed out.

Schedule entries are plotted on the calendar grid using your system time zone. The time zone shown in the entry label — for example `(Europe/Oslo)` — is the schedule's own configured time zone, which is the basis for when it actually runs.

### Deploys

Both completed and scheduled deploys are shown on the calendar. Completed deploys are labeled **Deployed to** the target environment — for example, **Deployed to Test**. Scheduled deploys are labeled **Deploy to** the target environment — for example, **Deploy to Staging**. The popover shows the time of the deploy, and **Go to Deploy** opens the [Deploy](/reference/operations/deploy.md) page.

### Scheduled maintenance

Maintenance windows announced by Appfarm for the platform appear at their planned time. The popover links to the [Dashboard](/reference/dashboard.md), where details are listed.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appfarm.io/reference/operations/calendar.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.