Skip to main content

How to run a scan

launchpad://docs/standard
$launchpad open --docs How to run a scan
Starter·Platform: Jira Service Management Cloud (Assets)·Guide·Reading time: ~3 min·Version 1.1·Mar 2026

How to run a scan

Running a scan takes less than a minute. This page covers what you need before you start and the steps for both Environment Analysis and Request Flow Analysis.

Before you start​

For Environment Analysis​

You need an API token configured in LaunchPad. If you haven't set one up yet, go to LaunchPad Settings and add your Atlassian API token. The scanner uses it to read your Jira instance's spaces, service desks, and custom fields.

No other configuration is needed. The scan is read-only and doesn't change anything in your instance.

For Request Flow Analysis​

You need a Pro licence. Request Flow Analysis isn't available on Free plans.

You also need at least one service space in your Jira instance. The scanner analyses a single space at a time, so you'll choose which one to scan.

Running Environment Analysis​

  1. Open JSM LaunchPad from your Jira instance.
  2. Click the Environment Analysis card on the main screen.
  3. Click Run Analysis.

Environment Analysis ready to scan with Run Analysis button

That's it. The scan typically takes three to five seconds.

A terminal sidebar shows progress as LaunchPad reads your instance. When the scan completes, your results appear automatically.

Running Request Flow Analysis​

  1. Open JSM LaunchPad from your Jira instance.
  2. Click the Request Flow Analysis card on the main screen.
  3. Select the service space you want to analyse from the dropdown.
  4. Click Run Project Analysis.

Request Flow Analysis with space selector and Run Project Analysis button

The scan examines your space's request types and fields, then returns a breakdown of enrichment opportunities.

How long it takes​

Both scans are fast.

Scan typeTypical duration
Environment Analysis3 to 5 seconds
Request Flow AnalysisA few seconds, depending on the number of request types

There's nothing to wait for. Results appear immediately.

What to do next​

Once you have results, the next step is understanding what they mean. See Understanding scan results for a guide to reading and interpreting what the scanner found.