How to Create Different PDF Versions in C#
IronPDF automatically manages PDF version selection based on document features, choosing versions from 1.4 to 1.7 to ensure compatibility while preserving functionality. This seamless process handles everything from simple HTML conversions (typically PDF 1.4) to complex document merging (PDF 1.7 standard). When working with PDF from HTML String conversions, IronPDF intelligently determines the appropriate version based on your content’s requirements.
Quickstart: Create Different PDF Versions in C#
- Download IronPDF from NuGet
- Instantiate
ChromePdfRenderer - Use
RenderHtmlAsPdfmethod to render HTML - Save and export the PDF document
- Verify the PDF version
```cs :title=Quickstart Example // Create a simple PDF using IronPDF - automatically selects version 1.4 using IronPdf;
var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf(""); pdf.SaveAs("hello-world.pdf");
<br class="clear">
## How Do I Create a PDF Version 1.4 Document?
<!-- TODO: Add image here -->
<!--  -->
<!-- Description: Diagram or screenshot illustrating the code concept -->
IronPDF supports all PDF versions from 1.2 to 1.7. When converting HTML to PDF, IronPDF automatically selects the lowest version offered by the Chromium engine, ranging from PDF 1.4 to PDF 1.6, to maximize compatibility. This behavior matches what you’ll find when [exporting different PDF versions](https://ironpdf.com/how-to/pdf-versions/) in various applications.
Most conversions result in PDF 1.4. PDF 1.4 features transparency support, enabling modern graphic designs while maintaining broad compatibility. In this example, we’ll convert an HTML string to PDF using IronPDF to demonstrate this behavior. This approach works seamlessly whether you’re creating PDFs from [HTML files](https://ironpdf.com/how-to/html-file-to-pdf/), [URLs](https://ironpdf.com/how-to/url-to-pdf/), or [ASPX pages](https://ironpdf.com/how-to/aspx-to-pdf/).
### What Code Do I Need to Generate PDF 1.4?
```cs
:path=/static-assets/pdf/content-code-examples/how-to/pdf-version-standard.csIronPDF’s intelligent version selection shines here. For basic HTML content without advanced features, it defaults to PDF 1.4, ensuring your documents work across the widest range of PDF viewers and applications. This automatic selection eliminates manual version configuration in most scenarios.
What Does the PDF 1.4 Output Look Like?

As shown, IronPDF chose the lowest version from its range (PDF 1.4) to ensure compatibility. This version supports essential features like font embedding, encryption, and basic forms while maintaining excellent compatibility with older PDF readers.
How Do I Create a PDF Version 1.7 Document?
IronPDF automatically generates PDF 1.7 (the international standard) when merging documents to ensure maximum compatibility. Since source PDFs may use different versions and features, defaulting to the comprehensive 1.7 standard ensures all original elements are preserved without data loss. This is crucial when merging or splitting PDFs from various sources.
PDF version 1.7 became the ISO standard (ISO 32000-1:2008) and includes advanced features:
- Enhanced security and encryption options
- 3D content support
- Advanced transparency blending modes
- Improved accessibility features
- Better Unicode support for international languages
What Code Do I Need for Merging PDFs to Version 1.7?
:path=/static-assets/pdf/content-code-examples/how-to/merge-or-split-pdfs-merge.csusing IronPdf;
// Two paged PDF
const string html_a =
@"<p> [PDF_A] </p>
<p> [PDF_A] 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> [PDF_A] 2nd Page</p>";
// Two paged PDF
const string html_b =
@"<p> [PDF_B] </p>
<p> [PDF_B] 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> [PDF_B] 2nd Page</p>";
var renderer = new ChromePdfRenderer();
var pdfdoc_a = renderer.RenderHtmlAsPdf(html_a);
var pdfdoc_b = renderer.RenderHtmlAsPdf(html_b);
// Four paged PDF
var merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b);
merged.SaveAs("Merged.pdf");Imports IronPdf
' Two paged PDF
Private Const html_a As String = "<p> [PDF_A] </p>
<p> [PDF_A] 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> [PDF_A] 2nd Page</p>"
' Two paged PDF
Private Const html_b As String = "<p> [PDF_B] </p>
<p> [PDF_B] 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> [PDF_B] 2nd Page</p>"
Private renderer = New ChromePdfRenderer()
Private pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
Private pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)
' Four paged PDF
Private merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b)
merged.SaveAs("Merged.pdf")This merging functionality is essential when combining documents from different sources or when you need to add, copy, or delete PDF pages. The resulting PDF 1.7 document ensures all features from both source documents are preserved.
Why Does IronPDF Use Version 1.7 for Merged Documents?

