# How it works Capable Calendar turns the dates already living on your Confluence pages into real calendars, and adds shared, saveable calendars of its own. It ships three page macros (Calendar, Clock, Event), a full Calendar page where saved calendars are created and managed, a page byline showing how many dates a page contains, a Confluence homepage feed card, a Capable dashboard widget, and a Capable Search panel and column. Events come from three sources: Capable Event macros on pages, Confluence's own date chips on pages (paragraphs, table rows, task items, decision items), and events saved inside a Cap --- ## In this section [Calendar viewsFive views: Day (single-day time grid), Week (time grid for the week with an all-day row and a now-indicator line), Month (day grid, the default), Year (twelve-month overview) and Agenda (a week-long chronological list rather than a grid. T](https://help.gocapable.com/calendar/calendar-views.html)[Where events come fromThree source types, called "event types" throughout: Capable Event macros on pages; Confluence's own date chips on pages; and In-Calendar Events saved inside a Capable calendar. Page dates are read live out of the page every time a calendar](https://help.gocapable.com/calendar/where-events-come-from.html)[How Confluence dates on a page become eventsA date in a paragraph makes one event running from the earliest to the latest date in that paragraph; @-mentions in the same paragraph become participants and the remaining paragraph text becomes the title. A table row containing dates make](https://help.gocapable.com/calendar/how-confluence-dates-on-a-page-become-events.html)[Live editor datesWhile a page is open in the Confluence editor, a Calendar macro reads dates straight from what you are typing rather than the saved page, so new dates appear immediately. Those live events are shown non-editable.](https://help.gocapable.com/calendar/live-editor-dates.html)[Duplicate collapsingAn event arriving from more than one source appears once. Events from the current page are added first, so they win.](https://help.gocapable.com/calendar/duplicate-collapsing.html)[Calendar pageA full page (standalone app: a space page and a global page both titled "Capable Calendar"; in the Suite: one entry titled "Calendar" inside the shared "Capable" page, subtitled "View dates from pages in a calendar"). It holds the catalogue](https://help.gocapable.com/calendar/calendar-page.html)[Saved calendars are Confluence contentA saved calendar is stored as Confluence custom content ("Capable Custom Content (Calendar)" and "Capable Shared Storage (Calendar)" in the standalone app; "(Suite)" in the Suite). It can live in a page, blog post or space container, is ind](https://help.gocapable.com/calendar/saved-calendars-are-confluence-content.html)[Who can create and edit eventsPermission comes from Confluence content permissions on the calendar itself. The server re-checks the viewer's read/update/delete rights on the calendar record on every request, and the app disables creation and raises a message when the ch](https://help.gocapable.com/calendar/who-can-create-and-edit-events.html)[Saved event editorEvents saved inside a calendar are authored in a modal with five tabs: Scheduling, Additional, Attendees, Linked content and Tags. Fields cover name and priority, description and colour, dates, attendees, content links, tags, which calendar](https://help.gocapable.com/calendar/saved-event-editor.html)[Built-in calendarsTwo read-only calendars ship in the catalogue as ready-made.](https://help.gocapable.com/calendar/built-in-calendars.html)[My CalendarA private per-user overlay of up to 5 chosen source calendars plus an "assigned to me" overlay of events you are a participant of. Out of the box a user sees only events assigned to them, with no source calendars. The choice is stored per u](https://help.gocapable.com/calendar/my-calendar.html)[Importing an .ics fileAn existing calendar file can be imported one-way into a saved calendar from the calendar catalogue. Events carrying a Confluence Jira-integration marker are skipped, events with no start date are skipped, titles shorter than 4 characters a](https://help.gocapable.com/calendar/importing-an-ics-file.html)[Personal iCal subscriptionEach signed-in user can mint a personal, read-only feed link for a saved calendar from the Subscribe (calendar-plus) button. The panel shows the URL with a Copy button, one-click Google, Apple and Outlook buttons, and a Revoke link button.](https://help.gocapable.com/calendar/personal-ical-subscription.html)[iCal feed contentStandard iCalendar with the calendar's title as its name and a 60-minute refresh hint. Each event carries a summary, a description (blurb, attached links and attendee names), a location or URL from the first attached content link, external](https://help.gocapable.com/calendar/ical-feed-content.html)[Feed freshnessCreating a subscription pre-builds the feed, and every event create, edit, move or delete schedules a refresh 60 seconds later off the request path, so a burst of edits produces roughly one rebuild.](https://help.gocapable.com/calendar/feed-freshness.html)[Feed securityEvery poll is re-checked against the subscriber's live Confluence permission on the calendar. A genuine loss of access (deactivated user, revoked grant, deleted calendar) permanently revokes the link and the feed answers "no longer availabl](https://help.gocapable.com/calendar/feed-security.html) --- ## Related [MacrosThe macros themselves.](https://help.gocapable.com/calendar/macros.html) [AdministrationWhat an admin controls.](https://help.gocapable.com/calendar/administration.html) [TroubleshootingWhen it does not.](https://help.gocapable.com/calendar/troubleshooting.html) --- _How it actually behaves._