Quick Start Guide
Get up and running with Email to Jira in minutes.
๐ What This Add-in Does
Transform Outlook emails into Jira issues with one click. AI-powered by Google Gemini, it automatically generates structured summaries and extracts action items from your emails. Keep complete context, formatting, and email attachments intact.
๐ Free Trial
Start with a 7-day free trial to explore all features. No credit card required. After the trial, a subscription is required for continued use.
โ Before You Start
- Microsoft 365: Work or school account (Business or Enterprise)
- Outlook: Outlook Web or Desktop (Windows/Mac)
- Admin Deployment: Add-in must be deployed by Microsoft 365 admin through Admin Center
๐ Jira Requirements
- Jira Cloud: Active Jira Cloud instance (Server/Data Center not supported)
- Project Access: Permission to create issues in at least one project
- Permissions: Browse Projects and Create Issues permissions
โ ๏ธ Important
This add-in only supports Jira Cloud. Jira Server and Jira Data Center are not supported. Your Microsoft 365 administrator must deploy the add-in through the Admin Center.
Deploy Outlook Add-in (For Admins)
Access Admin Center
Go to Microsoft 365 Admin Center โ Settings โ Integrated apps
Deploy Add-in
- Click "Get apps" or "Upload custom apps"
- Search for "Email to Jira Ticket"
- Select the add-in and click "Get it now"
Configure Deployment
- Choose deployment scope: Entire organization or Specific users/groups
- Review permissions required by the add-in
- Click "Deploy"
Wait for Propagation
Deployment can take 1-24 hours to appear in users' Outlook. Users may need to restart Outlook or clear browser cache.
First-Time Setup (For Users)
Open an Email
In Outlook, open any email you want to convert to a Jira issue.
Open the Add-in
Click the "Apps" button in the Outlook toolbar, then find and select "Email to Jira Ticket" from the app menu.
Connect to Jira
- Click "Connect to Jira"
- A popup window will open for Atlassian OAuth authorization
- Sign in to your Atlassian account if prompted
- Select the Jira site you want to connect
- Click "Accept" to grant the add-in access
- The popup will close and you'll be connected
๐ Authentication
Jira uses secure Atlassian OAuth 2.0 authentication. Your credentials are never stored locally. You can revoke access at any time from your Atlassian account settings.
Start Your Free Trial
- Click "Start Free Trial"
- Enjoy 7 days of full access to all features
- No credit card required
- After trial, subscribe to continue using the add-in
Creating Your First Issue
Select Site & Project
- Site: Select your Jira Cloud site (if you have access to multiple)
- Project: Choose the project where you want to create the issue
- Issue Type: Select the issue type (Bug, Task, Story, Epic, etc.)
Configure Issue Details
- Summary: Auto-filled from email subject (editable)
- Description: AI-generated summary with action items extracted (editable)
- Assignee: Select team member (optional)
- Priority: Set issue priority (optional)
๐ค AI-Powered
Google Gemini analyzes your email and generates a structured summary with action items. You can review, edit, or skip AI processing before creating the issue.
Review & Create
- Review all fields
- Click "Create Issue"
- Wait for confirmation (usually 2-5 seconds)
Success!
You'll see a success message with:
- Issue key (e.g., PROJ-123) and summary
- Direct link to view in Jira
- Option to create another or close the add-in
Note: The original email is automatically attached as an .eml file, and any email attachments are uploaded separately to the issue.
Key Features
๐ค AI-Powered Analysis
Google Gemini generates structured summaries and extracts action items from emails
๐ง Email Preservation
Original email saved as .eml with full formatting, headers, and thread context
๐ Attachment Upload
Email attachments automatically uploaded to Jira issues
๐ฅ Team Assignment
Assign issues to team members directly from Outlook
๐ฏ Issue Types
Support for Bug, Task, Story, Epic, and custom types
๐ข Multi-Site
Switch between multiple Jira Cloud sites seamlessly
Quick Troubleshooting
Add-in Not Appearing in Outlook
- Wait a few hours after admin deployment (up to 24 hours)
- Restart Outlook completely
- Clear browser cache (for Outlook Web)
- Verify your admin deployed to your user/group
"Connect to Jira" Not Working
- Check that popups are not blocked by your browser
- Ensure you have a Jira Cloud account (Server/Data Center not supported)
- Try disconnecting and reconnecting via OAuth
"No Projects Found" Error
- Verify you have access to at least one Jira project
- Check you have "Browse Projects" and "Create Issues" permissions
- Ensure you selected the correct Jira site during OAuth
Quick FAQ
Does this work with Jira Server or Data Center?
No, this add-in only supports Jira Cloud. Jira Server and Data Center are not supported due to authentication and API differences.
How does the AI feature work?
Google Gemini AI analyzes your email content and generates a structured summary with extracted action items. You have full control to review, edit, or skip AI processing.
Can I use this on mobile devices?
No, the add-in is only supported on Outlook Web and Outlook Desktop (Windows/Mac). Mobile support is not available.
What happens to email attachments?
The entire email is preserved as an .eml file. Additionally, individual email attachments are uploaded separately to the Jira issue.
Can I connect multiple Jira sites?
Yes, if you have access to multiple Jira Cloud sites through your Atlassian account, you can select which site to use when creating issues.
Need Help?
๐ง Contact Support
For issues, questions, or feature requests:
Email: support@innovaapps.ai