[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.