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

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”.
| Step | Opens | Marked Done when |
|---|---|---|
| Adjust general settings | General settings | General settings have been saved at least once. |
| Create user scopes | Scopes configuration | At least one scope exists. |
| Configure custom fields | Fields configuration | At least one field has been changed from its default and saved. |
| Manage filters | Filters management | The 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
- Go to the customer portal, signed in as a customer, and open Requests.
- In the banner above the list (by default “Switch to PortalPilot”), select “Open PortalPilot”.
- 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.
Related pages
Need help with PortalPilot? Contact us