Embedded Calendar

What is an Embedded Calendar Back to top

An embedded calendar is a public, read-only monthly calendar view that anyone can access without a Jira login. It renders your Jira calendar events in a clean monthly grid that can be opened directly in a browser or embedded into any website using an iframe.

This is ideal for team portals, company wikis, project websites, or any scenario where you need to share a calendar with people who do not have Jira access. Viewers can browse months, click events to see details, but cannot create or modify anything.

Prerequisites Back to top

• A Jira administrator must enable the "Enable Embed and JSON export" toggle in Admin Settings → Export Settings
• You must have calendar admin permission on the calendar you want to embed

Generate an Embedded Calendar URL Back to top

1. Find the calendar you want to embed in the left sidebar
2. Click the edit icon (pencil) next to the calendar name
3. Select Export Settings from the dropdown menu
4. Locate the Embedded card
5. Configure Fields to display on events
6. Click Generate URL
7. Copy the generated URL

What Viewers See Back to top

The embedded calendar presents a fully interactive monthly grid view:

• Monthly grid with day cells showing event bars
• Navigation controls — Previous month, Next month, and Today buttons
• Calendar color — events are displayed using the calendar's configured color
• Jira issue icons — issue type icon, priority icon, and status lozenge are shown on each event
• Click popup — clicking an event opens a popup with the event's details (title, dates, description, and any fields you included)

Embedding on Your Website Back to top

You can use the generated URL in two ways:

Open directly in a browser

Paste the URL into any browser to view the calendar as a standalone page. Share the link with anyone who needs access.

Embed with an iframe

Add the calendar to any webpage using an HTML iframe:

<iframe
  src="YOUR_EMBEDDED_CALENDAR_URL"
  width="100%"
  height="600"
  frameborder="0"
></iframe>

Adjust the width and height attributes to fit your page layout. The calendar is responsive and adapts to the available space.

Timezone Back to top

The embedded calendar uses UTC by default for displaying event times. To display events in a specific timezone, append the timezone parameter to the URL:

https://your-embedded-url?token=abc123&timezone=Europe/Amsterdam

Use any valid IANA timezone name (e.g., America/New_York, Asia/Tokyo, Europe/London).

No Period Limit Back to top

Unlike ICS and JSON feeds which have a configurable period, the embedded calendar loads 1 year of data by default. Viewers can navigate freely between months using the previous/next buttons without any restrictions.

Security Back to top

• IP allowlist — restrict access to specific IP addresses or CIDR ranges in Admin Settings to limit who can view the calendar
• URL regeneration — if a URL is compromised, regenerate it from Export Settings. The old URL stops working immediately.
• Read-only — viewers can only see events. They cannot create, edit, or delete anything.