Getting started

Install the app, work through the Get started checklist, make your first choices and check it from the portal.

“Every request you raised, in one list.” Beside it, My requests with Status set to Any status and Reporter set to Created by me: 14 requests in a table of request type, summary, status, space and reporter.
What customers see once PortalPilot is set up.

1. Install

A Jira admin installs PortalPilot on the site from its Atlassian Marketplace listing, with a free trial or a paid subscription. See Install PortalPilot and Subscription, trial and licensing.

2. Work through Get started

In Jira settings, under Apps, open PortalPilot. Get started lists four steps, each with a button that opens the right page. A bar shows how many steps are done, for example “2 of 4 steps done”.

StepOpensMarked Done when
Adjust general settingsGeneral settingsGeneral settings have been saved at least once.
Create user scopesScopes configurationAt least one scope exists.
Configure custom fieldsFields configurationAt least one field has been changed from its default and saved.
Manage filtersFilters managementThe Save and share rules have been saved, or a global filter exists.

The steps are a guide. PortalPilot works with its defaults whether or not they are done.

3. Make your first choices

Most admins decide these first:

  • Who can use it: Visibility in General settings. Everyone, or only selected users, organisations, groups and scopes.
  • What the banner says: its text and button label, on the Banner tab.
  • Where it opens: Pivot, My requests or All requests, under Navigation on the Visibility tab.
  • Which statuses mean “waiting on the customer”, so the Waiting on you tile counts the right requests.
  • Whether customers can export, and how many requests a file may hold.
  • Which custom fields to offer as columns and filters, in Fields configuration.
  • Who may save, share and manage filters, in Filters management.

If you will reuse the same people in several places, create user scopes first.

4. Open it from the portal

  1. Go to the customer portal, signed in as a customer, and open Requests.
  2. In the banner above the list (by default “Switch to PortalPilot”), select “Open PortalPilot”.
  3. PortalPilot opens full screen. Close it with Jira’s close button to return to the Requests page.

To check a Visibility rule, sign in as a customer it should allow, and as one it should not.


Need help with PortalPilot? Contact us