Map Jira statuses

How to get there: Go to Settings in the sidebar, open the Integrations tab (under Other), expand the Jira section, and scroll to Status mapping.

Status mapping keeps a ProductLift post and its linked Jira issue in the same state. When a post changes status in ProductLift, ProductLift transitions the Jira issue. When the Jira issue is transitioned in Jira, the inbound webhook moves the post in ProductLift.

You need a working Jira connection first. See Connect Jira.

How a mapping rule works

A rule pairs one ProductLift status with one Jira state name (case-insensitive).

  • ProductLift status: picked from the statuses configured on your portal.
  • Jira state: typed by hand (for example To Do, In Progress, Done).

Mapping is bidirectional. The same rule handles outbound transitions (ProductLift to Jira) and inbound webhook events (Jira to ProductLift).

Add a mapping

  1. In the Jira integration card, scroll to Status mapping.
  2. Click Add rule.
  3. Pick the ProductLift status on the left.
  4. Type the matching Jira state name on the right.
  5. Repeat for each pair you want kept in sync.
  6. Click Save mappings.

Statuses without a rule are ignored on both sides.

Notify voters on inbound changes

Tick Notify voters when status changes via inbound webhook if you want voters on a post to receive an email when Jira pushes a status change back. Outbound changes (admin moving the post in ProductLift) follow your normal notification rules.

Set up the inbound webhook

Status sync from Jira to ProductLift requires the inbound webhook. Copy the URL shown in the Jira card and configure it in Jira under Settings, System, Webhooks with the Issue - Updated trigger. Full steps are in Connect Jira.

Troubleshooting

  • Nothing happens when I change a ProductLift status: confirm there's a mapping rule for that status, and that Jira offers a transition from the issue's current state to the mapped state. ProductLift can only use transitions Jira makes available.
  • Jira state name changed: update the rule to match the new name (case doesn't matter, spelling does).
  • Status moves in Jira but not in ProductLift: check the inbound webhook is configured in Jira and pointing at the URL from the Jira card.