Sign in with Microsoft
Sign in or create an account.
Select a different account.
You have multiple accounts
Choose the account you want to sign in with.

When you add a modern page to a site, you add and customize web parts, which are the building blocks of your page. This article describes the Events web part, which allows you to easily display upcoming events on your page.

Note: Some functionality is introduced gradually to organizations that have opted in to the Targeted Release program. This means that you may not yet see this feature or it may look different than what is described in the help articles.


Add the Events web part

Add an event

Add the Events web part

Note: Recurring events are not supported, even if you manually set up a recurrence in the events list that you are using. You'll need to create a new event for each occurrence or, if you are setting up events for an Office 365 group on a team site, use the Group calendar web part.

  1. If you're not in edit mode already, click Edit at the top right of the page.

  2. Hover your mouse above or below an existing web part or under the title region, click Circled plus sign used to add a modern web part to a page, and then select the Events web part.

  3. Click the Edit web part Screenshot of Edit pencil icon icon on the left to set options for the web part.

  4. Select a Source for your events: Events list on this site, This site, This site collection, Select sites, or All sites. If your site is connected to a hub site, you will also have an option to select All sites in the hub or Select sites from the hub.

    Select a source for Events


    • When you chose Select sites, you can search for the site you want to add, or select one or more sites from Frequent sites, or Recent sites. You can select up to 30 sites.

      • The Select sites option is not available in SharePoint Server, U.S. Government GCC High and DoD, and Office 365 operated by 21Vianet.

    • Events list: If there is more than one events list on the site, you can select the one you want. If you don't have an existing list, the Events web part creates an empty Events list for you, with the default settings of a Calendar list.

    • If you choose to show events from multiple sites, and don't see all of your events displayed on the page, see How events from multiple sites are found and displayed.

  5. If your list has categories, you can select one by which to filter the events you show.

  6. Select a date range by which to filter your events in the Date range drop-down list . You can choose All upcoming events (the default), This week, Next two weeks, This month, or This quarter.

  7. Select a layout: Filmstrip or Compact.

    Layout selection in Events web part property pane.

Add an event

On a published page, you can start adding events.

Note: You can add events on a saved or published page, but not on a page that is in edit mode.

  1. Click Add event.

  2. Give your event a name at the top of the page. Optionally, you can add an image to the title area by clicking the Add image button in the upper left.

    Event page
  3. Choose date and times in the When section.

  4. In the Where section, enter a location or address. If your location is recognized, you have the option to add a map.

  5. In the Link section, you can enter an online meeting link if you have one. Put the link in the Address box, and then add a Display name. If you don't have an online meeting and enter nothing, this section will not appear in the event.

  6. Choose a Category (such as Meeting, Work hours, Business, Holiday, and so on) if you want the event to show when filtered by that category. To add your own category, just enter it in the space.

  7. Provide a description in the About this event area.

  8. If you have people you'd like to highlight for this event (such as contacts, special guests, or speakers) you can add their names below the event description. Only users within your organization can be added.

  9. When you're done, click Save.

Edit an event

Once you've saved the event, you can edit it on the event page. 

  1. Select See all in the right-hand corner of the Events web part to navigate to the event page.

  2. Or, access the event page by selecting Settings, then Site contents, and then select your event in the Event list.

  3. Select the event you want to edit and select Edit at the top right of the event page.

  4. Select Save when you are done.

Audience targeting

By using audience targeting, you can highlight content to specific groups of people. This is useful when you want to present information that is most relevant to a particular group of people. For example, you can target events to team members and stakeholders that would be most interested.

To use audience targeting, first enable audience targeting for the event list in the site's document library, then select your audience, and then enable audience targeting in the Events web part. 

Note: If you've selected an audience group that you recently created or changed, it may take some time to see targeting applied for that group. 

  1. From your site's home page, select Settings and then Site content.

  2. Hover over Events, select the ellipses (...) and then Settings.

  3. Select Audience targeting settings from the settings list.

  4. Select the checkbox to Enable audience targeting then select OK.

  5. Edit the event page. Add up to 50 groups in the Audience section. Then select Save.

  6. Go back to the page where you placed the web part.

  7. Click the Edit web part Screenshot of Edit pencil icon icon on the left to set options for the web part.

  8. In the property pane slide the Enable audience targeting toggle to ON.

  9. Republish the page for changes to audience targeting to take effect. If you've applied an audience group that you recently created or changed, it may take some time to see targeting applied for that group.

  10. Confirm audience targeting has been applied to select events by viewing the Events web part in Edit mode and you will see the shared content symbol in the bottom right corner of the event card  Image of the edit pane with the text box in which to set target audiences.

Caching of search results

It is recommended to enable group-level caching of search requests on Events or Highlighted Content web parts, especially for popular home pages or on category pages that are starting points for navigating to more detailed pages. After being enabled, the web part will first look in the cache for existing search results that match the query and the security group(s). If it doesn't find any search results in the cache, it will look in the search index.

  1. Go to the site page that contains an Events web part.

  2. Select Edit to edit the site page.

  3. Select the Events web part and then select Edit web part Screenshot of Edit pencil icon.

  4. In the web part settings pane, scroll to the Group-level caching setting.

  5. Specify the security group(s) by entering a group name or email. The search results will be cached for all users who belong to the same security group(s) and will improve performance.

    Preview of the Enable caching for group option.

  6. Republish your SharePoint site page.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.

Was this information helpful?

What affected your experience?
By pressing submit, your feedback will be used to improve Microsoft products and services. Your IT admin will be able to collect this data. Privacy Statement.

Thank you for your feedback!