IronWord 2024.3.5

There is a newer version of this package available.
See the version list below for details.
dotnet add package IronWord --version 2024.3.5                
NuGet\Install-Package IronWord -Version 2024.3.5                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="IronWord" Version="2024.3.5" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IronWord --version 2024.3.5                
#r "nuget: IronWord, 2024.3.5"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install IronWord as a Cake Addin
#addin nuget:?package=IronWord&version=2024.3.5

// Install IronWord as a Cake Tool
#tool nuget:?package=IronWord&version=2024.3.5                

Nuget Installs Passed windows macOS linux docker aws microsoftazure livechat

IronWord - The C# Word Library

IronWord NuGet Trial Banner Image

IronWord is a library developed and maintained by Iron Software that helps C# Software Engineers to load, manipulate, and save Word document in .NET applications & websites.

IronWord excels at:

  • Loading, manipulating, and saving Word and DOCX documents.
  • PageSetup: Configuring paper size, page orientation, margins, and background color.
  • TextRun: Handling text content, styles, splitting, appending text, and adding images.
  • TextStyle: Managing font family, size, color, bold, italic, strikethrough, underline, superscript, and subscript.
  • Paragraph: Adding text runs, images, shapes, setting styles, alignments, bullets, and numbering lists.
  • Table: Manipulating table structure, including adding rows, getting and setting cell values, removing rows, merging cells, and more.
  • Image: Loading images from files or streams, setting wrap text, position offset, width, height, and other properties.
  • Shape: Setting wrap text, position offset, width, height, shape type, and rotation.

And much more! Visit our website to see all our code examples and a full list of our features

IronWord Has Cross Platform Support Compatibility With:

  • .NET 8, .NET 7, .NET 6 and .NET 5, Core 2x & 3x, Standard 2, and Framework 4.6.2+
  • Windows, macOS, Linux, Docker, Azure, and AWS

IronWord Cross Platform Compatibility Support Image

Our API reference and full licensing information can be found easily on our website.

Using IronWord

You can install the IronWord NuGet package by simply entering this command in your package manager console:

PM> Install-Package IronWord

Once installed, add using IronWord; to the top of your C# code. Here is a code example to get started with loading, editing, and saving a document:

using IronWord;
using IronWord.Models;
using IronSoftware.Drawing;

// Load an existing DOCX
var docx1 = new WordDocument("existing.docx");

// Or, make a new DOCX
var docx_new = new WordDocument();

// Add a paragraph with text
Paragraph paragraph = new();
var textRun = new TextRun()
{
    Text = "Hello IronWord!"
};
paragraph.AddTextRun(textRun);

docx1.AddParagraph(paragraph);

// Add a paragraph with an image
TextRun textRunWithImage = new TextRun();
Image image = new Image("example.jpg");
image.Width = 400; // px
image.Height = 300; // px
image.Position = new ElementPosition() {
    X = 0, // pts
    Y = 72  // pts
};
textRunWithImage.AddChild(image);
docx1.AddParagraph(new Paragraph(textRunWithImage));

// Save over the existing DOCX
docx1.Save("existing.docx");

// Or save as a new DOCX
docx1.SaveAs("output.docx");

Features Table

IronWord Features

Licensing & Support available

For our full list of code examples, tutorials, licensing information, and documentation visit: https://ironsoftware.com/csharp/word/

For support please email us at: support@ironsoftware.com

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2024.12.2 410 12/3/2024
2024.11.2 913 11/6/2024
2024.10.2 452 10/2/2024
2024.9.1 1,620 9/9/2024
2024.8.3 970 7/30/2024
2024.7.1 539 7/2/2024
2024.6.1 1,229 6/4/2024
2024.5.8 465 4/30/2024
2024.4.1 358 4/4/2024
2024.3.5 478 3/11/2024
2024.1.2 534 12/29/2023

- Updates PageSetup API
   - Adds new paper size enums (A5, Letter, Legal)
   - Adds ability to set custom paper size
   - Adds ability to set page orientation
   - Adds ability to add sections into word documents
   - Fixes bug where setting text color throws an exception
   - Fixes bug where table cells were not being merged together when MergeCells method was called
   - Adds ability to add text and images to a table cell directly, without having to add them to a paragraph
   - Adds ability to set the layout of tables
   - Updates IronSoftware.System.Drawing to 2024.3.4.