Basics

What is CycloneDX? The SBOM standard, explained with examples

By SBOMBox SBOM experts · · 3 min read

Short answer: CycloneDX is an open standard for bills of materials, run by OWASP and standardised by Ecma International as ECMA-424. A CycloneDX SBOM is a JSON or XML file that lists every component in a piece of software with its version, package URL, hashes, licences and dependencies. Beyond software, the same format covers services, hardware, cryptography, ML models and VEX statements.

Where CycloneDX comes from

CycloneDX began in 2017 inside the OWASP community, built for security use cases such as feeding OWASP Dependency-Track. It is now an OWASP flagship project, and Ecma International published it as the standard ECMA-424 in 2024. The other main SBOM format, SPDX, is an ISO standard from the Linux Foundation; CycloneDX or SPDX? compares them.

What a CycloneDX document can describe

CycloneDX capabilities
CapabilityWhat it recordsAdded in
SBOMSoftware components, versions, purls, hashes, licences, dependency graph1.0 onwards
VEX and VDRWhether known vulnerabilities affect the product1.4
SaaSBOMServices, endpoints and data flows1.2 onwards
HBOMHardware devices and firmware1.x (device components)
ML-BOMMachine-learning models and datasets1.5
CBOMCryptographic assets: algorithms, keys, certificates1.6
AttestationsMachine-readable claims of conformance with standards1.6

That breadth is why CycloneDX is a common choice for security teams: one format for every type of bill of materials. SBOMBox reads CycloneDX 1.4 to 1.7 in JSON or XML.

A minimal CycloneDX SBOM

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.6",
  "serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
  "version": 1,
  "metadata": {
    "timestamp": "2026-11-17T09:00:00Z",
    "component": { "type": "application", "name": "example-api", "version": "1.4.0" }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/express@4.21.2",
      "name": "express",
      "version": "4.21.2",
      "purl": "pkg:npm/express@4.21.2",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [
    { "ref": "pkg:npm/express@4.21.2", "dependsOn": [] }
  ]
}

The key parts: bomFormat and specVersion identify the document; metadata says what the SBOM describes and when it was made; components lists each part; dependencies records the graph. A full file is annotated line by line in our SBOM example.

How to generate a CycloneDX SBOM

The CycloneDX project maintains a generator for most ecosystems, and general tools such as Syft, Trivy and cdxgen can also write CycloneDX.

CycloneDX generators by ecosystem
EcosystemCommandGuide
npmnpx @cyclonedx/cyclonedx-npm --output-file sbom.cdx.jsonJavaScript
Pythoncyclonedx-py environment --output-file sbom.cdx.jsonPython
Mavenmvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBomJava
Gocyclonedx-gomod mod -json -output sbom.cdx.jsonGo
Any repositorycdxgen -o sbom.cdx.json .Syft vs Trivy vs cdxgen

Or let SBOMBox pick the right generator for each project and score the result in one step:

sbombox generate

How to validate a CycloneDX file

cyclonedx validate --input-file sbom.cdx.json

Need SPDX for a customer? The SBOM converter turns CycloneDX into SPDX and back in your browser.

Frequently asked questions

What is CycloneDX used for?

Mainly for SBOMs: machine-readable inventories of software components used for vulnerability management, licence compliance and regulatory evidence. It also describes services, hardware, cryptography, ML models and VEX.

Is CycloneDX an official standard?

Yes. It is an OWASP flagship project and was published by Ecma International as ECMA-424.

What is the difference between CycloneDX and SPDX?

Both are open SBOM standards. CycloneDX comes from OWASP and is security-focused with wide coverage beyond software; SPDX comes from the Linux Foundation, is ISO/IEC 5962:2021 and grew out of licence compliance.

Does the Cyber Resilience Act accept CycloneDX?

The CRA requires a commonly used, machine-readable format and does not name one. CycloneDX meets that description, as does SPDX.

Which file extension does CycloneDX use?

Usually .cdx.json or .cdx.xml, or bom.json and bom.xml.