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

  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 Web part edit button  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.

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.

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.

    alternate text

  3. Select Audience targeting settings from the settings list.

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

    alternate text

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

    alternate text

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

  7. Click the Edit web part Web part edit button  icon on the left to set options for the web part.

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

    alternate text

  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.

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

What affected your experience?

Thank you for your feedback!