Calendar Feed Integration

What Are Calendar Feeds?

Calendar feeds let you import events from external calendars into CrewHR. This is useful for seeing public holidays, company events, or team calendars alongside your work schedule without manually entering them.

CrewHR supports any calendar that provides an ICS (iCal) feed URL, including Google Calendar, Outlook, and Apple Calendar.

Accessing Calendar Feeds

Navigate to Settings > Calendar Feeds from the settings sidebar.

Adding a Calendar Feed

1. Click Add Calendar Feed
2. Fill in the details:
   • Feed Name (required): A descriptive name like "US Public Holidays" or "Team Events"
   • Feed URL (required): The ICS/iCal URL from your calendar provider
   • Color: Pick a color to distinguish this feed's events on the schedule (8 options: blue, green, red, amber, purple, pink, cyan, lime)
3. Click Test to validate the URL. CrewHR will fetch the feed and show how many events were found.
4. Click Save

Finding Your ICS Feed URL

Google Calendar:

1. Open Google Calendar > Settings > select the calendar
2. Scroll to "Integrate calendar"
3. Copy the "Secret address in iCal format" URL

Outlook / Microsoft 365:

1. Open Outlook Calendar > Settings > Shared calendars
2. Select the calendar and "Publish" it
3. Copy the ICS link

Apple Calendar (iCloud):

1. Open Calendar app > right-click a calendar > Share Calendar
2. Check "Public Calendar"
3. Copy the URL

Managing Feeds

The calendar feeds page shows all your feeds in a table with:

• Feed name
• ICS URL (truncated, with a link to the full URL)
• Color indicator
• Status badge (Active or Inactive)

Editing a Feed

Click the edit action on any feed to change its name, URL, or color.

Toggling Active/Inactive

Use the toggle to quickly show or hide a feed's events on the schedule without deleting the feed. This is useful for temporarily hiding a calendar during busy scheduling periods.

Deleting a Feed

Click delete and confirm. The feed and all its imported events are removed from your schedule views.

How Feeds Appear on the Schedule

Events from active calendar feeds are displayed on the scheduler alongside employee shifts. Each feed's events appear in the color you chose, making it easy to distinguish external events from scheduled shifts.

Tips

• Test before saving: Always use the Test button to verify your feed URL works and shows the expected number of events
• Use colors strategically: Pick a distinct color for each feed so events are easy to identify at a glance
• Disable instead of delete: If you temporarily do not need a feed, toggle it inactive rather than deleting it