Docs

Initial Jira Sync Setup

Configure Risotto to sync with Jira bidirectionally

To watch the whole setup first, see the three-and-a-half-minute video.

  1. Enter your Jira site URL

    Go to Settings > Integrations and click the Jira card. On the Jira app card, click Connect.

    The Install Jira Forge App dialog opens with a single Jira site URL field. Enter your Jira site URL (e.g. yourcompany.atlassian.net) and click Get install link.

  2. Install the Risotto app

    Click Open install page to open the Atlassian installation page in a new tab.

    The Atlassian page for the risotto-jira app (published by Risotto) lists the permissions it requires:

    • View Jira issue data
    • Create and manage issues
    • View user profiles
    • Manage Jira global settings
    • Read Email Address
    • View workflows
    • Access and interact from outside of Atlassian

    Click Get app, choose the Jira site to install it on, and click Install.

  3. Confirm installation

    Return to the Risotto dialog. The installation is automatically detected — the dialog changes to Jira Forge App Installed with a green checkmark and the message "Your Jira integration is ready to use." Click Done.

  4. Configure Risotto

    Go to Settings. Under Departments, click a department, then click Ticket Sync. Click Add ticket sync and select Jira.

    The Configure Jira for <department> dialog opens with these fields:

    • Jira Site: your Jira site, pre-filled from the installation. The refresh icon next to it (Refresh Jira metadata) reloads project metadata from Jira.
    • Project — the project in which issues will be created.
    • Issue Type: the type of issue that will be created in this project (e.g. Task). The options load after you select a project.
    • Status Mapping: one row per Risotto status, each with a dropdown of statuses from the selected project. For example, map Resolved to your project's Done status. This section shows after you select a project and issue type.

    Click Save. The department's Ticket Sync page then shows a Jira Settings row with a Connected menu, and summarizes the site, project, issue type, and status mappings you chose. To remove the sync later, open the Connected menu and choose Disconnect....

  5. Test

    Create a ticket via Risotto, then navigate to Jira to confirm the ticket was created there as well.

For more details on features, department configuration, and troubleshooting, see the Jira integration guide.

Something wrong or missing? Report an issue