Skip to content
Nexus CRM for Jira

Jira issues and JQL

Because Nexus CRM lives in Jira, the work you do for a customer and the customer record stay connected, with no integration to set up. A link between a work item and a CRM record shows on both sides.

One link shows on the Jira work item and on the CRM record, and JQL finds work items by the records they’re linked to.

First, an admin turns Nexus CRM on for each space that needs it, and picks how it shows on that space’s work items: a panel or a glance. See Placement in work items.

With the panel, Nexus CRM sits under the description.

The Nexus CRM panel on a Jira work item, on its Deals tab
The Nexus CRM panel on a Jira work item, on its Deals tab
  1. Companies, Contacts and Deals, each with how many are linked.
  2. + Link a record searches the CRM.
  • A linked record. Select it to open its details in a window over the work item, without leaving Jira.
  • ✕ unlinks it.

The glance puts a compact Nexus CRM entry in the work item’s details column instead, which opens the same tabs.

The Nexus CRM glance in a work item’s details column
The Nexus CRM glance in a work item’s details column

+ Link a record searches companies, contacts and deals in one go. Type part of a name or an email.

Linking a CRM record from a work item
Linking a CRM record from a work item
  • The search.
  • A result, with what kind of record it is. Link links it; Linked means it already is.

Select any linked record to see its details in a window over the work item.

A linked deal’s details open over the work item
A linked deal’s details open over the work item

Two actions in the work item’s ••• menu:

  • Link to CRM record opens the same search as the panel.
  • Create CRM record creates a contact, company or deal from the work item and links it in one step. The form starts filled in from the work item’s reporter and summary. If the record already exists, Nexus CRM offers to link that one instead.
Create CRM record from a work item’s ••• menu
Create CRM record from a work item’s ••• menu

Linking and unlinking need permission to edit the work item in Jira, and Write on that kind of record in Nexus CRM. People who can only view the work item see the links but can’t change them.

Every company, contact and deal has an Issues tab.

A deal’s Issues tab with linked work items
A deal’s Issues tab with linked work items
  • + Link issue finds a work item by key or text.
  • A linked work item, with its summary and status. Its key opens it in Jira.
  • (no access) marks a work item you aren’t allowed to see in Jira.

Events on linked work items also appear on the record’s timeline, under the Jira filter.

Nexus CRM adds three JQL functions. Each takes a name and returns the work items linked to the matching records:

issue in crmCompany("Fernhill")
issue in crmContact("Siobhan Kelly")
issue in crmDeal("Brightwater-3")

Names match case-insensitively and in part, so crmCompany("fern") finds Fernhill Telecom. crmContact also matches email addresses. Use not in to exclude: issue not in crmCompany("Fernhill").

Jira search finding work items linked to Fernhill Telecom with crmCompany
Jira search finding work items linked to Fernhill Telecom with crmCompany

The functions work everywhere JQL does: search, saved filters, boards, dashboards and service desk queues. Jira keeps each function’s answer, and Nexus CRM refreshes it a few seconds after a link changes or a record is renamed.