Back to CalendarMap

CalendarMap Documentation

Quick Start

CalendarMap converts CSV files with event data into ICS calendar files that work with Google Calendar, Outlook, Apple Calendar, and other calendar applications.

  1. Upload your CSV file with event data
  2. Map your CSV columns to calendar fields
  3. Validate your data for any issues
  4. Download your ICS calendar file

Required Fields

Title

Required

The event title/summary. Common CSV headers: "title", "event", "summary", "name"

Start Date/Time

Required

When the event starts. Supports various formats including "2025-09-15", "9/15/2025", "Sep 15, 2025"

Common headers: "start", "start_date", "date", "event_date"

Optional Fields

End Date/Time

When the event ends. If not provided, creates a 1-hour event.

Location

Event location. Can be physical address or virtual meeting link.

Description

Detailed event description or notes.

All Day

Mark as all-day event. Use "TRUE", "YES", or "1" for all-day.

Timezone

Event timezone. Defaults to UTC if not specified.

Duration

Event duration in minutes. Alternative to end time.

Supported Date Formats

Date Examples

  • • 2025-09-15
  • • 09/15/2025
  • • September 15, 2025
  • • Sep 15, 2025
  • • 15-Sep-2025

Time Examples

  • • 10:00 AM
  • • 14:30
  • • 2:00 PM
  • • 09:00

Sample CSV Format

Title,Start Date,Start Time,End Date,End Time,Location,Description,All Day
Team Meeting,2025-09-15,10:00 AM,2025-09-15,11:30 AM,Conference Room A,Weekly standup,FALSE
Product Launch,2025-09-18,,,,,Major product release,TRUE
Client Workshop,2025-09-20,2:00 PM,2025-09-20,5:00 PM,Zoom Meeting,Design workshop,FALSE

Troubleshooting

Dates not parsing correctly?

Make sure your date format is consistent throughout the CSV. Mix of formats can cause parsing issues.

Events not showing in calendar?

Check that your events have both a title and start date. These are required for valid ICS files.

Timezone issues?

If not specified, events default to UTC. Add a timezone column with values like "America/New_York" for proper timezone handling.