The Smartsheet Jira Connector is a premium offering. If you purchased the Jira Connector on your plan, you can use it to create workflows between Smartsheet and Jira.
USM Content
If you can't access the Jira Connector and receive an error message telling you to contact your System Admin, you need to have your permissions granted. Learn how to identify and contact your System Admin.
To create or edit a workflow, you need:
- A Smartsheet account with Editor permissions or higher on any sheet mapped within the workflow.
- A Jira account with adequate access rights to the Jira projects you want to include in the workflow.
- The Smartsheet Jira Connector User role, assigned by your System Admin in the Smartsheet Admin Center or the Jira Connector interface.
For more information, see:
Is there an additional cost for the Jira Connector?
Yes. The Smartsheet Jira Connector is a paid premium offering. Learn more about features and benefits. For pricing, contact Smartsheet Sales.
Is this Connector part of the Smartsheet core application?
The Connector isn't part of the core application, but it operates under the same policies, procedures, and security practices as the rest of Smartsheet, including the same security protocols, uptime, and service levels
Is the Jira Connector available for Smartsheet Gov or Smartsheet Regions EU?
The Smartsheet Jira Connector is available in the commercial Smartsheet US instance and in the EU-hosted version of Smartsheet. It isn't available within Smartsheet Gov. To import Jira data into the Smartsheet Gov instance, explore Data Shuttle. Learn more about Smartsheet Gov or Smartsheet Regions
How do I install the Jira Connector?
If you purchased the Jira Connector, follow the Jira Admin Connection setup steps to initialize the connection between Smartsheet and your Jira instance
Do I need a Jira account to use this Connector?
You need a Jira account to connect Smartsheet and Jira and to create workflows between the two. Once Jira data is in Smartsheet via the Connector, users who work only in Smartsheet don't need a Jira account.
What versions of Jira are compatible with the Smartsheet Jira Connector?
The Smartsheet Jira Connector is compatible with Jira Cloud, Jira Server v6.x–v10.x, and Jira Data Center
I upgraded to Jira Data Center v10. Do I need to do anything else to ensure my workflows run?
Workflows should continue to run normally after upgrading your Jira instance. However, you may need to reset your workflows after upgrading to Jira v10.
If you already migrated to Jira Data Center version 10 and your workflows are currently deactivated, delete the Jira Smartsheet Connector webhook and reset your workflows. Atlassian automatically deactivates unused webhooks after 30 days. Deleting the webhook doesn't delete your workflows. Don't delete your workflows in the Jira Connector.
- As a Jira Admin, sign in to your Jira instance.
- Navigate to Settings > System > Webhook.
- Search for all webhook names starting with JIRA to Smartsheet shared webhook.
- Select and delete each of those webhooks.
- In the Jira Smartsheet Connector, select Reset next to each workflow name.
Can I connect to multiple Jira instances with the Smartsheet Jira Connector?
Yes. You can create multiple connections to support different Jira instances, such as production and test instances. The user creating the connection must be a Jira Admin of the instance they're connecting to.
Can I link multiple Jira Connector workflows to one sheet? Or sync multiple Jira projects to one sheet in Smartsheet?
You can link only one Connector workflow to a sheet, but a single workflow can pull data from multiple projects. You can create a workflow that includes all projects or up to 25 individually selected projects. In either case, the workflow builder can only select projects they can access in Jira.
After I set up the connection, can any user on my Smartsheet plan create workflows?
Yes—by default, all Smartsheet users on a plan with the Jira Connector purchased can create workflows with Jira projects they can access. The Smartsheet Admin/Connector Admin can put further restrictions on the environment and permission users individually via the User Management section of the Connectors app.
How do I add a user to the Jira Connector?
System Admins assign the Smartsheet Jira Connector User role to users in the Smartsheet Admin Center or directly in the Jira Connector interface. For setup steps, see Jira Connector Admin Setup.
After I set up the connection, can any user on my Smartsheet plan create workflows?
By default, all Smartsheet users on a plan with the Jira Connector can create workflows with Jira projects they can access. The Smartsheet Admin or Connector Admin can apply additional restrictions and permissions to users individually in the User Management section of the Connectors app.
What fields can I sync between Jira and Smartsheet?
The Jira Connector supports most standard custom field types that the Jira API exposes. Support for the Story Points field varies by Jira version. Support for custom fields added by external Jira apps or plugins is limited, and the Connector doesn't support syncing issue comments or attachments.
Do all fields need to be bidirectionally or automatically synced?
No. When creating a workflow, you choose which fields to sync, whether each sync is bidirectional or one-way, and whether the sync runs manually or automatically.
How do I see the Jira Connector workflows I create?
You can always see any workflow you create. If you're a Smartsheet Jira Admin, you can see every workflow created by users in your organization, regardless of who created them. For steps to view and manage workflows, see Create workflows with the Smartsheet Jira Connector.
When I need help, what are my support resources?
*These resources depend on your plan support type.
Which Jira data does the Smartsheet Jira Connector access?
The Jira Connector pulls only the data defined by your workflow, mapping Jira fields to Smartsheet sheets and columns. It also retrieves metadata (available fields and user lists for the selected Jira project) so you can map fields and assign issues in Jira from Smartsheet.
Data and metadata retrieval use the workflow creator's Jira OAuth credentials, so the Connector respects that user's Jira permissions. Smartsheet never accesses Jira usernames or passwords; OAuth handles authentication.
Can I filter out what data I sync between Smartsheet and Jira?
Yes. If you're syncing one project, use the built-in filters in the Connector workflow settings. If you're syncing multiple projects in one workflow, use JQL to apply a filter instead.
Can I create issues in Jira from within Smartsheet using the Jira Connector?
Yes. If you configure the workflow to sync data to Jira, you can create Jira issues (stories, tasks, bugs, and subtasks) directly from Smartsheet.
When building your workflow, select Sync new rows created in Smartsheet to JIRA. Once you create the workflow with the required fields, enter the information into a new row in Smartsheet (or use a form) and save the sheet. To create a subtask issue, indent the new row under the parent row. The next time the workflow syncs, the new issues appear in Jira.
The Project Key field is required when creating issues in a sheet mapped to multiple Jira projects. If you create a new issue without including the Project Key, an error appears in the sheet.
When I change a user to Contributor or No Access from my Seat types and true-up page, what happens to the workflows they own in Connectors?
Connector workflows deactivate when they attempt to sync data after the workflow owner is downgraded to Contributor or No Access from the Seat types and true-up page. To re-enable the workflows, either upgrade the user's role to Editor or higher, or transfer the workflows to another user with the appropriate permissions.
Why did my workflow keep syncing even after I deactivated it?
This is expected behavior. When you deactivate a workflow, any sync already in progress continues until it completes. Once that run finishes, the workflow stops and doesn't trigger again until you re-enable it.