Concordion
concordion.org
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
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.
Plans
Every plan and priceOpen source
Open source
Getting started
- Open the Concordion website
- Choose the Java Markdown, Java HTML, or C# option
- Add the Java distribution through Gradle or Maven, or download the full ZIP
- Configure a JUnit fixture for Java or NUnit with Concordion.NET
- Connect the checks to application code or an interface library
- Run the specifications locally or through a documented build integration
- 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.