Quick Start Tutorial

Before you begin

Make sure your Jira Administrator has completed the initial app setup — in particular, Lifecycle Mapping — in App Configuration. These settings affect how Metrics calculate results across all reports. If you are not sure whether this has been done, check with your admin before proceeding.

This tutorial walks you through creating your first report in Dashlytics from start to finish. By the end you will have a saved report showing work item counts grouped by space.

The pattern you learn here applies to every report you build in Dashlytics: choose a data source, arrange dimensions to define how the data is sliced, add Metrics to define what is calculated, and save. Once you understand that pattern, you can apply it to any reporting question your team has.

Step 1: Select a Template from the Home Page

  1. Log into your Jira Cloud instance.
  2. In the left sidebar, click Apps → Dashlytics.
  3. On the Home screen, scroll to the Start from a template section. Use Search templates (1) to find one by name.
  4. Click Use template (2) on any template.

The Start from a template section on the Home screen, with the search field and a Use template button numbered

Using a template opens the Report Builder with the report pre-configured and ready to customise.

Step 2: Review or Update the Data Source

Each template already includes a pre-configured data source (JQL query). You can keep the existing query or modify it to match the spaces, work types, teams, or time range you want to analyse.

  1. Review the JQL query shown in the JQL field (1).
  2. Optionally update the query to suit your use case.
  3. Click Search (2) to refresh the report data.

The Work Items count (3) updates to show how many work items match the current query.

The Data source card with the JQL field, the Search button and the Work Items count numbered

Step 3: Customise the Report (Optional)

Templates are already configured with dimensions, Metrics, and filters. You can start using the report immediately or customise it further based on your reporting needs.

Add or Change Dimensions

Dimensions define how the data is grouped and sliced.

  1. Click the Configure button.
  2. On the Layout Designer tab (1), drag dimensions from the Dimensions list (2) into Filters (3), Rows (4), or Columns (5).
  3. Click Apply (6).

For example, you can add Space, Assignee, or Time dimensions to change how the report is organised.

Configure report dialog on the Layout Designer tab, with the tabs, the Dimensions list, the Filters, Rows and Columns zones and the Apply button numbered

Add or Change Metrics

Metrics define what values are calculated in the report.

  1. Open the Add Metrics tab.
  2. Expand a category under Available Metrics (1).
  3. Click Add next to any Metric you want to include. It appears under Selected Metrics (2).
  4. Click Apply.

For example, you can add Metrics such as Work Items Created, Cycle Time, or Story Points Completed.

Add Metrics tab with the Metric categories and the selected Metrics numbered

Add or Change Filters

Filters allow users to narrow report results interactively.

  1. On the Layout Designer tab, drag dimensions into the Filters zone.
  2. Click Apply.

The filters (4) appear above the report and can be changed without modifying the saved report structure.

The rendered report with the view format selector, the export and debug icons, the filters and the table numbered

Step 4: Save the Report

  1. Click Save as in the toolbar.
  2. Enter a Report name (1) — up to 60 characters.
  3. Optionally add a Description (2).
  4. Click Save report.

Save report as dialog with the Report name and Description fields numbered

Your report is now saved and will appear on the Home screen. It is also available to embed in any Jira dashboard using the Dashlytics Statistical Report Gadget.

What's Next?

You now know the core pattern: data source → dimensions → Metrics → save. From here:

  • Explore more Metrics — the Metrics reference documents every available Metric and what it measures.
  • Try different dimensions — add Time to Rows to see trends over weeks or months, or swap Space for Assignee to see distribution by person.
  • Embed in a dashboard — see Using Dashboards to display your saved report on a Jira dashboard.
  • Set up a Work Calendar — if your team uses time-based Metrics like Cycle Time or Time in Status, configure a calendar first — see Work Calendar Setup.
For AI agents: the complete documentation index is available at https://dashlytics-docs.vivek-fitkariwala.workers.dev/llms.txt, the full documentation bundle is available at https://dashlytics-docs.vivek-fitkariwala.workers.dev/llms-full.txt, and this page is available as Markdown at https://dashlytics-docs.vivek-fitkariwala.workers.dev/getting-started/quick-start-tutorial/index.md.