> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix Jira and Confluence connection states, awaiting-install, reconnects, and site switching.

Jira and Confluence connect separately, so check the specific product you're fixing in **Settings → Applications**.

## Connection states

Neo shows where you are in the connect flow:

* **Not connected**: you haven't authorized Atlassian yet, or you disconnected. Select the product and click **Authorize** to start.
* **Awaiting install**: you authorized, but the app isn't installed on a site yet. Click **Install** and approve it in Atlassian.
* **Connected**: Neo is live and responds to `@neo`.

## I can't find Neo on the Atlassian Marketplace

Neo isn't listed there, so searching the Marketplace for "Neo" or "ProjectDiscovery" returns nothing. That's expected. Neo is installed with a direct install link instead.

Start from Neo: **Settings → Applications**, select **Jira** or **Confluence**, and follow the connect flow. If an admin has to approve it, send them the install link rather than restarting the setup as them. See [Have your Atlassian admin approve the install](/integrations/jira-install-and-connect#have-your-atlassian-admin-approve-the-install).

## Atlassian won't let me approve the install

Approving the install needs **Jira or Confluence admin** rights. Without them the approval is refused and the connection stalls before **Connected**.

This only blocks the **Install** step. **Authorize** needs no admin rights, so complete that yourself first: it lets Neo recognize your site so the install links up automatically when your admin approves it.

Send your admin the install link from that product's entry in Neo's Applications settings, or the URL of the Atlassian consent screen your own connect flow opened. Your admin doesn't need a Neo account to approve it. Once they approve it, the install lands and Neo updates on its own. Both links are in [Have your Atlassian admin approve the install](/integrations/jira-install-and-connect#have-your-atlassian-admin-approve-the-install).

## It still says "Awaiting install" after I installed

The install takes a moment to reach Neo, and the status updates on its own.

* Wait a minute or two, and it switches to **Connected** automatically.
* Confirm you installed on the **same site** you meant to connect.

## I reconnected but had to install again

The app was fully **uninstalled** from Atlassian, so reconnecting needs a reinstall.

* If the app is still installed, **Reconnect** only needs the Authorize step.
* If it was uninstalled, authorize **and** install again.

## It connected to the wrong site

Your Atlassian account can access more than one site.

* If Neo asks, pick the right site in the **Choose a site** step.
* To move later, just install Neo on the site you want, and it becomes the connected one.

## Neo doesn't respond to `@neo`

* The comment didn't mention `@neo` (or `/neo`). Plain comments are ignored.
* The product isn't **Connected**. Check its status in Settings.
* The app is **Outdated** after a permissions change. A Jira or Confluence admin approves the update in **Atlassian → Manage apps**.

## Neo can't read or write Confluence

* Confluence must be connected on its own, since connecting Jira alone isn't enough.
* Neo can read, search, create, update, and archive Confluence pages once connected.
* If page creates or edits fail, the install may be **Outdated** after the write-permission change. A Confluence admin approves the update in **Atlassian → Manage apps**.

## Disconnect didn't remove the app from Jira

This is expected. Disconnecting in Neo drops the link but **leaves the app installed**. To fully remove Neo, uninstall it from **Atlassian admin → Manage apps**.

## Still need help?

* [Privacy & Support](/integrations/jira-privacy-and-support)
* [ProjectDiscovery Support](https://projectdiscovery.io/support)
* [ProjectDiscovery Contact](https://projectdiscovery.io/contact)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.