{"id":15508,"date":"2026-03-10T19:21:34","date_gmt":"2026-03-10T23:21:34","guid":{"rendered":"https:\/\/www.med.unc.edu\/webguide\/?page_id=15508"},"modified":"2026-03-12T09:48:40","modified_gmt":"2026-03-12T13:48:40","slug":"display-events","status":"publish","type":"page","link":"https:\/\/www.med.unc.edu\/webguide\/userguide\/news-events\/events\/display-events\/","title":{"rendered":"Display Events"},"content":{"rendered":"<p>There are several ways to display events on your site.<\/p>\n<p>Sites that publish events typically add a link to the default events calendar page in their top navigation, and then use one of the shortcode options described below to display upcoming events on key pages such as the home page.<\/p>\n<hr  style=\"margin:40px 0\"class=\" rule-thin osc-rule\" \/>\n<h2>Default Events Calendar Page<\/h2>\n<p>When the plugin is enabled, it automatically creates a calendar page located at:\u00a0<strong>site-url\/events<\/strong>. For example:<\/p>\n<ul>\n<li>https:\/\/www.med.unc.edu\/neurology\/events<\/li>\n<li>https:\/\/unclineberger.org\/events<\/li>\n<\/ul>\n<p>By default, this page displays all events in a calendar view. Since many SOM sites have relatively few events, we recommend changing the display to List View, which is often easier for visitors to browse.<\/p>\n<div class=\"row  oscitas-bootstrap-container\">\n<div class=\"col-lg-6 col-md-12 col-xs-12 col-sm-12 oscitas-bootstrap-container\">\n<p>The <strong>Month View<\/strong> displays events on a traditional calendar grid, allowing visitors to see events organized by day across an entire month. This view works well for sites with many events spread throughout the month.<\/p>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15539\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view.png\" alt=\"Screenshot of the event calendar in the month view, links to full-size image.\" width=\"500\" height=\"563\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view.png 1129w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view-266x300.png 266w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view-910x1024.png 910w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view-768x865.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view-600x675.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-month-view-560x630.png 560w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><\/a><\/span><\/p>\n<\/div>\n<div class=\"col-lg-6 col-md-12 col-xs-12 col-sm-12 oscitas-bootstrap-container\">\n<p>The <strong>List View<\/strong> displays events in chronological order, similar to a blog or agenda. This format makes it easy to quickly scan upcoming events and is often more effective for sites that have relatively few events.<\/p>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15540\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view.png\" alt=\"Screenshot of the event calendar in the list view, links to full-size image.\" width=\"500\" height=\"724\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view.png 1135w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-207x300.png 207w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-707x1024.png 707w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-768x1112.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-1061x1536.png 1061w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-600x869.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-calendar-list-view-560x811.png 560w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><\/a><\/span><\/p>\n<\/div>\n<\/div>\n<h3>To change the default view<\/h3>\n<ol>\n<li>Go to <strong>Events \u2192 Settings<\/strong><\/li>\n<li>Click the <strong>Display<\/strong> tab<\/li>\n<li>Under the <strong>Calendar Display<\/strong> section set the <strong>Default View<\/strong> to <strong>List<\/strong>.<\/li>\n<\/ol>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15502\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view.png\" alt=\"Screenshot showing the location of where to change the default view of the events calendar, links to full size image.\" width=\"500\" height=\"517\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view.png 1084w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view-290x300.png 290w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view-990x1024.png 990w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view-768x794.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view-600x620.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/calendar-default-view-560x579.png 560w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><\/a><\/span><\/p>\n<hr  style=\"margin:40px 0\"class=\" rule-thin osc-rule\" \/>\n<h2>Using Syndication Cell Shortcode<\/h2>\n<p>A <a href=\"https:\/\/www.med.unc.edu\/webguide\/cells\/syndication\/\">Syndication Cell<\/a> provides the most flexible way to display events.<\/p>\n<p>This option allows you to display:<\/p>\n<ul>\n<li>Events from your site<\/li>\n<li>Events from other SOM websites<\/li>\n<li>A combination of events from multiple SOM sites<\/li>\n<li>Past events<\/li>\n<\/ul>\n<hr  style=\"margin:40px 0\"class=\" rule-thin osc-rule\" \/>\n<h2>Using Theme Shortcode<\/h2>\n<p>The SOM theme includes shortcodes for displaying events. There are 3 options that display upcoming events in different layouts.<\/p>\n<p>To use them:<\/p>\n<ol>\n<li>Click the <strong>Shortcodes<\/strong> button in the editor.<\/li>\n<li>Select <strong>Recent Events<\/strong>.<\/li>\n<li>Choose from one of the three layout options.<\/li>\n<\/ol>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15505\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options.png\" alt=\"Screenshot of the WordPress editor with the display options for events highlighted, links to full-size image.\" width=\"500\" height=\"130\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options.png 1019w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options-300x78.png 300w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options-768x200.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options-600x156.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/event-display-options-560x146.png 560w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><\/a><\/span><\/p>\n<h3>Recent Events<\/h3>\n<p>Selecting this option inserts the following shortcode:<\/p>\n<p><code>[heels-tribe-events number=\"4\"]<\/code><\/p>\n<p>This will display a vertical listing of events. This shortcode is configured to display the four most recent events. You can modify the number to control how many events appear.<\/p>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15533\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events.png\" alt=\"Event listing from the Department of Neurology using the Recent Events shortcode, links to full-size image.\" width=\"600\" height=\"229\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events.png 1180w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-300x114.png 300w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-1024x391.png 1024w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-768x293.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-600x229.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-560x214.png 560w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><\/a><\/span><\/p>\n<h3>Recent Events List<\/h3>\n<p>Selecting this option inserts the following shortcode:<\/p>\n<p><code>[heels-tribe-list number=\"4\"]<\/code><\/p>\n<p>This will display an alternative vertical listing that predominately displays the event date. This shortcode is configured to display the four most recent events. You can modify the number to control how many events appear.<\/p>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15535\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list.png\" alt=\"Event listing from the Department of Neurology using the Recent Events List shortcode, links to full-size image.\" width=\"600\" height=\"332\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list.png 1083w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list-300x166.png 300w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list-1024x567.png 1024w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list-768x425.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list-600x332.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-list-560x310.png 560w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><\/a><\/span><\/p>\n<h3>Recent Events Carousel<\/h3>\n<p>Selecting this option inserts the following shortcode:<\/p>\n<p><code>[heels-tribe-carousel number=\"8\"]<\/code><\/p>\n<p>This will display a horizontal listing of events. This shortcode is configured to display the eight most recent events. You can modify the number to control how many events appear.<\/p>\n<p><span class=\"imgBorderMed\"><a href=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-15536\" src=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel.png\" alt=\"Event listing from the Department of Neurology using the Recent Events Carousel shortcode, links to full-size image.\" width=\"700\" height=\"155\" srcset=\"https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel.png 1227w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel-300x67.png 300w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel-1024x227.png 1024w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel-768x170.png 768w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel-600x133.png 600w, https:\/\/www.med.unc.edu\/webguide\/wp-content\/uploads\/sites\/419\/2026\/03\/recent-events-carousel-560x124.png 560w\" sizes=\"auto, (max-width: 700px) 100vw, 700px\" \/><\/a><\/span><\/p>\n<hr  style=\"margin:40px 0\"class=\" rule-thin osc-rule\" \/>\n<h2>Using Plugin Shortcode<\/h2>\n<p>The Events Calendar plugin also includes its own shortcode options for displaying events.<\/p>\n<ul>\n<li><a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/shortcodes\/\">Shortcodes Overview<\/a> &#8211; view our shortcode documentation first if you are unfamiliar with what shortcode is.<\/li>\n<li><a href=\"https:\/\/theeventscalendar.com\/knowledgebase\/events-calendar-pro-widget-shortcodes-overview\">Events Calendar Pro Widget Shortcodes<\/a><\/li>\n<\/ul>\n<hr  style=\"margin:40px 0\"class=\" rule-thin osc-rule\" \/>\n<h2>Display Past Events<\/h2>\n<p>A <strong><a href=\"https:\/\/www.med.unc.edu\/webguide\/cells\/syndication\/\">Syndication Cell<\/a><\/strong> is the only supported method for displaying past events.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>There are several ways to display events on your site. Sites that publish events typically add a link to the default events calendar page in their top navigation, and then use one of the shortcode options described below to display upcoming events on key pages such as the home page. Default Events Calendar Page When &hellip; <a href=\"https:\/\/www.med.unc.edu\/webguide\/event\/regenerative-yoga-class\/\" aria-label=\"Read more about Regenerative Yoga Class\">Read more<\/a><\/p>\n","protected":false},"author":3206,"featured_media":0,"parent":2224,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"layout":"","cellInformation":"","apiCallInformation":"","footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-15508","page","type-page","status-publish","hentry","cat_modular-cards","odd"],"acf":[],"_links_to":[],"_links_to_target":[],"_links":{"self":[{"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/pages\/15508","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/users\/3206"}],"replies":[{"embeddable":true,"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/comments?post=15508"}],"version-history":[{"count":8,"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/pages\/15508\/revisions"}],"predecessor-version":[{"id":15530,"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/pages\/15508\/revisions\/15530"}],"up":[{"embeddable":true,"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/pages\/2224"}],"wp:attachment":[{"href":"https:\/\/www.med.unc.edu\/webguide\/wp-json\/wp\/v2\/media?parent=15508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}