Skip to content
English
  • There are no suggestions because the search field is empty.

[Public] Can I Use Different Major Versions of IronPDF, IronOCR, and IronBarcode Together?

"Is it possible to use different major versions of IronPDF, IronOCR, and IronBarcode in the same project?"

For example:

  • IronPDF v2025.x

  • IronOCR v2024.x

  • IronBarcode v2023.x


Short Answer: Not Supported

No — using different major versions of IronSoftware products side-by-side in the same project is not supported.


 

Why Not?

All IronSoftware products are built on a shared internal architecture. That means:

  • Shared assemblies and dependencies are version-aligned across products.

  • Each product assumes compatibility only with others of the same major version.

  • Mixing versions can result in:

    • Assembly binding conflicts

    • Runtime errors

    • Unexpected behavior

Iron Software products are designed to function as a suite of libraries.

 

Best Practice:
Always use the same monthly version across all IronSoftware products in a project.

For example:

✔ IronPDF v2025.5.x
✔ IronOCR v2025.5.x
✔ IronBarcode v2025.5.x

 

If you're already using different versions and want to align them:

  • Upgrade all IronSoftware libraries to the same monthly version via NuGet.

  • Confirm changelog and API differences between versions before upgrading.