Skip to main content
Skip table of contents

Calendar for Jira: Export Guide: ICS, JSON, and Public Calendars

Overview

Export calendars from Jira with advanced features designed to meet diverse use cases, such as sharing, embedding, and automating workflows. This guide provides a unified explanation of all export options available in Calendar for Jira.


Key Features

  1. Multiple Export Formats

    • ICS Feed: Standard export format compatible with Google Calendar, Outlook, and more. Includes a Compatibility Mode for Atlassian Team Calendars.

    • JSON Feed: Provides programmatic access to calendar data, ideal for developers integrating Jira calendars into custom dashboards or workflows. Use proper methods to handle external access due to CORS restrictions.

    • Embed URL: Share a public monthly calendar view accessible without authentication.

  2. Security and Customization

    • Customize fields to include (e.g., Status, Summary) while ensuring sensitive data is excluded.

    • Audit logs for administrators to monitor export activity.

  3. Enhanced ICS Compatibility

    • Improved format for seamless integration with Atlassian Team Calendars, especially for events without end dates.


Setting Up the Export

Global Settings

image-20241228-154555.png

Administrators can enable export functionality for the instance.

  1. Navigate to Apps → DoItBetter Calendar → Export.

  2. Enable the desired formats:

    • ICS

    • Embed and JSON Export

  3. Optionally exclude specific projects from export.

Configuring a Specific Calendar

image-20241228-154952.png

image-20241228-154812.png

  1. Open the calendar and select Export.

  2. Choose fields (e.g., Status, Key, Summary) and the desired export format:

    • ICS, JSON, or Embedded Calendar.

  3. Copy the generated export URL.


JSON Export

image-20241228-155334.png

  • Since CORS is disabled in our configuration, JSON feeds cannot be accessed directly from external domains. Ensure proper integration methods are in place for external usage.

  • Example fields include:

    • Event name

    • Start/End dates

    • Summary


Embedded Calendar

  • Publicly accessible monthly view.

  • Customize fields to balance visibility with security.

image-20241228-160131.png

ICS Compatibility Mode

  • Optimized for Atlassian Team Calendars.

  • Handles events without end dates.

  • Fully backward-compatible with existing ICS export workflows.


Security Recommendations

  1. Regularly review active exports in the audit log.

  2. Restrict sensitive fields when configuring exports.

  3. Ensure JSON and Embedded Calendars only share non-sensitive data.


Use Cases

  • ICS Export: Sync Jira schedules with personal calendars like Google or Outlook.

  • JSON Export: Build integrations or custom reports using calendar data.

  • Embedded Calendar: Publish team schedules or timelines on public platforms.


FAQ

Q: Can I disable exports for specific projects?

A: Yes, administrators can exclude projects in global settings.

Q: Is the Embedded Calendar secure?

A: Embedded Calendars are public. Avoid including sensitive information.

Q: How do I enable ICS Compatibility Mode?

A: This mode is automatically applied when exporting ICS for Atlassian Team Calendars.


Support

For questions or assistance, contact support@doitb.com.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.