> ## Documentation Index
> Fetch the complete documentation index at: https://sleekplan.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Jira integration (Data Center)
> Connect Sleekplan to your self-hosted Jira Data Center or Server instance to create, link, and status-sync feedback posts with Jira issues.
The Jira Data Center integration links your Sleekplan feedback posts to issues in a **self-hosted** Jira Data Center or Jira Server instance. From a feedback post you can create a new Jira issue or link an existing one, and status changes flow both ways: move a post along your board and the linked Jira issue transitions, or change the Jira issue's status and the post follows.
This article is for **self-hosted Jira Data Center / Server**, where you run Jira on your own infrastructure. If your Jira lives at an `atlassian.net` address, use the [Jira Cloud integration](/help/integrations/jira-cloud) instead, which installs from the Atlassian Marketplace with no manual setup.
## How Data Center differs from Jira Cloud
Data Center is self-hosted, so Sleekplan cannot install a Marketplace app into it. Instead you connect the two systems yourself:
* You provide your Jira **base URL** and a **personal access token (PAT)** so Sleekplan can call your Jira instance.
* You register a **webhook** in Jira so Jira can notify Sleekplan when an issue changes.
Jira Cloud handles all of this through a one-click Marketplace app. Everything else, creating and linking issues and syncing statuses, works the same in both.
## Before you start
Connecting an integration is available to workspace **owners and admins**. You also need administrator access to your Jira Data Center instance to create a token and register the webhook.
* **Your Jira instance must be reachable from Sleekplan's servers.** Sleekplan connects to your Jira over the public internet from a fixed IP address, `168.119.102.99`. If your Jira sits behind a firewall or allowlist, permit that IP so the connection and webhook can get through.
* **Use a dedicated Jira account for the token.** Create the personal access token from a service or admin account (for example, a "Sleekplan" user) rather than a personal one, so the link keeps working when individuals leave.
## Set up the integration
The setup has three parts: create a token in Jira, connect it in Sleekplan, then register the webhook back in Jira using the URL Sleekplan gives you.
In your Jira Data Center instance, open your **profile menu → Personal Access Tokens** and create a new token. Give it a recognizable name such as `Sleekplan Integration` and turn off automatic expiry so the connection does not silently break later. Copy the token value now, because Jira shows it only once.
The account you create the token from must be able to view projects, view issues, transition issues, and add comments, since Sleekplan performs those actions on your behalf.
Go to [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations), find **Jira (Data Center)** in the list, and select **Connect**.
In the setup dialog, paste your **Personal access tokens (PAT)** and your Jira **Base URL** (for example `https://jira.yourcompany.com`). This is the address you use to reach Jira in your browser, without any project or issue path.
The dialog shows a **Register this webhook in your Jira DC instance** field with a URL unique to your workspace. Copy it. You will paste it into Jira in the next step so status changes made in Jira flow back to Sleekplan.
In Jira, go to **Administration → System → WebHooks** and create a new webhook:
* **Name**: something clear, such as `Sleekplan`.
* **Status**: Enabled.
* **URL**: the webhook URL you copied from Sleekplan.
* **Events**: select **Issue → updated** so Jira notifies Sleekplan whenever an issue changes.
Save the webhook.
Back in the Sleekplan dialog, select **Connect**. Sleekplan verifies the token and base URL against your Jira instance. If the details are correct, Jira (Data Center) moves into your **Connected** list. If you see a connection error, re-check the base URL, the token, and that `168.119.102.99` is allowed through your firewall.
## Map Jira statuses to Sleekplan statuses
Status sync is driven by a mapping you control: each Jira status points to one of your Sleekplan [statuses](/help/feedback/statuses). Until you map them, statuses will not sync.
On [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations), find Jira (Data Center) under **Connected** and select **Manage**.
For every Jira status, choose the Sleekplan status it should stay in sync with, or leave it as **None** to ignore that status. For example, map Jira's "In Progress" to your "In progress" and Jira's "Done" to your "Live". Save your changes.
The mapping works both directions:
* When a linked post's status changes in Sleekplan, the Jira issue transitions to the matching Jira status.
* When a mapped Jira issue's status changes, the linked Sleekplan post updates to the paired status.
## Link a post to a Jira issue
Once connected, every feedback post gets a Jira panel where you link work to Jira.
Go to [**Feedback**](https://app.sleekplan.com/feedback) and open the post you want to connect to Jira.
In the Jira panel, search by summary or issue key to find an existing issue and link it, or select **Create new issue** to make one. Creating an issue lets you set a title and description and pick the target **project** and **issue type**.
Once linked, the panel shows the linked issue with a button to open it in Jira, and Sleekplan adds a comment to the Jira issue pointing back to the post. To break the connection later, use **Unlink issue**.
Each feedback post links to a single Jira issue at a time. Linking a different issue replaces the previous link.
## Troubleshooting
* **The connection fails when you select Connect.** Confirm the base URL is the plain host address (no `/browse/...` path), the token is valid and unexpired, and your firewall allows Sleekplan's IP `168.119.102.99`.
* **Statuses are not syncing.** Open **Manage** and check the status mapping. Any Jira status left as **None** is ignored. For Jira-to-Sleekplan sync, also confirm the webhook is registered and enabled in Jira with the **Issue → updated** event.
* **Nothing happens when a Jira issue changes.** The webhook drives Jira-to-Sleekplan updates. Re-check that the webhook URL matches the one in the setup dialog and that its status is Enabled.
## Related
Connect a hosted Jira Cloud instance from the Atlassian Marketplace.
Set up the statuses you map Jira issues to.
Browse everything Sleekplan connects with.