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

# Calendar

Step-by-step tutorials for the Avonni Calendar in Screen Flows, from a first team calendar to drag and drop booking, filters and troubleshooting.

The Avonni Calendar puts your Salesforce records on a schedule inside a screen flow: one row per technician, room or team, with their visits for the day, week or month. These tutorials follow one field service team through a week of visits, from the first calendar to booking and moving visits on it.

{% hint style="info" %}
New to the Calendar? Start with [Calendar 101](/flow/tutorials/components/calendar/calendar-101-tutorial.md). Every setting is described on the [Calendar reference page](/flow/flow-components/calendar.md).
{% endhint %}

## Get started

Put your records on the calendar, from one collection, a query or several objects.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Calendar 101</strong></td><td>Build a team calendar in a screen flow from a Get Records collection, with one row per technician and their visits for the week.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fvd445VqERc0fs7UzBA8S%2Fcalendar-cover-calendar-101-tutorial.png?alt=media">calendar-cover-calendar-101-tutorial.png</a></td><td><a href="/flow/tutorials/components/calendar/calendar-101-tutorial.md">Calendar 101</a></td></tr><tr><td><strong>Use a Query data source</strong></td><td>Point the Avonni Calendar at Event records with a Query data source, filter and sort the visits, and refresh the calendar after a change.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F4fZbD9Ut5aRvp2OCucRV%2Fcalendar-cover-using-a-query-data-source.png?alt=media">calendar-cover-using-a-query-data-source.png</a></td><td><a href="/flow/tutorials/components/calendar/using-a-query-data-source.md">Use a Query data source</a></td></tr><tr><td><strong>Connect multiple data sources</strong></td><td>Show visits and work orders on one Avonni Calendar by combining several record collections into one event collection with a flow action.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FhczPfGov8yadT2YAtOLQ%2Fcalendar-cover-how-to-connect-multiple-data-sources-to-the-avonni-calendar.png?alt=media">calendar-cover-how-to-connect-multiple-data-sources-to-the-avonni-calendar.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-connect-multiple-data-sources-to-the-avonni-calendar.md">Connect multiple data sources</a></td></tr></tbody></table>

## Shape the calendar

Choose the stretch of time people see, the hours they can book and the outside calendars shown next to yours.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Customize the time spans</strong></td><td>Add your own views to the Avonni Calendar, such as 3 days or 2 weeks, so a dispatcher sees exactly the stretch of time they plan each week.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FLWLh5gDa8rcoOIyFa3KO%2Fcalendar-cover-how-to-customize-time-spans.png?alt=media">calendar-cover-how-to-customize-time-spans.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-customize-time-spans.md">Customize the time spans</a></td></tr><tr><td><strong>Block past dates and limit working hours</strong></td><td>Show only the team's working days and hours on the Avonni Calendar, and stop users from creating or moving an event into the past.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F3BK7vUiqLCpZ18Oae0tt%2Fcalendar-cover-block-past-dates-and-limit-working-hours.png?alt=media">calendar-cover-block-past-dates-and-limit-working-hours.png</a></td><td><a href="/flow/tutorials/components/calendar/block-past-dates-and-limit-working-hours.md">Block past dates and limit working hours</a></td></tr><tr><td><strong>Show an Outlook or Google calendar with ICS links</strong></td><td>Show a shared Outlook or Google calendar next to your Salesforce events in the Avonni Calendar, from an ICS link or an uploaded .ics file.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F0iTMVn0q32jFPqF2XMKk%2Fcalendar-cover-show-an-outlook-or-google-calendar-with-ics-links.png?alt=media">calendar-cover-show-an-outlook-or-google-calendar-with-ics-links.png</a></td><td><a href="/flow/tutorials/components/calendar/show-an-outlook-or-google-calendar-with-ics-links.md">Show an Outlook or Google calendar with ICS links</a></td></tr></tbody></table>

## Create and edit events

