Skip to main content

iCal feeds

In this article

iCal feeds allow you to synchronise your MyHallWizard bookings with other calendar applications such as Google Calendar, Apple Calendar, or Microsoft Outlook. This is a one-way sync — changes made in MyHallWizard are reflected in the external calendar, but not the other way around.

Note: iCal feeds are not available on the Free Tier. You need a paid subscription to use this feature.

Setting Up an iCal Feed

Step 1: Create a Feed in MyHallWizard

To set up an iCal feed, go to Settings > Integrations > iCal. Click New Feed and configure which rooms and booking information to include.

Complete the fields as follows:

  • Name - give your feed a name. Make it different to other feeds you have already set up.

  • Bookings to include - these describes which bookings are going to appear in your feed - how far into the future, and how far in the past. We don't recommend you make these figures too large, as this affects the performance of your feed.

  • Rooms - by default, the feed will include bookings in all rooms. However, if you want to restrict it to bookings in specific rooms, select them here.

  • Private details - we recommend that you hide private details, for example if the feed is going to be used to show bookings publicly. If you change this setting to show private details, please ensure you keep the URL of the iCal feed confidential, as anyone with the URL will be able to see your customers' data.

  • Provisional bookings - use this switch to indicate whether or not you want to include provisional bookings in the feed.

  • Description - use this to describe what you want in the DESCRIPTION field of your feed. Select Details if you want the contents of the Details field to be sent, or Nothing if you want the DESCRIPTION field left blank. If you are hiding private details, the Details will not be sent if the booking is private.

  • Images in Details - you can exclude any embedded images in the Details field. This is because they can sometimes cause Out of Memory errors to occur, preventing your feed from working. We strongly advise leaving this set to Exclude Images.

  • Cancelled Bookings - the iCal standard states that when a booking is cancelled, it should still be included in the feed, but marked as STATUS:CANCELLED. Many applications honour this, however we found that some applications don't follow the standard; this means they continue to show your cancelled booking. To overcome this, you can set the iCal feed to remove cancelled bookings from the feed. You should select this option if you are using Google Calendar, Apple Calendar or Microsoft Outlook, or if you find that the downstream application does not remove cancelled bookings from its calendar.

Click Create Feed to save your data and create the iCal feed.

Step 2: Subscribe in Your Calendar Application

Copy the feed URL from MyHallWizard and add it as a calendar subscription in your preferred application:

  • Google Calendar: Settings > Add other calendars > From URL

  • Apple Calendar: File > New Calendar Subscription

  • Microsoft Outlook: Add Calendar > Subscribe from web

The calendar application will periodically check the feed for updates and display your bookings automatically.

Using iCal Feeds with RemoteLock

iCal feeds are also used by the RemoteLock integration for keyless entry. See RemoteLock for details.