Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Concordion

concordion.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.9 Club score Visit concordion.org

What Concordion is

Concordion is an open-source tool for Specification by Example and living documentation. It turns examples in specifications into executable checks against a system under test, and running those checks generates documentation. Results mark passing and failing assertions and show expected and actual values when a check fails; output can also include tables and links to other specifications. The project offers Java options with Markdown or HTML specifications, alongside C# options. Java fixtures use JUnit, and Concordion.NET is documented with NUnit. Integrations include IntelliJ IDEA, Eclipse, Gradle, Maven, command-line execution, Jenkins, and Spring. The IntelliJ plugin supports HTML and Markdown specifications, while the Eclipse plugin supports HTML but not Markdown. Extensions can add commands, event listeners, or documentation changes, with examples including Excel specifications, parallel runs, screenshots, and logging. Concordion is licensed under Apache License 2.0 and maintained by volunteers, with a Google Group and GitHub for contact and participation.

Who it suits

Concordion is aimed at stakeholders, analysts, developers, and testers who want executable specifications and generated documentation. It suits teams working with Java or C# and the listed test and build integrations.

Good to know, and what to watch

  • Generates documentation while executable checks run.
  • Shows expected and actual values for failed assertions.
  • Supports Java and C# options.
  • Integrates with IntelliJ IDEA, Eclipse, Jenkins, and build tools.
  • Apache License 2.0 open-source tool.
  • Eclipse plugin does not support Markdown specifications.
  • Jenkins Content Security Policy can block report features.
  • Maintained by volunteers.

Open source

Free

Open source

Getting started

  1. Open the Concordion website
  2. Choose the Java Markdown, Java HTML, or C# option
  3. Add the Java distribution through Gradle or Maven, or download the full ZIP
  4. Configure a JUnit fixture for Java or NUnit with Concordion.NET
  5. Connect the checks to application code or an interface library
  6. Run the specifications locally or through a documented build integration
  7. Publish results through the Jenkins HTML Publisher plugin if needed

Limits to check

Jenkins Content Security Policy settings can prevent Concordion reports from working fully because the reports use inline CSS and JavaScript. The Eclipse plugin supports HTML specifications but not Markdown.

The verdict

Concordion links specifications, checks, and generated documentation, with integrations for common development and test workflows. Teams should account for the IDE format difference and Jenkins report limitation.

Questions people ask

Is Concordion free?

Yes. Concordion is open source, with the listed plan priced at no cost and licensed under Apache License 2.0.

Which operating systems can run it?

The listed platforms are Linux, macOS, self-hosted, and Windows.

Which specification formats are available?

The download page offers Java with Markdown or HTML specifications and C# options.

Which test frameworks does it use?

Java fixtures use JUnit, and Concordion.NET integration is documented with NUnit.

Can it test browsers or APIs?

Yes. Concordion can drive deployed interfaces through libraries such as Selenium WebDriver, JAX/WS, JAX/RS, or JDBC.

How does Jenkins reporting work?

The Jenkins HTML Publisher plugin can publish Concordion results, retain per-build history, and provide the output as a ZIP file.

What the maker publishes

Application interfaces
Concordion can invoke application code directly or drive deployed application interfaces through libraries such as Selenium WebDriver, JAX/WS, JAX/RS or JDBC. source
Audience
The site identifies stakeholders, analysts, developers and testers as intended users. source
Build integrations
The Java integrations page documents Gradle, Maven, command-line execution and Jenkins report publishing. source
Build requirement
Java downloads are available through Gradle and Maven, and the page says JUnit Vintage is also needed to use concordion:run with a JUnit 4 fixture. source
Documentation output
Generated specifications highlight passing and failing assertions, show expected and actual values on failure, and can include tables and links to other specifications. source
Executable specifications
Concordion instruments examples in specifications as automated checks that run against the system under test. source
Extensions
Extensions add functionality such as new commands, event listeners, and changes to generated documentation; listed examples include Excel specifications, parallel runs, screenshots, and logging tools. source
Founded
2006 source
How it works
Concordion turns specifications into executable checks that generate documentation when the checks run. source
IDE integrations
The site describes an IntelliJ IDEA plugin with completion, navigation and test-running support, plus an Eclipse plugin for HTML specifications. source
IDE support
The IntelliJ plugin supports HTML and Markdown specifications, while the Eclipse plugin supports HTML but not Markdown. source
Integrations
The Java integration page lists IntelliJ IDEA, Eclipse, Gradle, Maven, command line, Jenkins, and Spring integrations. source
Intended users
The site identifies stakeholders, analysts, developers, and testers as users Concordion is for. source
Java distribution
The Java page lists version 4.0.1 for Gradle and Maven and offers a full distribution ZIP with source code and dependencies. source
Jenkins limitation
The integrations page warns that Jenkins Content Security Policy settings can prevent Concordion reports from working fully because reports use inline CSS and JavaScript. source
License and maintenance
The FAQ states that Concordion is licensed under Apache License 2.0, and the site says it is maintained by volunteers. source
Privacy
The site privacy policy says it uses Google Analytics cookies and describes collecting browser, language, referring site, date, time, and visitor-request location data. source
Purpose
Concordion is an open-source tool for automating Specification by Example and creating living documentation. source
Results
Generated documentation highlights passing and failing assertions and shows expected and actual values on failure. source
Security limitation
The Jenkins integration page says Jenkins Content Security Policy defaults can block inline CSS and JavaScript used by Concordion reports, and describes relaxing the policy as a workaround. source
Specification formats
The download page offers Java with Markdown or HTML specifications and C# options. source
Support
The project is maintained by volunteers and links to a Google Group and GitHub for contact and project participation. source
Support
The FAQ directs users to the Google Group or Stack Overflow for general questions and to the project issue list for defects or enhancement requests. source
Test frameworks
Java fixtures use JUnit; the site also documents Concordion.NET integration with NUnit. source

Checked against the maker's pages on 5 Oct 2026.