TestRail Dashboards Integrations

Dashboards: Introduction

TestRail allows you to integrate reporting dashboards in third-party applications like Confluence, wiki tools, intranets, and project management applications. To integrate the dashboards, TestRail provides special pages that can be used in iframes. The pages render without any TestRail navigation menus so it’s easy to natively integrate the pages in other applications.

If you are interested in integrating TestRail’s dashboards with Confluence, please also see our separate Confluence integration page.

Please note: If you are using HTTPS for your host application (e.g. Confluence, Sharepoint or similar), TestRail also needs to use HTTPS and the referenced URLs need to start with https://. Otherwise browsers will not load the referenced frames.

Available dashboards

TestRail provides two main dashboards that can be integrated in third-party applications. Each dashboard link can also be customized with various parameters (please see below).

Main dashboard

The main dashboard shows an overview of available projects, the activity chart as well as options to expand projects to review related milestones. Clicking on a project loads the relevant project dashboard. Example address:

https://example.testrail.com/index.php?/ext/common/dashboard

Project dashboard

The project dashboard provides a snapshot and all relevant details for a specific project, including related test runs, milestones, recent reports and project activity. Example address:

https://example.testrail.com/index.php?/ext/common/projects/1

Parameter reference

The dashboard integration pages support various optional parameters to customize the style of the pages. For example, to include a border around the integration page with additional padding, the integration link could look like this.

https://example.testrail.com/index.php?/ext/common/dashboard&
border_style=solid&border_color=c0c0c0&border=1&padding=15&margin=20

Please see below for a full reference of supported parameters for the different integration pages.

Parameter	Example	Description
padding	padding=10	The padding TestRail should add to the main container element.
margin	margin=10	The margin TestRail should add to the main container element.
border	border=10	The border width TestRail should use for the main container element.
border_radius	border_radius=10	The border radius TestRail should use for the main container element.
border_color	border_color=c0c0c0	The border color TestRail should use for the main container element.
border_style	border_style=solid	The border style TestRail should use for the main container element.