Team Calendar Macro

Add the Team Calendar macro to a page to display a calendar on a Confluence page, making it easy to track and manage events. 

This macro is great for:

  • displaying team events, project timelines, and milestones in project and team spaces
  • sharing Jira issue due dates and sprint dates on sprint planning or retrospective pages
  • publishing schedules and on-call rotations where everyone can see them.

On this page:

Screenshot: The Team Calendar macro showing important project dates.

For general information about creating calendars, or subscribing to existing calendars, see Team Calendars.

Add the Team Calendar macro to your page

To add the Team Calendar macro to a page:

  1. Unable to render {include} The included page could not be found.
  2. Select Team Calendar from the Reporting category.
  3. Select Add Existing Calendar.
  4. Search for the calendar name 
  5. Select Add

You can then publish your page to see the macro in action. 

Screenshot: configuring the Team Calendar macro in the macro browser.

Change the macro parameters

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Here's a list of the parameters available in this macro. 





CalendarYesblankThe name of the calendar to display. 



Format to display the calendar. Available values:

  • month
  • week
  • list
  • timeline


NononeWidth of the calendar in pixels. Leave blank, and the calendar will fill the available space.
HeightNononeMaximum height of the calendar in pixels. Only applies to the timeline view. 
Calendar legendNonone

Location of the calendar legend in the month and week views. The legend shows the event types present in the selected calendar. Available values:

  • Right
  • Bottom
  • None

Calendar ID

Yes (Wiki markup only)blank

One or more calendar IDs, separated by commas. This parameter is only required when adding the macro using wiki markup.

To find out the ID for a calendar:

  1. Choose Calendars from the Confluence header or space sidebar
  2. Click
    Unable to render {include} The included page could not be found.
    next to a calendar and choose Embed
    A dialog appears with the link to the calendar.

The last part of the link contains the ID of the calendar. For example:


Other ways to add this macro

Add this macro as you type

Unable to render {include} The included page could not be found.

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Macro name:  calendar

Macro body: None.


Last modified on Jan 25, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.