Skip to main content

Knowledge Base

Back to support overview

TeamViewer integration for Jira Cloud

Last Modified: Oct 9, 2026

The TeamViewer integration for Jira Cloud lets support teams use TeamViewer features directly from Jira issues. After configuring the integration, users can create remote support and Assist AR sessions, view connection reports and AI summaries, and connect to managed devices. This article explains how Jira administrators can install and configure the integration.

This article applies to all TeamViewer customers with an eligible TeamViewer account and the required TeamViewer integration license. TeamViewer integrations are not included in standard license packages and must be purchased separately as add-ons. For more information, see TeamViewer Integrations.

Prerequisites

Before you begin, make sure you have:

  • Jira administrator permissions
  • Access to the Atlassian Marketplace
  • An eligible TeamViewer account
  • The required TeamViewer integration license
  • Jira Assets, if you want to configure unattended access
  • The TeamViewer Devices schema, if you want to link managed devices to Jira issues

To install the TeamViewer integration from the Atlassian Marketplace:

  1. Sign in to your Jira Cloud instance as an administrator.
  2. In the left navigation, select Explore more apps.
  3. Search for TeamViewer for Jira Cloud.
  4. Open the TeamViewer app listing.
  5. Select Get it now and complete the installation.

You must connect an eligible TeamViewer account before using the integration. You only need to complete this process once.

  1. On the Jira Cloud left navigation, select Apps.
  2. Select the TeamViewer app.
  3. Select Connect.
  4. Sign in with your TeamViewer account credentials.
  5. Complete the authorization process.

After you connect the account, you can disconnect it from the same TeamViewer settings page. 

You can also connect your TeamViewer account directly from a Jira issue.

  1. Open a Jira issue.
  2. Find the TeamViewer panel in the right sidebar.
  3. Select Connect.
  1. Sign in to your TeamViewer account in the pop-up window.
  2. Allow the required permissions.
  3. Return to Jira and confirm that the account is connected.

You can create a remote support session from the TeamViewer panel in a Jira issue.

  1. Open the relevant Jira issue.
  2. In the TeamViewer panel, select Create session.
  3. Connect to the session and provide remote support.
  4. Select Connection Reports & AI Summaries to view the session details.
  5. Wait for the AI summary to become available.
  6. Close the session when you finish.

You can create an Assist AR session and send an invitation by SMS.

  1. Open the relevant Jira issue.
  2. In the TeamViewer panel, select Create AR session.
  3. Enter a valid telephone number.
  4. Send the invitation by SMS.
  5. Connect to and conduct the Assist AR session.
  6. Select Connection Reports & AI Summaries to view the session details.
  7. Close the session when you finish.

Enable the Web Client setting if users should conduct sessions in a browser. Disable the setting if users should connect through the installed TeamViewer client.

  1. In Jira, open the TeamViewer settings.
  2. Find WebClient Settings.
  3. Enable the Web Client option to open sessions in a browser.
  4. Select Save settings.
  5. To use the installed TeamViewer client instead, disable the option and save the changes.

To connect to managed devices from Jira issues, configure Jira Assets and link the TeamViewer Device field to the TeamViewer device schema.

How to verify the TeamViewer Devices schema
  1. Open: 
https://<your-site>.atlassian.net/jira/assets/schemas
  1. https://<your-site>.atlassian.net/jira/assets/schemas
  2. Confirm that the TeamViewer Devices schema appears in the list.
  3. If the schema is missing, refresh or update the TeamViewer app.
How to create a TeamViewer import

  1. Open:

     

     

    https://<your-site>.atlassian.net/jira/assets
  2. Open the TeamViewer Devices schema.
  3. Select Schema configuration.
  4. Select Import.
  5. Select Create import.
  1. Select TeamViewer as the import type.
  2. Enter a name for the import.
  3. Save the import.
How to run the first device import
  1. Open the import card in Jira Assets.
  2. Select Import data.
  3. Wait for the import to finish.
  1. Go to Assets > Schemas > TeamViewer Devices.
  2. Confirm that the imported devices appear in the schema.

The TeamViewer installation automatically adds the TeamViewer Device field. Configure the field to use the TeamViewer device schema. 

  1. Open:

     

    https://<your-site>.atlassian.net/jira/settings/issues/fields

  2. Search for TeamViewer Device.
  3. Open the field actions.
  4. Select Contexts and default values.
  1. Select Edit Assets object/s field configuration.
  2. Set Object schema to TeamViewer Device.
  3. Set Object type to Device.
  4. Select the attributes that users should see. The source recommends Name and Online Status.
  5. Save the changes

A Jira administrator must add the TeamViewer Device field to the required project screen before users can select devices in issues.

  1. Open an issue in the relevant Jira project.
  2. Select Configure.
  1. Select Go to the Fields Page.
  1. Select Add Fields.
  2. Search for TeamViewer Device.
  3. Select the TeamViewer Device field.
  4. Select Add 1 field.
  1. Return to the Fields tab.
  2. Drag the TeamViewer Device field to the required position.
  3. Save the changes.
  1. Open a Jira issue.
  2. Find the TeamViewer Device field.
  3. Search for and select a device.
  4. Save the issue.
  5. Confirm that the Connect button appears in the TeamViewer panel. 
  1. Open a Jira issue that is linked to a managed device.
  2. Go to the Managed Devices section of the TeamViewer panel.
  3. Select Connect.
  4. Conduct the unattended connection.
  5. Select Update Report with AI Summaries to update the connection report and generate the AI summary.

If the Web Client setting is enabled, the connection opens in the browser.