Prerequisites

Viable Issues can only be used if you have installed both Confluence and Jira. The download consists of two cohesive Apps. In Confluence you need to install Viable Issues for Confluence while in Jira you need to install Viable Issues for Jira.

Please note that you need the "System Administrator" permission in Confluence and "Jira System Administrators" permission in Jira in order to install and manage Apps. Please refer to the official documentation of Confluence and Jira for further information.

In order to make Viable Issues work, your Confluence and Jira installations must have an established Application-Link. We recommend using the authentication type "OAuth (impersonation)".

Additionally tick the "Allow Incoming" and "Allow anonymous access" checkboxes in Jira's Allowlist (formerly known as Whitelist) for the Application Link to Confluence so that Jira allows Confluence to be rendered there. Please refer to the official documentation for the Allowlist of Jira for further information.

Unrestricted communication between Confluence and Jira is vital for Viable Issues to work properly. Make sure the firewall is configured accordingly.

Please note, that at the moment Viable Issues always uses the first Application Link when reading from or writing to Jira.

How to install

There are two options to install the apps:

By searching the App directly in the Confluence and Jira Apps Manager, respectively
By clicking the button "Try it for free" or the link "Buy it now" on the Atlassian Marketplace listing

Confluence

Option 1:

As System Administrator navigate to the "Find new apps" section in the Confluence administration.
Type "Viable Issues for Confluence" into the search field and hit the Enter key.
Click on the button "Install" in order to proceed the installation.
Wait a few moments and a dialog will show you a "Accept & install" button.
After that the App will be installed and you see a confirmation message.

Option 2:

Open the Atlassian Marketplace listing for Viable Issues for Confluence and click on the button "Get it now".
After the download has finished, find "Manage apps" in the Confluence administration.
Use the "Upload app" link in order to install it.
After that the App will be installed and you see a confirmation message.

Jira

Option 1:

As Jira System Administrator navigate to the "Find new apps" section in the Jira administration.
Type "Viable Issues for Jira" into the search field and hit the Enter key.
Click on the button "Try it free" or use the link "Buy it now" in order to proceed the installation.
Wait a few moments and a pop-up window will show you a "Get license" button. You will be redirected to My Atlassian where you can start your free trial or buy a license. Use your existing Atlassian account or create a new one.
Enter your organization, accept the Terms of Use for the Atlassian Marketplace and click on the "Generate license" button.
As a result you see your license key, which you can directly apply to your Confluence installation. Alternatively you can copy the license key and paste it into the app listing of the "Manage apps" section in the Jira administration.

Option 2:

Open the Atlassian Marketplace listing for Viable Issues for Jira and click on the button "Try it free" or use the link "Buy it now".
Generate your license on My Atlassian with your existing Atlassian account or create a new one.
Follow the instructions in order to install the app and apply the license correctly.

First steps

Follow the Quick start guide Viable Issues Data Center & Server to proceed with the usage of Viable Issues for Confluence and Jira.

Browser not supported