> 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/show-an-outlook-or-google-calendar-with-ics-links.md).

# Show an Outlook or Google calendar with ICS links

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.

The technicians' visits live in Salesforce, but public holidays and warehouse closures sit in a shared Outlook or Google calendar. The dispatcher needs both on one screen before booking Friday. The Avonni Calendar can read that calendar as an ICS feed and show its events beside your Salesforce events, without copying anything into Salesforce.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fq4oVBQ81kzlpYsmiQzKp%2Fcalendar-show-an-outlook-or-google-calendar-with-ics-links-result.png?alt=media" alt="A Timeline week where the warehouse calendar events Inventory day and Warehouse closed sit on a row named Empty above the three technicians&#x27; visits"><figcaption><p>Events from the .ics file land on their own row, above the team's visits.</p></figcaption></figure>

## Before you start

* A screen flow with an Avonni Calendar that shows your Salesforce events. See [Calendar 101](/flow/tutorials/components/calendar/calendar-101-tutorial.md).
* The calendar to show, in one of two forms:
  * An ICS link. In Outlook, publish the calendar and copy its ICS link. In Google Calendar, copy the **Secret address in iCal format** from the calendar's settings.
  * An `.ics` file, uploaded to Salesforce Files.
* For a link, permission to create a Remote Site Setting in Setup.

{% hint style="warning" %}
Anyone who has an ICS link can read that calendar. Use a shared team calendar rather than a person's own, and don't put the link in a flow that people outside your company can run.
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Allow the calendar's domain (links only)

* In Setup, open **Remote Site Settings** and click **New Remote Site**.
* In **Remote Site URL**, enter the domain of the link, for example `https://calendar.google.com` or `https://outlook.office365.com`.
* Without it, the link can't be read and its events don't appear.
* If the link starts with `webcal://`, replace that part with `https://`.
  {% endstep %}

{% step %}

### Or use an uploaded file

* Upload the `.ics` file to Files and copy its Content Document ID (it starts with `069`).
* The file extension must be `ics`.
* Every user who runs the flow needs access to the file: share it with them or with a library they can open.
  {% endstep %}

{% step %}

### Add the calendar to the component

* In the Component Builder, open the **Properties** tab.
* In the first group, find **ICS Calendar links or Content Document IDs** and add one entry per calendar.
* An entry that starts with `http://` or `https://` is read as a link. Anything else is read as a Content Document ID.
* You can also map a text collection variable that holds the links or IDs.
  {% endstep %}

{% step %}

### Check how the imported events behave

* The component only reads them. Nothing is ever written back to Outlook, Google or the file.
* Recurring events are expanded, so a weekly closure shows every week.
* They belong to no resource, so they sit on an **Empty** row at the top of the timeline, above the technicians. **Hide Empty Resource Events** does not hide them.
* A record filter (Type, for example) hides them. The resource filter does not.
  {% endstep %}

{% step %}

### Save and test

* Save the Component Builder, save the flow and run it in **Debug**.
* The holidays and closures appear next to the team's visits.
* A change made in Outlook or Google appears the next time the screen loads.
  {% endstep %}
  {% endstepper %}

## Troubleshooting

<details>

<summary>No imported event appears</summary>

The calendar shows no error on screen: a calendar that can't be read is skipped, and the other events still load. Check, in order:

* For a link: the Remote Site Setting exists for its domain, and the link starts with `https://`.
* The link returns the calendar file itself. A link to a web page, or a calendar that is no longer published, is refused.
* For a file: its extension is `ics`, and the user running the flow can open it.

</details>

<details>

<summary>The imported events disappear when I use a filter</summary>

Imported events have none of your Salesforce fields, so a filter on a field such as Type leaves them out. Clear the filter to see them again. The resource filter keeps them.

</details>

## Related tutorials

* [Connect multiple data sources](/flow/tutorials/components/calendar/how-to-connect-multiple-data-sources-to-the-avonni-calendar.md): combine several Salesforce objects in one calendar.
* [Filter and search a team calendar](/flow/tutorials/components/calendar/filter-and-search-a-team-calendar.md): how filters and search treat every event.
* [Troubleshoot resources and missing events](/flow/tutorials/components/calendar/troubleshoot-resources-and-missing-events.md): when Salesforce events don't show up either.


---

# 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/show-an-outlook-or-google-calendar-with-ics-links.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.
