Import Events from a CSV File


Get VueMinder

Free Download Buy Now

How to get here...

  • Click the "Import Events" command on the File menu.
  • Right-click the Calendar List and select "Import Events" from the popup menu.
  • Drag-and-drop a file having a .csv extension into the main window.


VueMinder can import events from CSV files, which are text files with values separated by commas. The first line needs to be a header, defining the field names of the data in the following lines. See below for a list of valid field names.

To import from a CSV file, click the "Import Events" command on the File menu. CSV files can also be dragged-and-dropped into the main window to initiate importing.

The import calendar window.

Selecting a File to Import

To pick a CSV file to import, select "CSV File" as the import source and then click the Next button. A window will appear where the CSV file can be selected. After selecting the file, click the Open button to continue importing.


After selecting the CSV file to import, the window will update to enable specification of the desired destination calendar and settings.

Field Name Mappings

After you've selected a file to import and a destination calendar, click the Next button. The window will update to show a mapping of input fields to destination fields. In most cases, VueMinder will guess the destination field based on the input field name. If VueMinder is unable to make an appropriate guess, the destination field will be blank when using the Pro version. When using the Ultimate version, the destination field will map to a custom field. If the custom field hasn't already been defined, it will be highlighted yellow to indicate the field will be created during the import. A field mapping selection can be made by clicking the drop-down button, where a list of all supported field names will be shown.

Supported Field Names

The following "To Fields" are supported. Most of these are optional. The only fields that must be present are "Title" and "Start". Also, since these fields might not be applicable to every event, you can leave the value blank to have the field ignored for a particular event.

Title – The event title text.

Location – The event location text.

Category – The event category. If there are multiple categories, separate them with semicolons. Example: "Work; Important; Follow-up"

Calendar – The event calendar. If not specified, the imported event will be assigned to the "Destination calendar" selected in the Import window. Otherwise, this will override the selected destination calendar.

Description – The event description text. This is plain text, but can include HTML tags.

– The event priority. Example: "High".

Start – The event starting date and time. For an all-day event, just the date is needed. The format should match the date/time format used for events in Windows, based on your regional settings.

End – The event ending date and time. If this isn’t specified, the Duration field will be used. If the Duration field is also not specified, the event will be assumed to last all day if the Start field doesn’t include a time of day in it text. Otherwise it will be assumed to be 1 hour in length.

Duration – The duration of the event. It should be formatted as "N span", where N is a number and span is "minutes", "hours", "days", "weeks", or "months". Example: "30 minutes".

All Day – An all-day flag. Values that are blank, "No", or "False" will be treated as non all-day events, while values of "X", "Yes", or "True" will be treated as all-day. The same yes/no value parsing is used for other flag input fields, such as the "Completed" field.

Completed – The event completion flag. When set, the event will be marked as completed.

Popup Reminder Time – The time before the event start that a popup reminder should appear. If blank, there will be no popup reminder. Otherwise, specify the length of time as "N span", similar to the Duration field format. Other time-span fields, such as "Desktop Alert Time" also use this format.

Desktop Alert Time - The time before the event start that a desktop alert should appear. If blank, there will be no desktop alert.

Email Reminder Time – The time(s) before the event start that an email reminder should be sent. If multiple times are desired, separate them with semicolons. The reminder will only be sent to the email address specified in the Email Settings. Additional recipients cannot be specified by the import. This could be improved after I improve the reminder settings to enable direct email addresses instead of needing to be associated with pre-defined contacts.

SMS Reminder Time – The time(s) before the event start that an SMS reminder should be sent, similar to the "Email Reminder Time" field.

Run Program Name – The executable to run, including the full path (if not in the Windows path variable) and filename, when the event starts. This could be used to initiate a backup process, launch a web browser, or whatever else you want to start automatically. Example: "iexplore.exe"

Run Program Parameters – Parameters to pass to the executable specified in the "Run Program Name" field. Example: ""

Recurs Daily – When this flag is set, the event will be imported as a daily recurring event. The first occurrence is specified by the "Start" field.

Recurs Weekly – When this flag is set, the event will be imported as a weekly recurring event. The first occurrence and day-of-week is determined by the "Start" field.

Recurs Monthly – When this flag is set, the event will be imported as a monthly recurring event. The first occurrence and day of month is determined by the "Start" field.

Recurs Yearly – When this flag is set, the event will be imported as a yearly recurring event. The first occurrence and day of year is determined by the "Start" field.

Recurrence – This field can be used as an alternative to the recurrence flag fields like "Recurs Daily". Supported text values are blank, "Daily", "Weekly", "Monthly", or "Yearly".

Font Name – The name of the font, to override the default calendar appearance. Example: "Times New Roman"

Font Size – The size of the font. Example: "12"

Font Color – The color of the event text. All color fields support several formats. These can be "R, G, B", where R, G, and B are each numbers 0 through 255 representing the red, green, and blue components of the color. Example: "128, 200, 30". The format can also be a hex number starting with either "0x" or "#". The bytes are ordered RRGGBB. For example, yellow would be "0xFFFF00". A pre-defined color name can also be specified as text, instead of numerically. Example: "Yellow". To see a list of pre-defined color names, click the drop-down button on any of the color inputs and select the "Web" tab. All the color names specified on that tab can be specified as text when importing.

Background Color 1 – The primary event background color. The format is the same as the other color fields.

Background Color 2 – The secondary event background color, as well as its border color. The format is the same as the other color fields.

Gradient Style – The gradient style used to blend the two background colors together. The value is text. To see a list of supported values, click the Gradient style drop-down button in the appearance settings. Note, if a style as spaces in its name in the drop-down list, the spaces should be removed in the specified import value. Example: "GlassTop".

Import Results

After specifying the field mappings, click the Next button. The CSV file will be imported and a summary of the imported events will be shown. To import another file, click the "Import Another" button. Otherwise, click the Close button to close the Import Events window.

Contact Us

If you have questions that aren't answered here, you can reach our support team at If you're using VueMinder Ultimate you'll have our top priority. Otherwise, we'll reply as soon as all VueMinder Ultimate requests have been completed (and always within 1 business day).


comments powered by Disqus