Integrate Jira Cloud with Gmail

The Jira Cloud for Gmail app helps you manage Jira work items without leaving Gmail. Effortlessly create work items from emails, preview Jira links you paste into an email, view detailed information on hyperlinked work items, and edit or comment on them - all within your inbox. These features will help you transform email conversations into actionable tasks without context switching between apps.

Top features

Install the Jira Cloud for Gmail app to access the following features:

• Create work items using details from an email or with Rovo

• Preview Jira links you paste into an email, in a compact or detailed card.

• View details of work items hyperlinked in an email.

• Read an AI summary of a work item in the app side panel.

• Edit and comment on work items within Gmail.

• Attach emails as comments to existing work items.
  
  *Rovo will need to be enabled for Jira sites and spaces for users to have access to this feature. Users should be mindful when sharing sensitive data or information with the app when using generative AI to create work item summary and description fields.

Before you begin

To use the Jira Cloud for Gmail app, you need:

• A Jira Cloud account

• Access to a Jira site

• A Gmail account (personal* or Google Workspace)

• The Jira Cloud for Gmail app installed from the Google Workspace Marketplace

*Note to admins: Atlassian permits users to link their personal email accounts to the Atlassian platform.

Install the Jira Cloud for Gmail app

• Open Gmail in your browser and select the + icon in the right side panel.

• Enter Atlassian in the Google Workspace Marketplace search bar.

• Find the Atlassian app, select Install and follow the permission prompts.

• Once installed, open any email and select the Atlassian icon in the sidebar.

• Sign in with your Atlassian account to connect Gmail with your Jira site.

Link previews need additional permissions. If you installed the app before link previews were available, you'll be asked to review and accept the new permissions before previews start working.

Preview Jira links in an email

When you paste a link to a Jira work item into an email you're writing, the app turns it into a preview card. Your recipients see the card too, so they can tell what the work item is without leaving their inbox.

Preview cards appear at the bottom of the email body and stack vertically, like attachments. In a reply, new cards appear above the quoted text.

You choose how much detail each card shows. Compact is the default.

From a preview card you can:

• Select View details, or select anywhere on the card, to open the work item in the app side panel.

• Select the open in new icon or Open in Jira to open the work item in Jira in a new browser tab.

If you don't have the app installed, selecting a preview card brings you to this page so you can install it.

Link previews aren't available in the Gmail mobile apps yet.

Choose how link previews appear

• Open Gmail in your browser and select the Atlassian icon in the right vertical sidebar.

• Select Preview settings at the bottom of the app side panel. You can also select the three dot menu at the top right of the panel, then select Settings.

• Under Link previews, select Compact, Detailed, or Off.

Your choice is saved for you and applies the next time you paste a Jira link. It doesn't change previews that are already in a draft or in an email you've sent.

You can also turn AI summaries off from this settings page.

Create a work item from an email

• Open an email in your Gmail inbox.

• Select the Atlassian icon in the right vertical sidebar.

• Select Create in the app side panel.

• Select Use email body as description to include the email subject as the work item summary and email body content as the description

• Or, select Use AI to generate description to create the work item summary and description fields with generative AI based on the email content.

• Edit and review the work item fields then select Create in the pop-up window.

Work items created using the app will be automatically attached to the source email. This means the app will detect and display any work items attached to an email in the app panel.

Edit or comment on a work item in Gmail

• Open an email in your Gmail inbox.

• To find existing work items select Find in the app side panel.

• Paste a link to a Jira work item in the input field and select Find.

• The work item will appear in the app side panel.

• Select Edit to update and comment on the work item in the pop-up window.

• Hyperlinked work items will automatically appear in the app side panel. Select a work item and follow step five to edit it.

Read an AI summary of a work item

When you open a work item in the app side panel, the app generates a short AI summary at the top. Use it to catch up on where the work item stands without reading every field, comment, and description.

• Open a work item in the app side panel, either by selecting a preview card or by selecting a work item linked to the email.

• Read the summary at the top of the panel. Select Show more to see the full summary.

• Select Edit to update or comment on the work item.

AI summaries can be inaccurate or incomplete. Check the work item details before you act on a summary.

To turn AI summaries off, select Preview settings at the bottom of the app side panel.

Attach an email to an existing work item

• Open an email in your Gmail inbox.

• To find existing work items select Find in the app side panel.

• Paste a link to a Jira work item in the input field and select Find.

• The work item will appear in the app side panel.

• Select Attach email.

• Select Attach to include the email content as a comment to the work item. The comment field can't be edited.

Uninstall the Jira Cloud for Gmail app

• Open Gmail in your browser and select the + icon in the right side panel.

• Enter Atlassian in the Google Workspace Marketplace search bar.

• Find the Atlassian app and select Uninstall to remove the app.