Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

Protect and Encrypt Word Documents

Edit on GitHub

Restrict editing of DOCX files to read-only, comments, tracked changes or forms, mark them final, and encrypt or open them with a password in .NET.

Packages
Works with
Target frameworks
netstandard2.0, net8.0, net10.0, net472
Limits
Editing restrictions ask Word to limit editing and are not a security boundary; use encryption when the content must stay private. OfficeIMO.Word support matrix
Verified
Examples compiled against the source on

Word has two kinds of protection, and they solve different problems. Editing restrictions ask Word to allow only reading, comments, tracked changes, or form filling; anyone with other tools can still read the content. Encryption scrambles the whole file with a password, so it cannot be opened without it. Apply either one last, after all content changes, and save to a new file.

Restrict editing

ProtectionType selects what Word allows: ReadOnly, Comments, TrackedChanges, or Forms. With a password, Word asks for it before the restriction can be turned off.

C#

using OfficeIMO.Word;

using WordDocument document = WordDocument.Create("policy.docx");
document.AddParagraph("Acceptable use policy").Style = WordParagraphStyles.Heading1;
document.AddParagraph("This policy applies to every employee.");

document.Settings.ProtectionType = WordDocumentProtectionType.ReadOnly;
document.Settings.ProtectionPassword = Environment.GetEnvironmentVariable("POLICY_EDIT_PASSWORD")
    ?? throw new InvalidOperationException("Set POLICY_EDIT_PASSWORD.");
document.Save();

PowerShell

Protect-OfficeDocument -Path .\policy.docx -Restriction ReadOnly -Password (Read-Host -AsSecureString) -OutputPath .\policy-locked.docx

Allow only tracked changes or comments

Reviewers can still edit, but every change is tracked, or they can only add comments.

C#

using OfficeIMO.Word;

using WordDocument document = WordDocument.Load("contract.docx");
document.Settings.ProtectionType = WordDocumentProtectionType.TrackedChanges;
document.Save("contract-for-review.docx");

PowerShell

Protect-OfficeDocument -Path .\contract.docx -Restriction TrackedChanges -OutputPath .\contract-for-review.docx
Protect-OfficeDocument -Path .\contract.docx -Restriction Comments -OutputPath .\contract-for-comments.docx

Mark a document as final or recommend read-only

These are hints, not restrictions: Word shows a banner or asks whether to open read-only, and the reader can choose to edit anyway.

C#

using OfficeIMO.Word;

using WordDocument document = WordDocument.Load("minutes.docx");
document.Settings.FinalDocument = true;
document.Settings.ReadOnlyRecommended = true;
document.Save("minutes-final.docx");

Encrypt a document with a password

WordSaveOptions.Password encrypts the saved file. Setting it to null explicitly removes encryption from a document that was loaded encrypted.

C#

using OfficeIMO.Word;

string password = Environment.GetEnvironmentVariable("PAYROLL_PASSWORD")
    ?? throw new InvalidOperationException("Set PAYROLL_PASSWORD.");

using WordDocument document = WordDocument.Create();
document.AddParagraph("Payroll summary");
document.Save("payroll.docx", new WordSaveOptions { Password = password });

PowerShell

Get-ChildItem .\Payroll -Filter *.docx | Protect-OfficeDocument -Encrypt -Password (Read-Host -AsSecureString)

Open an encrypted document

C#

using OfficeIMO.Word;

string password = Environment.GetEnvironmentVariable("PAYROLL_PASSWORD")
    ?? throw new InvalidOperationException("Set PAYROLL_PASSWORD.");

using WordDocument document = WordDocument.Load("payroll.docx", new WordLoadOptions { Password = password });
Console.WriteLine(document.Paragraphs[0].Text);

document.Save("payroll-open.docx", new WordSaveOptions { Password = null });

PowerShell

$password = Read-Host -AsSecureString
$document = Open-OfficeWord -Path .\payroll.docx -Password $password
Get-OfficeWordText -Document $document
Close-OfficeWord -Document $document

Unprotect-OfficeDocument -Path .\payroll.docx -Password $password -OutputPath .\payroll-open.docx

Example source