Editing Calendar Blocks

Calendar blocks display upcoming events from your organisation's calendar on your website. Hail supports Google Calendar, Microsoft Outlook, Apple iCloud, and generic iCal feeds.

Setting Up Your Calendar Provider

Step 1: Select Your Calendar Type

Choose your calendar provider from the Calendar Type dropdown:

• Google — Google Calendar
• Microsoft — Outlook / Microsoft 365
• Apple — iCloud Calendar
• iCal — Any calendar that provides an iCal (.ics) feed URL

Step 3: Enter Your Calendar Details

For Google Calendar:

Enter your Google Calendar ID or paste a Google Calendar sharing URL or embed code. Hail will automatically extract the Calendar ID for you.

To find your Calendar ID:

Google Calendar

1. Open Google Calendar and click the three-dot menu next to your calendar. 2. Select Settings and sharing. 3. Scroll to Integrate calendar and copy the Calendar ID.

For Microsoft, Apple, or iCal:

Paste your calendar's iCal feed URL. This is typically a URL ending in .ics    or containing /ical/   .

• Microsoft Outlook: In Outlook settings, go to Calendar > Shared calendars > Publish a calendar and copy the ICS link.
• Apple iCloud: In iCloud Calendar, click the share icon next to your calendar, enable Public Calendar, and copy the URL.
• Other providers: Look for an "iCal feed", "Subscribe URL", or "Export as .ics" option in your calendar app's sharing settings.

> Note: The URL must start with https://    or webcal://   . Hail will automatically convert webcal://    links to https://   .

Click Save once your calendar details are entered.

[Screenshot: Organisation settings showing Calendar Type dropdown and URL field]

Creating a Calendar Block

1. Navigate to the Blocks section in the left-hand menu.
2. Click + Block.
3. Select the Calendar style.
4. Enter a title (e.g. "Upcoming Events") and click Create.

Editing Your Calendar Block

Display Variants

Choose how your events are displayed:

Event Limit

Set how many upcoming events to display on your website. Options are 3, 4, 8, or 12 , 20 events.

Events are automatically sorted by date, showing the nearest upcoming events first. Events are pulled from the next 90 days.

How It Works

Once configured, your Calendar block will automatically pull upcoming events from your connected calendar and display them on your website. Events update automatically - there's nothing to manually maintain.

Visitors can click View Full Calendar in the block to see more events.

Block Settings

In the sidebar you can edit:

• Title — The block heading displayed publicly (e.g. "Upcoming Events").
• Description — Internal notes only; not displayed publicly.

At the bottom of the edit screen, you can see any locations where the block is currently in use.

Tips

• The Compact variant works well when you have fewer events; List and Grid suit busier calendars.
• If events aren't appearing, check that your calendar is set to public/shared and that the URL or Calendar ID is correct in your organisation settings.
• For Google Calendar, make sure the calendar is publicly accessible or shared with the appropriate permissions.