Support Home > Utilities > Upcoming Events Widget

Upcoming Events Widget

Display a list of events on your site by using an iCalendar link with the Upcoming Events widget and shortcode.

Before you add the widget, you’ll need an iCalendar URL. 

Google Calendar is a free calendar application that you can use to create a calendar and get an iCalendar URL.

To get your Google Calendar URL, follow these steps:

  1. Access your Google Calendar and click on the little arrow next to your calendar name.
  2. Select Settings.
  3. Click on the calendar name you want to embed.
  4. Click on the green ICAL button.
  5. Copy and paste the link that displays.

Make sure your calendar is public in the “Share this Calendar” section, or your site will not be able to see the calendar to embed it.

Events List Widget

To adda list of upcoming events using the Upcoming Events widget, follow these steps:

  1. Visit your dashboard.
  2. Navigate to Appearance → Customize → Widgets and search for “Upcoming Events”.
  3. Click to add it to any widget area.
  4. Add a Title for the widget, or leave it blank.
  5. Copy your iCalendar Feed URL into the widget.
  6. Choose how many items to show in your feed from the Items to show dropdown.

Events List Shortcode

To embed a list of events into a post or page using the Upcoming Events shortcode, follow these steps:

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

Example:

[upcomingevents number=3 url="http://www.google.com/calendar/ical/ht3jlfaac5lfd6263ulfh4tql8%40group.calendar.google.com/public/basic.ics"]

Troubleshooting

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. WordPress.com also caches the calendar data for one hour.

If you don’t see calendar changes immediately, wait a couple hours in order 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 that Jetpack’s parser can understand.

In most cases, deleting and re-creating the recurring event using a major service such as Google Calendar or Apple Calendar on iCloud should resolve the problem.

Why are the event times in the widget wrong?

The Upcoming Events widget adjusts your event times to match your site’s timezone. 

If the times in your calendar are correct, your site may not be set to the correct timezone. You can change the Site Timezone setting in your site’s General Settings. Choose a city in your timezone to make sure your site automatically adjusts to daylight saving time.

Still need help?

Please contact support. We’re happy to advise.

  • Table Of Contents

  • Contact Us

    Need more help? Feel free to contact us.