ICS Help & Guides
Practical guidance for fixing broken ICS files, resolving calendar import failures, preserving event behavior during migrations, and generating compatible iCalendar data.
Fix an ICS import problem
Start with the broad error router or match your current symptomCalendar apps
Route Google Calendar, Outlook, and Apple Calendar import behaviorTime zones and recurring-event behavior
Fix wrong event times, invalid TZIDs, missing VTIMEZONE, and DST-related failuresCalendar migrations
Preserve events, recurrence, and time zones when moving calendar historyOpen and understand ICS files
File basics, calendar import steps, and validation workflowsDevelopers and iCalendar format
Generate, debug, and validate ICS files in production workflowsGetting started
The basics
- What is an .ics? It’s a calendar file format that stores events. Most calendar apps (Google, Outlook, Apple) can import it.
- Validate & fix a file: Go to /fix, upload your
.ics, review the results, and click Download fixed file if offered. - Is it safe? Ordinary anonymous validation runs in memory. Saved repairs and large asynchronous jobs use temporary storage with limited retention. See Support for file-handling routes.
Popular how-tos
- Export from Google: Calendar settings → your calendar → Export → download
.ics. - Export from Outlook: File → Open & Export → Import/Export → Export to a file → choose iCalendar (.ics).
- Export from Apple Calendar: Select calendar → File → Export → Export… → save
.ics. - Merge multiple .ics: Zip them and use the Bulk tab on /fix, or open each file in a text editor and copy events together.
- Inspect events: Open the file in a text editor; each
BEGIN:VEVENT…END:VEVENTblock is one event.
Troubleshooting
Common error types explainedDTSTART / DTEND issues
Events need valid start and end values. Missing, malformed, or inconsistent timestamps are one of the most common reasons an ICS file fails to import.
TZID problems
Time zones need valid identifiers like America/New_York. Aliases, abbreviations, or missing VTIMEZONE blocks often cause cross-calendar failures.
RRULE errors
Recurring events need valid recurrence rules such as FREQ=DAILY. Broken RRULE values may import partially, repeat incorrectly, or be rejected outright.
UID / PRODID missing
Missing IDs can make events hard to track or de-duplicate. CorrectICS can generate safe defaults when repair is possible.
CorrectICS website and account support
Account, billing, privacy, API access, status, and contact routingStill need help?
Send us a message and include your X-Request-Id if you have one.