Tutorial · Configuration and staff

Import an iCal calendar

Upload an .ics file or read an iCal URL, select events, and apply place, type and colour before importing.

8 minVerified on 25 Sept 2026Leaders and office staffAvailable: every imported appointment counts toward the monthly allowance
1Step 1 of 6 · 1 min

Open the importer

Open Calendar in the correct scope and select Import in the toolbar. The control appears only where you can manage appointments. In a bulk-operation Pastoral Unit, permission on at least one community is enough to open it, but you can import only into authorized destinations.

Fig. 1Import opens the iCal flow in the active calendar scope.
2Step 2 of 6 · 2 min

Choose a file or URL

At the Upload step, choose File and select a document with an .ics extension. The browser rejects other files and files over 5 MB. After reading it, the flow advances automatically to Configure when it finds at least one valid event.

Alternatively open URL, paste the subscription link and select Upload. Only public HTTP or HTTPS addresses are accepted. The service rejects local or private hosts, redirects, unreachable responses, content without VCALENDAR and responses over 10 MB.

Fig. 2File reads an .ics document from the device; URL reads a calendar from a public web address.
3Step 3 of 6

Check the link before loading

Check that the link starts with HTTP or HTTPS and points directly to the public calendar. Select Upload after checking it; the illustrated address is an example.

Fig. 3The example address uses the required format: it has not been retrieved and no appointment has been imported.
4Step 4 of 6 · 2 min

Filter the events to import

Under Configure, From initially uses the current day; earlier events stay hidden and are removed from the selection. You can add a To date and search by title. When a filter hides an event, that event is not imported.

Review the checkboxes in the list. Visible events are selected automatically after loading; use Select all or clear items that you do not want to create. The recurrence icon identifies events that have a repeat rule in the file.

5Step 5 of 6 · 2 min

Map place, type and colour

Under Map events, you can choose one Place of worship, Type and Colour for the batch. These choices apply to every selected event. Without changes, MiaChiesa uses Special Event and blue. From the file it keeps the title, description, dates and times; for recurring events it keeps only the basic frequency (daily, weekly, monthly or yearly) and the end date. A series that ends “after N occurrences” gets the date of its last occurrence as its end.

Choosing a place of worship replaces the textual iCal location. Without that choice, a location from the file becomes a custom place; when it is absent, the appointment has no place. Imported items are created with Public visibility and an ICS File source.

6Step 6 of 6 · 1 min

Import and check the result

Select Import followed by the selected event count. The insert is one operation: if it fails, none of the batch is created. A merged Pastoral Unit receives one Unit-owned copy; in bulk mode, each event is duplicated into the selected authorized communities.

After confirmation, use the Source filter and choose ICS File to isolate the imported appointments. Check the title, date and place on several items before treating the operation as complete.

What you have achieved

  • The selected events have been created in the calendar with the chosen mapping.
  • Imported appointments can be identified with Source → ICS File.

Troubleshooting

The file is not accepted

Check that its name ends in .ics, it is no larger than 5 MB and it contains at least one valid iCalendar event. A calendar with no events shows a dedicated message.

The URL is valid but the calendar cannot be retrieved

Use a public HTTP or HTTPS link that returns iCal content directly. Local or private hosts, redirects, timeouts, responses over 10 MB and content without VCALENDAR are rejected.

Some events are missing from the selection

Review From, To and the title search. Events hidden by the filters are removed from the selection and will not be imported.

The import creates no appointments

Confirm that at least one event and an authorized destination are selected. The monthly allowance does not block a file import. The insert is a single operation, so one error prevents the whole batch from being created.

An imported series repeats on the wrong days

The import keeps only the basic frequency and the end date. Open the appointment, choose Custom under Recurrence, set the interval, days and excluded dates, then save.