Common tasks
Rather than a tour, this is the list of things people do, with the route to each.
#What you can do
Task | Where | Notes |
|---|---|---|
Show the dates already on a page as a calendar | Page editor → insert "Calendar (Capable)" (S | Leave Source unset. The macro then shows the Capable Event macros and Confluence date chips found on that page. |
Point a page calendar at a shared, saved calendar | Calendar macro config → Content tab → Source | Pick a space or global calendar, or use "Create new calendar". Turning on "Event editing" then lets readers create and edit events from inside the macro. Note the macro also keeps showing th |
Choose the view the macro opens in | Calendar macro config → Content tab → View | Day, Week, Month (default), Year or Agenda. Readers cannot switch views inside the macro. They press Maximize to open a full calendar with a switcher. |
Control which period the calendar opens on | Calendar macro config, or Calendar Configura | Last event (default), Today, or Custom plus a date. The last-event jump is abandoned as soon as a reader navigates. |
Hide specific dates from the grid | Calendar macro config → Content tab → Hidden | Click a date chip to toggle it off. Only affects dates found on the current page. |
Frame or tint the calendar | Calendar macro config → Style tab | Corner radius, Shadow, Border (with width and colour) and Highlight colour. Highlight colour only tints today and selected dates, never the event colours. |
Add a set of world clocks | Page editor → insert "Clock (Capable)" / "Cl | Defaults to Los Angeles, New York and London. Drag to reorder, Add Zone to append, and give any zone a custom Title. Three presets exist: Americas, EMEA, APAC. |
Add an inline event date to a page | Page editor → insert "Event (Capable)" / "Ev | Set Title, dates and times, assignee and time zone. Options control All-day, Show user, Show title and 24-Hour format. All four are on by default. |
Have Confluence's own dates picked up automatically | Anywhere on a page. A date in a paragraph, a | A paragraph or a table row containing dates makes one event spanning the earliest to latest date in it. @-mentions become participants and the surrounding text becomes the title. |
Create a saved, shared calendar | Calendar page → catalogue → create a calenda | The calendar is stored as Confluence content in the space or page you create it in, so it inherits that location's permissions. |
Add or edit an event inside a saved calendar | Open the calendar → click a date or an event | The name must be 4 to 100 characters. Description is capped at 255 characters and each tag at 50. |
Choose which pages a saved calendar scrapes for dates | Calendar Configuration panel → Pages | Recently viewed, Pages where mentioned, Specific pages (max 25), Pages from search (filters or CQL, sort, Result Limit). None of these do anything unless "Native page dates" or "Capable Even |
Import an existing .ics calendar | Calendar catalogue → Import | Drop or select a .ics file. Jira-integration events, events with no start date and events with titles under 4 characters are skipped, and recurring events import as their first occurrence on |
Build a personal cross-calendar view | Calendar → My Calendar → Manage sources | Add up to 5 source calendars; "assigned to me" is on by default. Choices are private to you. |
Subscribe to a calendar from Google, Apple or Outlook | Open a calendar → Subscribe (calendar-plus) | Then click Google, Apple or Outlook for a one-click hand-off, or press Copy and paste the URL into your calendar app's "add by URL" / "subscribe from internet" field. Some apps block the han |
Re-display a subscription link you already made | Calendar page → Subscribe button | The panel re-shows the persisted link. Very old links made before links could be re-displayed show a "Show a new link" button instead, which replaces the old one. |
Revoke your own subscription link | Calendar page → Subscribe → "Revoke link" | The URL dies immediately and cannot be brought back. Creating a fresh link for the same calendar also revokes the previous one. |
Turn personal iCal subscriptions on or off for the whole site | Confluence settings → Capable → Features → " | On by default. Takes effect within about a minute. Turning it off blocks new links but does not kill existing ones. |
Review or revoke everyone's subscription links | Confluence settings → Capable → Calendar tab | Confluence administrators only. Lists user, calendar, status and created date with per-row Revoke and a Revoke all button; 25 rows per page. Revocation is permanent. |
Hide Calendar in one space, or force it always on | Space settings → Capable → capability list → | Space administrators. In the Suite, Auto means the byline appears only on pages Capable has indexed as containing dates. |
Hide the Calendar capability across the whole site | Confluence settings → Capable → Capabilities | Suite only. The standalone Capable Calendar app has no Capabilities tab. |
Trigger or check content indexing | Confluence settings → Capable → Indexing | Suite only. Matters because the Suite byline and the CQL date search both depend on the index. |
Search for pages by their dates | Capable Search → CQL fields "Capable Date St | Backed by the date index, capped at 200 unique start dates per page. |
Turn a pasted calendar link into a calendar macro | Page editor. Paste a Capable calendar asset | It auto-converts into a Calendar macro already pointed at that calendar. |
#A few things worth knowing
Some tasks need an administrator. The Where column says so.
Anything relying on search needs the page to have been indexed first.
Macro names differ slightly between the standalone app and the suite.
#Related
What people actually do.