Let people book, move and edit visits right on the schedule.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create an event by dragging and save it</strong></td><td>Let a dispatcher draw a time range on the Avonni Calendar and save it as a new Event, with the start and end already filled in from the drag.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FJK0TvbxxoAgLS5TNGKDP%2Fcalendar-cover-how-to-create-events-by-dragging-in-the-avonni-calendar.png?alt=media">calendar-cover-how-to-create-events-by-dragging-in-the-avonni-calendar.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-create-events-by-dragging-in-the-avonni-calendar.md">Create an event by dragging and save it</a></td></tr><tr><td><strong>Reschedule events with drag and drop</strong></td><td>Let a dispatcher drag a visit to a new time on the Avonni Calendar and save the new start and end on the Event record, with a clear result when the save fails.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Ft95eIab4KlA6qJ4LDqKG%2Fcalendar-cover-how-to-reschedule-events-with-drag-and-drop.png?alt=media">calendar-cover-how-to-reschedule-events-with-drag-and-drop.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-reschedule-events-with-drag-and-drop.md">Reschedule events with drag and drop</a></td></tr><tr><td><strong>Add a New Event button to the header</strong></td><td>Add a New visit button to the Avonni Calendar toolbar that opens the New Event page, so dispatchers can book a visit without dragging on the schedule.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FztJqvOxpszaWevuuo4Lx%2Fcalendar-cover-how-to-add-a-new-event-button-to-the-avonni-calendar-header.png?alt=media">calendar-cover-how-to-add-a-new-event-button-to-the-avonni-calendar-header.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-add-a-new-event-button-to-the-avonni-calendar-header.md">Add a New Event button to the header</a></td></tr><tr><td><strong>Add actions to events</strong></td><td>Add an Edit action to each event and a New visit action to empty spots of the Avonni Calendar, so dispatchers act on the schedule without leaving it.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FPPFNCriefvD5qHzSkzV4%2Fcalendar-cover-how-to-customize-the-right-click-menu.png?alt=media">calendar-cover-how-to-customize-the-right-click-menu.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-customize-the-right-click-menu.md">Add actions to events</a></td></tr></tbody></table>

## Read a busy calendar

Make a full week easy to scan, find one person fast and fix what does not show.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Color-code calendar entries</strong></td><td>Give each type of event its own color in the Avonni Calendar with a formula field on Event, or color the calendar by technician with a palette.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FGzutY4obAr5SButmhxCf%2Fcalendar-cover-how-to-color-code-calendar-entries-in-the-avonni-calendar.png?alt=media">calendar-cover-how-to-color-code-calendar-entries-in-the-avonni-calendar.png</a></td><td><a href="/flow/tutorials/components/calendar/how-to-color-code-calendar-entries-in-the-avonni-calendar.md">Color-code calendar entries</a></td></tr><tr><td><strong>Filter and search a team calendar</strong></td><td>Add resource filters, record filters, a search bar and a side panel to the Avonni Calendar, so a dispatcher finds one technician's day in seconds.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FiY6ZvJZSP3NWRetkqXeG%2Fcalendar-cover-filter-and-search-a-team-calendar.png?alt=media">calendar-cover-filter-and-search-a-team-calendar.png</a></td><td><a href="/flow/tutorials/components/calendar/filter-and-search-a-team-calendar.md">Filter and search a team calendar</a></td></tr><tr><td><strong>Troubleshoot resources and missing events</strong></td><td>Find out why the Avonni Calendar shows an Empty row or leaves events out, check mappings, dates, time zone and hours, and hide unassigned events.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FhIGVvPqKnzz8O6fLkwFc%2Fcalendar-cover-troubleshoot-resources-and-missing-events.png?alt=media">calendar-cover-troubleshoot-resources-and-missing-events.png</a></td><td><a href="/flow/tutorials/components/calendar/troubleshoot-resources-and-missing-events.md">Troubleshoot resources and missing events</a></td></tr></tbody></table>

Something does not show up as expected? See [Troubleshoot resources and missing events](/flow/tutorials/components/calendar/troubleshoot-resources-and-missing-events.md).


---

# 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.avonnicomponents.com/flow/tutorials/components/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.
