{"id":95,"date":"2022-04-26T22:48:35","date_gmt":"2022-04-26T22:48:35","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar-pro\/?p=95"},"modified":"2022-04-26T22:52:51","modified_gmt":"2022-04-26T22:52:51","slug":"import-events-from-csv","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar-pro\/import-events-from-csv\/","title":{"rendered":"Import Events from CSV"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">A .csv file, or comma separated values file, offers a significantly more flexible way of importing events than the standardized iCal format (.ics). While .ics files are standardized, they&#8217;re also quite limited in how they&#8217;re structured and what information can be included.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The only absolutely required fields are <code>event_title<\/code> and <code>event_begin<\/code>, but you can also automatically generate categories and locations from your CSV import file.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Your CSV file must have a header row that includes the field names as listed below, e.g. &#8220;event_id,event_title,event_begin&#8221;. The header row will be used to map values to My Calendar&#8217;s data structures.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Supported CSV Fields<\/h2>\n\n\n\n<ul>\n<li><code>event_title<\/code>:       Title<\/li>\n<li><code>event_begin<\/code>:       Starting Date<\/li>\n<li><code>occur_begin<\/code>:       Starting Date<\/li>\n<li><code>event_end<\/code>:         Ending Date<\/li>\n<li><code>occur_end<\/code>:         Ending Date<\/li>\n<li><code>event_time<\/code>:        Starting Time<\/li>\n<li><code>event_endtime<\/code>:     Ending Time<\/li>\n<li><code>content<\/code>:           Description<\/li>\n<li><code>event_desc<\/code>:        Description<\/li>\n<li><code>event_short<\/code>:       Excerpt<\/li>\n<li><code>event_link<\/code>:        External event URL<\/li>\n<li><code>event_link_expires<\/code>: Link expiration<\/li>\n<li><code>event_recur<\/code>:       Recurring frequency period: S &#8211; single, D &#8211; day, E &#8211; weekdays, W &#8211; weekly, M &#8211; month\/date, U &#8211; month\/day, Y &#8211; year.<\/li>\n<li><code>event_repeats<\/code>:     Number of repetitions or date to repeat until. 4 = event repeats 4 times, for a total of 5 occurrences. 2022-05-25 means &#8220;repeats until May 25th, 2022&#8221;. <\/li>\n<li><code>event_every<\/code>:       Recurrence frequency multiplier.  D + 3 == every 3 days, 2 + W == every two weeks.<\/li>\n<li><code>event_image<\/code>:       Event Image URL<\/li>\n<li><code>event_allday<\/code>:      Event is all-day<\/li>\n<li><code>event_author<\/code>:      Author ID<\/li>\n<li><code>event_approved<\/code>:    Publishing status<\/li>\n<li><code>event_category<\/code>:    Category Name or ID<\/li>\n<li><code>category_color<\/code>:    Category Color<\/li>\n<li><code>category_icon<\/code>:     Category Icon<\/li>\n<li><code>category_private<\/code>:  Category Privacy status<\/li>\n<li><code>event_fifth_week<\/code>:  Omit week 5 recurrences<\/li>\n<li><code>event_holiday<\/code>:     Cancel on Holidays<\/li>\n<li><code>event_group_id<\/code>:    Event Group ID<\/li>\n<li><code>event_span<\/code>:        Event spans multiple days<\/li>\n<li><code>event_hide_end<\/code>:    Hide end date<\/li>\n<li><code>event_status<\/code>:      Event Status<\/li>\n<li><code>event_flagged<\/code>:     Event Flagged as Spam<\/li>\n<li><code>event_tickets<\/code>:     Event Tickets Link<\/li>\n<li><code>event_registration<\/code>: Event Registration Info<\/li>\n<li><code>event_host<\/code>:        Event Host ID<\/li>\n<li><code>event_access<\/code>:      Event Accessibility Data<\/li>\n<li><code>location_preset<\/code>:   Location ID<\/li>\n<li><code>event_label<\/code>:       Location Label<\/li>\n<li><code>event_street<\/code>:      Location Street<\/li>\n<li><code>event_street2<\/code>:     Location Street (2)<\/li>\n<li><code>event_city<\/code>:        Location City<\/li>\n<li><code>event_state<\/code>:       Location State<\/li>\n<li><code>event_postcode<\/code>:    Location Postcode<\/li>\n<li><code>event_region<\/code>:      Location Region<\/li>\n<li><code>event_country<\/code>:     Location Country<\/li>\n<li><code>event_url<\/code>:         Location URL<\/li>\n<li><code>event_phone<\/code>:       Location Phone Number<\/li>\n<li><code>event_phone2<\/code>:      Alternate Location Phone<\/li>\n<li><code>event_longitude<\/code>:   Location longitude<\/li>\n<li><code>event_latitude<\/code>:    Location latitude<\/li>\n<li><code>event_zoom<\/code>:        Map zoom level<\/li>\n<li><code>event_location<\/code>:    Location ID in locations table<\/li>\n<li><code>mc_copy_location<\/code>:  Copy location into DB<\/li>\n<li><code>UID<\/code>:               Unique event ID. If an event exists with this UID already, it will be updated instead of added.<\/li>\n<li><code>event_added<\/code>:       Date this event was added to source calendar<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>A .csv file, or comma separated values file, offers a significantly more flexible way of importing events than the standardized iCal format (.ics). While .ics files are standardized, they&#8217;re also quite limited in how they&#8217;re structured and what information can be included. The only absolutely required fields are event_title and event_begin, but you can also [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-95","post","type-post","status-publish","format-standard","hentry","category-imports"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/95","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/comments?post=95"}],"version-history":[{"count":5,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/95\/revisions"}],"predecessor-version":[{"id":96,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/95\/revisions\/96"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/media?parent=95"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/categories?post=95"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/tags?post=95"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}