Shortcodes, Widgets & Sidebars

Widgets »Upcoming Events

Upcoming Events is a widget and a shortcode. It allows you to use an iCalendar link to display a list of events on your WordPress.com site. This feature can be used for any kind of event list, but it was created especially with musicians in mind so they can rock the web with a list of tour dates. Rock on!

Here is an example of an embedded events list. Note that the styling will vary depending on your theme.

First, you will need to get an iCalendar link. Google Calendar is a free calendar application from Google you can use to create a calendar and get an iCalendar Feed URL.

  1. Access your Google Calendar and click on the little arrow next to your calendar name and select the settings link.GoogleCalendarSettings copy
  2. Click on the name of the calendar you want to embed (Tasks, in this example).GoogleCalendarSelectCal copy
  3. Click on the green ICAL button (next to Calendar Address).
    ICAL
  4. Copy and paste the code that displays (it will begin with “http” and end with “.ics”).
  5. Make sure your calendar is public in the “Share this Calendar” section or WordPress.com will not be able to see the calendar to embed it.

↑ Table of Contents ↑

Events List Shortcode

You can embed list of events into a post or page by using an iCalendar Feed URL and a shortcode.

  1. Add the following shortcode into your post:[upcomingevents url="ICALENDARFEEDURL"]
  2. Replace “ICALENDARFEEDURL” with your iCalendar Feed URL. Make sure you’ve included quotes around the link in the shortcode.
  3. To limit how many events appear, you can add a number parameter to the shortcode such as number=”3″.

Example:

No upcoming events

* When you make changes to a Google Calendar that has already been embedded, it will take up to an hour for the changes to show up in your blog.

↑ Table of Contents ↑

Events List Widget

  1. Go to Appearance → Widgets in your blog Dashboard
  2. Drag the Upcoming Events widget into a widget area
  3. Copy your iCalendar Feed URL as prompted into the widget and save

* When you make changes to a Google Calendar that has already been embedded, it will take up to an hour for the changes to show up in your blog.

↑ Table of Contents ↑

Embedding a Google Calendar

If you want more than just a list, feel free to embed a Google Calendar.

↑ Table of Contents ↑

Frequently Asked Questions

Why aren’t my calendar changes showing up right away? Calendar .ics files aren’t updated immediately by providers such as Google Calendar, so there could be a delay because of that. In addition, WordPress.com caches the calendar data for one hour. So if you don’t see calendar changes right away, wait a bit to give the data enough time to get caught up.

Are recurring events supported? Yes, however, some calendar programs may not save the data in a format our parser can understand. In most cases, problems happen to data imported from an outside sources and so completely deleting and re-creating the recurring event using a major service such as Google Calendar or Apple Calendar on iCloud should resolve the problem.

Not quite what you're looking for?

Get Help