IronPDF generated a 1.7 version PDF by merging the two PDFs. This ensures:
- Universal Compatibility:
PDF 1.7is supported by all modern PDF readers and browsers - Feature Preservation: All advanced features from source documents are maintained
- Future-Proofing: As the ISO standard,
PDF 1.7ensures long-term document accessibility - Enhanced Security: Support for advanced PDF permissions and passwords
Advanced PDF Version Considerations
When working with PDF versions in IronPDF, several factors influence automatic version selection:
Content Complexity
Simple HTML with basic text and images typically results in PDF 1.4, while documents containing JavaScript, forms, or multimedia content may trigger higher versions. When executing custom JavaScript in your PDFs, IronPDF may select a higher version to support these interactive features.
Feature Requirements
Certain features require specific PDF versions:
- PDF 1.4: Basic transparency, font embedding
- PDF 1.5: Layers, object streams
- PDF 1.6: OpenType fonts, 3D annotations
- PDF 1.7: Enhanced security, package/portfolio features
Compliance and Standards
For archival purposes, you might need specific versions. IronPDF supports creating PDF/A format documents for long-term preservation, which have their own version requirements based on the PDF/A level chosen.
Performance Optimization
Different PDF versions have varying file sizes and processing requirements. PDF 1.4 documents are generally smaller and process faster, making them ideal for high-volume applications. Learn more about PDF compression techniques to optimize your documents.
By understanding these version differences and letting IronPDF handle selection automatically, you ensure your PDFs maintain the perfect balance between compatibility, features, and performance for your specific use case.
Frequently Asked Questions
What PDF versions does IronPDF support?
IronPDF supports all PDF versions from 1.2 to 1.7. When converting HTML to PDF, IronPDF automatically selects the appropriate version based on your document's features, typically choosing between PDF 1.4 to PDF 1.7 to ensure optimal compatibility.
How does IronPDF determine which PDF version to use?
IronPDF intelligently manages PDF version selection automatically based on document features. For simple HTML conversions, it typically selects PDF 1.4 for maximum compatibility. For complex operations like document merging, IronPDF uses PDF 1.7 to preserve all features.
Can I manually specify the PDF version when creating documents?
IronPDF handles version selection automatically, eliminating the need for manual configuration in most scenarios. The library intelligently chooses the lowest version offered by the Chromium engine (ranging from PDF 1.4 to PDF 1.6) that supports all your document's features.
What PDF version is created when converting basic HTML to PDF?
When converting basic HTML content without advanced features, IronPDF defaults to PDF 1.4. This version supports essential features like transparency, font embedding, encryption, and basic forms while maintaining excellent compatibility with older PDF readers.
Why does IronPDF use PDF 1.7 for document merging?
IronPDF automatically generates PDF 1.7 when merging documents to ensure maximum compatibility and preserve all features from the source PDFs, which may use different versions. PDF 1.7 is the international standard that supports the widest range of PDF features.
What features does PDF version 1.4 support?
PDF 1.4, commonly generated by IronPDF for HTML conversions, features transparency support enabling modern graphic designs, font embedding, encryption capabilities, and basic form functionality. This version offers a perfect balance between features and compatibility.






