# Allure 3 reporting for Katalon Studio, one command to install

**URL:** <https://forum.katalon.com/t/allure-3-reporting-for-katalon-studio-one-command-to-install/194069>\
**Category:** Web Testing\
**Created:** [September 20, 2026, 2:35pm UTC](https://forum.katalon.com/t/allure-3-reporting-for-katalon-studio-one-command-to-install/194069 "2026-09-20T14:35:23Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Monty\_Bagati](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/monty_bagati/32/33047_2.png) [@Monty\_Bagati](https://forum.katalon.com/u/Monty_Bagati)\
**Post date:** [September 20, 2026, 2:35pm UTC](https://forum.katalon.com/t/allure-3-reporting-for-katalon-studio-one-command-to-install/194069/1 "2026-09-20T14:35:23Z")

</div>

Katalon has no first-party Allure adapter, so I maintain two open source bridges that add one. The Allure 3 version is out now and I wanted to share it here, along with one gotcha that will bite anyone moving from Allure 2.

## Install

Needs Node.js 18 or newer.

```auto
npx allure3-katalon-bridge install "/path/to/your/katalon/project"

```

There are also double-click installers under `Windows/`, `macOS/` and `Linux/` if you would rather not use a terminal.

It copies a Test Listener, some Keywords, config and two jars into the project. Katalon auto-discovers the listener, so nothing else is wired up. No plugin, no OSGi packaging, and no changes to your existing Test Cases or Test Suites. Re-running it upgrades in place, and uninstall removes exactly what it installed.

## What you get

Run any Test Suite or Test Suite Collection as normal. Afterwards you get one self-contained `.html` in `allure-report/` that you open by double clicking. No server, no separate `allure generate` step.

A Test Suite Collection produces one combined report named after the collection, not one report per member suite.

You also get failure screenshots for WebUI tests, Katalon log lines as nested Allure steps, browsers as first-class Allure environments, and trend and retry history that carries forward between runs.

There is no global Allure install. The Allure 3 CLI is a Node program, so it ships pinned inside the package and its exact path is recorded at install time. If you ever fought with Katalon Studio not finding `allure` on PATH when launched from the Start Menu or Dock, that class of problem is gone.

## The gotcha if you are coming from Allure 2

Allure 3 reads Allure 2 results natively, so it is tempting to point `allure` 3.x at an existing Allure 2 bridge’s output. Do not. You get a report that looks fine and is not.

Allure 3 ignores the `historyId` a result declares and recomputes its own, then groups retries and shows only the newest attempt in each group. Katalon reuses one test case across many suites under a single `testCaseId`. Put those together and separate runs of the same test case look like retries of each other.

On a real six result run with one genuine failure, that showed two tests and reported the build as passed. The failing run was hidden behind a later passing one.

This bridge writes a `Suite` parameter, a `browser` label and a `Browser` parameter so each execution keeps its own identity, in the report body and in history. Same run, same results: six tests, reported failed.

## CI

Verified on Azure Pipelines hosted agents for Windows, macOS and Ubuntu. Ready-to-copy configs are in the repo for Azure Pipelines, GitHub Actions and GitLab CI.

Two things Linux needs that the other two do not, both included in the example config: Xvfb, because Katalon Studio is an Eclipse application and wants a display even when the browser runs headless, and JDK 21, because Katalon 11.x’s OSGi bundles require it and the Ubuntu image does not default to it.

## Links

- GitHub: [GitHub - montbaga/allure3-katalon-bridge: Zero-touch Allure 3 reporting for Katalon Studio projects : Install with one command, no plugin, no OSGi packaging, no global Allure install · GitHub](https://github.com/montbaga/allure3-katalon-bridge)
- npm: [https://www.npmjs.com/package/allure3-katalon-bridge](https://www.npmjs.com/package/allure3-katalon-bridge)
- Allure 2 version, still maintained: [GitHub - montbaga/allure-katalon-bridge: Zero-touch Allure reporting for Katalon Studio : No plugin, No OSGi packaging, No test script changes. · GitHub](https://github.com/montbaga/allure-katalon-bridge)

Apache 2.0. Tested against Katalon Studio 11.3 and 11.4.

Happy to answer questions here, and issues or feature requests are welcome on the repo. If you try it on a Katalon version or CI setup I have not covered, I would like to hear how it goes

 ![npx_1st_step](https://europe1.discourse-cdn.com/katalon/original/3X/8/c/8c449f02d07608743d87bb35332c587613530de1.jpeg)  
 ![run_test_suite_or_collection_2nd_Step](https://europe1.discourse-cdn.com/katalon/original/3X/1/5/156a7375c4231d21d90ba580f25a3ccd91d3b7bc.jpeg)  
 ![allure_report_3rd_Step](https://europe1.discourse-cdn.com/katalon/original/3X/7/b/7b5d7f3f72cd36e01da9b88652818cf8b71921ed.jpeg)

 ![laststep_reports_1](https://europe1.discourse-cdn.com/katalon/original/3X/d/6/d6100963abe1392e88d3b77c39939f83bdadd802.jpeg)  
 ![laststep_reports_2nd](https://europe1.discourse-cdn.com/katalon/original/3X/e/4/e42170a726889198c2be055abd6fe8d8d3a83c20.jpeg)

 ![laststep_graphs_1](https://europe1.discourse-cdn.com/katalon/original/3X/6/8/68e45a68f458851923cf1de495cd8dcd887ad540.jpeg)  
 ![laststep_graphs_2](https://europe1.discourse-cdn.com/katalon/original/3X/6/1/616722ce6ff5d2e812882001694ef0f40bee89f2.jpeg)  
 ![laststep_graphs_3](https://europe1.discourse-cdn.com/katalon/original/3X/3/6/36dc8f02204830b1cb615dd7d6387ee9c27c4dc3.jpeg)  
 ![laststep_graphs_4](https://europe1.discourse-cdn.com/katalon/original/3X/d/3/d33bd1d82f73c9186fdf759bbb6adb10f5f207b1.jpeg)

 ![FailedTestCaseDetailed_1](https://europe1.discourse-cdn.com/katalon/original/3X/a/f/affc300b9d7bd8414558892d2865d3aa5ef90a3e.jpeg)  
 ![FailedTestCaseDetailed_2](https://europe1.discourse-cdn.com/katalon/original/3X/f/e/fe18b57bb5489923e0343756198163ceada97bc0.jpeg)  
 ![FailedTestCaseDetailed_3](https://europe1.discourse-cdn.com/katalon/original/3X/d/b/dba7001629e9ba26d60cd5bd3970fdc77a17259b.jpeg)  
 ![macos_ci_ado](https://europe1.discourse-cdn.com/katalon/original/3X/8/0/807da075e3b5a73578a2c64dcb65520f0ace3db8.jpeg)  
 ![macos_ci_ado_allure3_reports](https://europe1.discourse-cdn.com/katalon/original/3X/0/1/01343ecd5f6787b9776f71ab8f30edafb93f2a86.jpeg)  
 ![macos_ci_ado_artifacts](https://europe1.discourse-cdn.com/katalon/original/3X/a/d/ad64702d6ced96c8c2a90355255b92747106278c.jpeg)  
 ![ubunti_ci_ado](https://europe1.discourse-cdn.com/katalon/original/3X/a/a/aa5472aedd7396fb10b904c5b83921a270fd0c23.jpeg)  
 ![ubunti_ci_artifacts](https://europe1.discourse-cdn.com/katalon/original/3X/3/f/3f874e0f4ab5fff18a921861cb75b071e4c18484.jpeg)  
 ![windows_ci_ado_allure3_report](https://europe1.discourse-cdn.com/katalon/original/3X/0/5/05f86c17c255c7e514a5e7ce586cdfe4c47a7ffd.jpeg)  
 ![windows_ci_ado_artifacts](https://europe1.discourse-cdn.com/katalon/original/3X/c/f/cf05d223560261dd945e365566206a835177efb4.jpeg)

---

<div class="post-metadata">

**Author:** ![dineshh](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/dineshh/32/24488_2.png) [@dineshh](https://forum.katalon.com/u/dineshh)\
**Post date:** [September 21, 2026, 4:06am UTC](https://forum.katalon.com/t/allure-3-reporting-for-katalon-studio-one-command-to-install/194069/2 "2026-09-21T04:06:12Z")

</div>

Congrats @Monty_Bagati

---

<div class="post-metadata">

**Author:** ![Monty\_Bagati](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/monty_bagati/32/33047_2.png) [@Monty\_Bagati](https://forum.katalon.com/u/Monty_Bagati)\
**Post date:** [September 21, 2026, 4:21am UTC](https://forum.katalon.com/t/allure-3-reporting-for-katalon-studio-one-command-to-install/194069/3 "2026-09-21T04:21:16Z")

</div>

thx @dineshh pls try it and let me know your feedback
