# Jira Notion integration Getint's Jira-Notion integration enables users to sync project data between the two platforms. Once set up, users can view and manage Jira tickets, tasks, bugs, and epics directly within Notion, providing a unified workspace for project tracking and team collaboration. Initially, the integration supports syncing only the title and description fields between Jira and Notion items, with plans to map additional fields like assignees, statuses, labels, and custom fields in future updates. As a relatively new integration, full feature parity between Jira and Notion may not yet be available. However, Getint is committed to ongoing development and values user feedback to prioritize and expand integration capabilities. If certain functionalities are missing or challenges arise during setup, users are encouraged to reach out. The guide below offers a 3-minute setup process for a functional MVP integration, with Getint's dedicated team available for personalized onboarding, expert support, custom script assistance for complex scenarios, and bespoke development solutions. {% embed url="" %} #### **1. Access the** [**Getint**](http://getint.io/) **App in Jira:** * Navigate to Jira, go to "Apps," and select "the Getint app."

* Select "Create Integration" then "Continuous Sync" or "Migration" based on your requirements.

Having issues building your integration? Schedule a free consultation with our Integration Experts now!

#### **2. Token Generation for Jira Cloud:** * Visit Atlassian Account Settings. {% embed url="" %} * Go to Security * Navigate to the API Token section and generate a token. This token serves as the password for Jira Cloud. {% embed url="" %} #### **3. Establish a** **Connection with Jira:** * Ensure you're logged in as a user with the correct permissions * Click "Select App" and choose Jira. * Select "Create New" to establish a new connection with your Jira instance. * Name your connection, and add the URL of your Jira instance (without "/" at the end). * Provide the login credentials. {% embed url="" %} **4. Choose the Jira Project:** * With a successful connection, a dropdown menu will appear. * Select the Jira project you want to integrate. {% embed url="" %} **5. Connect to Notion:** * In the Notion app, click on the three dots in the top right corner. * Select "Add a Connection," then navigate to "Manage Connections" and choose "Develop or Manage integrations." {% embed url="" %} * Select "New Integration." * Provide a name for your integration, grant necessary permissions, and copy the API token. {% embed url="" %} * Close the window, return to the Notion dashboard, and click on the three dots again. * Scroll down to add a connection and select the name of the connection that you have already created. {% embed url="" %} {% hint style="info" %} It might be necessary to refresh your browser to see the new connection in the list. {% endhint %} #### **6. Configure** [**Getint**](http://getint.io/) **for Notion:** * In the [Getint](http://getint.io/) app, choose "Notion" as the connection app. * Select "Create a new connection," name it, and provide the API Token. * Select the connection you want to integrate. * Choose the Notion database to synchronize. {% embed url="" %} #### **7. Map Types:** * Link Jira types (Task, Bug, Epic, Story) to synchronize in Notion. * Specify the fields for integration or synchronization. {% embed url="" %} {% hint style="info" %} Please note that the current version of Getint for Notion only supports the "Title" and "Description" fields. For syncing other fields like assignees, statuses, labels, or custom fields, please contact us directly at . {% endhint %} #### **8. Field Mapping:** * Map key fields such as title/summary and description * After configuring, name and save your integration settings. {% embed url="" %} {% hint style="warning" %} The "Description" field in Notion supports a maximum of 2000 characters. To avoid sync errors and blank description fields when transferring text from Jira to Notion, ensure your content does not exceed this limit. Keeping descriptions concise and within the character count helps maintain data integrity and prevents synchronization issues. {% endhint %} #### **9. Filtering:** It is possible to filter the synchronization to have them customized for your needs and requirements. **UI Filtering Option:** * Click on the filtering icon near the app icon in your integration. This will apply to that side of the integration. * Select if the filtering will apply to All items, New items, and Synced items. * Note that if the option "*New items"* is selected, the filtering will apply only to the new items, and the already synced items will continue to sync and update. If the option "*Synced items"* is selected, only the already synced items will be updated based on that filter. * Choose the options and add the value for the filter. It is possible to filter more than one option for each field. * Select Apply once you created the filters and Save the integration. {% embed url="" %} **JQL Filtering:** * Select the app that will receive the filter. * Under the field Custom JQL, it is possible to provide a JQL, which will be the filter for your sync and appended to the one generated when searching for issues in Jira (e.g., status in ('In Progress')). * Save the integration. {% embed url="" %} #### **10. Duplicate Setup and Select Different Projects:** * Go to Workflows. * Click on the 3 dots on the right side and select "duplicate." * A side panel will appear. Select a new name for the integration (by default, the integration will be called “copy of” if the same projects are established). * On the dropdown menu, select the projects that you would like to integrate. * For each side, select Connect. Then Duplicate. * Save the new integration. {% embed url="" %} {% hint style="info" %} If you require further assistance with your integration or if you have any questions about Getint, feel free to open a ticket at our [Support Center](https://getint.io/help-center) or [Schedule a Demo](https://calendly.com/d/cpws-jb2-8xx/demo-call-all-team). {% endhint %}