<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Jollen Moyani</title>
    <description>The latest articles on DEV Community by Jollen Moyani (@jollenmoyani).</description>
    <link>https://dev.to/jollenmoyani</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F972927%2F876a12f1-3771-485a-87be-b132e7ebd4bf.png</url>
      <title>DEV Community: Jollen Moyani</title>
      <link>https://dev.to/jollenmoyani</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/jollenmoyani"/>
    <language>en</language>
    <item>
      <title>How to Automate Digital Signatures in Word Documents Using C#</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Fri, 13 Nov 2026 15:30:00 +0000</pubDate>
      <link>https://dev.to/syncfusion/how-to-automate-digital-signatures-in-word-documents-using-c-583h</link>
      <guid>https://dev.to/syncfusion/how-to-automate-digital-signatures-in-word-documents-using-c-583h</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Still signing Word documents manually? With the Syncfusion .NET Word Library, you can automate the entire signing process using C#. Learn how to add invisible digital signatures, create visible signature lines, validate signed documents, and manage document revisions without Microsoft Word or Office Interop.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Have you automated Word document generation but still need someone to sign each document manually? This extra step can slow down approvals, create multiple document versions, and make it harder to track signed files.&lt;/p&gt;

&lt;p&gt;What if you could handle the entire process directly in your application?&lt;/p&gt;

&lt;p&gt;The Syncfusion® &lt;a href="https://www.syncfusion.com/document-sdk/net-word-library" rel="noopener noreferrer"&gt;.NET Word Library&lt;/a&gt; introduces &lt;a href="https://www.syncfusion.com/document-sdk/net-word-library/digital-signature-in-word-document" rel="noopener noreferrer"&gt;digital signature&lt;/a&gt; support in Essential Studio &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt;. You can now sign, validate, and manage digital signatures in Word documents using C#, without depending on Microsoft Word or Office Interop.&lt;/p&gt;

&lt;p&gt;With digital signatures built into your document process, you can handle document generation, signing, validation, and delivery in one automated process.&lt;/p&gt;

&lt;p&gt;In this blog, you’ll learn how to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Add invisible digital signatures to Word documents.&lt;/li&gt;
&lt;li&gt;Create and sign visible signature lines.&lt;/li&gt;
&lt;li&gt;Validate signed DOCX files.&lt;/li&gt;
&lt;li&gt;Remove signatures before making document changes.&lt;/li&gt;
&lt;li&gt;Apply supported XML digital signature standards.&lt;/li&gt;
&lt;li&gt;Manage multiple signature lines in a document.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Why automate digital signatures in Word documents?
&lt;/h2&gt;

&lt;p&gt;Signing a few documents manually may not be a problem. But what happens when your application generates hundreds of offer letters, contracts, or approval documents every day? Managing all those signatures manually can quickly become difficult.&lt;/p&gt;

&lt;p&gt;Automating digital signatures helps applications:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Reduce manual approval steps.&lt;/li&gt;
&lt;li&gt;Avoid unnecessary document copies.&lt;/li&gt;
&lt;li&gt;Maintain document integrity.&lt;/li&gt;
&lt;li&gt;Validate signatures before sharing documents.&lt;/li&gt;
&lt;li&gt;Improve document tracking and auditability.&lt;/li&gt;
&lt;li&gt;Simplify approval processes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Consider an HR application that automatically generates offer letters. Without automation, HR teams need to download each document, sign it, upload the signed copy, and keep track of different versions.&lt;/p&gt;

&lt;p&gt;With digital signature automation, the application can sign documents, validate them, and store the approved versions directly within the approval process.&lt;/p&gt;

&lt;p&gt;Here’s how the manual and automated approaches compare:&lt;/p&gt;


&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;&lt;tr&gt;
&lt;th&gt;Scenario&lt;/th&gt;
&lt;th&gt;Manual process&lt;/th&gt;
&lt;th&gt;Automated digital signature process&lt;/th&gt;
&lt;/tr&gt;&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Document signing&lt;/td&gt;
&lt;td&gt;Open and sign documents manually in Word.&lt;/td&gt;
&lt;td&gt;Sign DOCX files automatically using code.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Multi-party approvals&lt;/td&gt;
&lt;td&gt;Exchange files between reviewers.&lt;/td&gt;
&lt;td&gt;Add separate signature lines for different signers.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Validation&lt;/td&gt;
&lt;td&gt;Verify signatures manually.&lt;/td&gt;
&lt;td&gt;Validate signatures automatically before delivery.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Document updates&lt;/td&gt;
&lt;td&gt;Track multiple document versions.&lt;/td&gt;
&lt;td&gt;Remove signatures, update documents, and sign them again.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Server-side processing&lt;/td&gt;
&lt;td&gt;Requires manual interaction.&lt;/td&gt;
&lt;td&gt;Runs in web applications, cloud services, and background processes.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;h2&gt;
  
  
  How to automate digital signatures in Word documents using C
&lt;/h2&gt;

&lt;p&gt;Let’s see how to add &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/working-with-digital-signature" rel="noopener noreferrer"&gt;digital signatures&lt;/a&gt; to Word documents using the Syncfusion &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/getting-started" rel="noopener noreferrer"&gt;.NET Word Library (DocIO)&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;We’ll walk through loading a document and signing certificate, creating invisible and visible signatures, validating signed documents, and managing document revisions.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; &lt;em&gt;The examples in this blog focus on DOCX documents. Digital signature support in DocIO is currently available for DOCX files, not legacy DOC formats.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3&gt;
  
  
  Step 1: Install the required NuGet package
&lt;/h3&gt;

&lt;p&gt;First, install the &lt;a href="https://www.nuget.org/packages/Syncfusion.DocIO.Net.Core" rel="noopener noreferrer"&gt;Syncfusion.DocIO.Net.Core&lt;/a&gt; NuGet package in your .NET application.&lt;/p&gt;

&lt;p&gt;Run the following command in the &lt;strong&gt;Package Manager Console&lt;/strong&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="nc"&gt;Install&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="nc"&gt;Package&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DocIO&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Net&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Core&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Next, import the required namespaces:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DocIO&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DocIO&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;DLS&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Office&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;System&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;System&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;IO&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;These namespaces provide the classes required to load Word documents, configure digital signatures, work with certificates, and save signed files.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 2: Load the document and signing certificate
&lt;/h3&gt;

&lt;p&gt;Before adding a digital signature, you need two things:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The Word document you want to sign.&lt;/li&gt;
&lt;li&gt;A digital certificate containing the signer’s private key.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The certificate is typically provided as a password-protected &lt;strong&gt;.pfx&lt;/strong&gt; or &lt;strong&gt;.p12&lt;/strong&gt; file.&lt;/p&gt;

&lt;p&gt;You can load the DOCX document using the &lt;strong&gt;WordDocument&lt;/strong&gt; class and the signing certificate using &lt;strong&gt;OfficeDigitalSignatureCertificate&lt;/strong&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt; &lt;span class="n"&gt;document&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="s2"&gt;"input.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nc"&gt;OfficeDigitalSignatureCertificate&lt;/span&gt; &lt;span class="n"&gt;certificate&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
    &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;OfficeDigitalSignatureCertificate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="s2"&gt;"PrivateKey.pfx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"certificate-password"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Production tip:&lt;/strong&gt; Avoid hardcoding certificate passwords in your application. Store certificates and secrets securely using solutions such as Azure Key Vault, enterprise secret management systems, or secure certificate stores.&lt;/p&gt;

&lt;p&gt;Also, make sure the certificate is valid, contains the required private key, and has not expired.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 3: Add an invisible digital signature to a Word document
&lt;/h3&gt;

&lt;p&gt;Not every document needs a visible signature block. Sometimes, you simply want to confirm who signed the document and whether its content has changed since signing.&lt;/p&gt;

&lt;p&gt;That’s where &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/working-with-digital-signature#add-digital-signature-invisible-signature" rel="noopener noreferrer"&gt;invisible digital signatures&lt;/a&gt; help. They protect the document without adding a visible signature area to the page.&lt;/p&gt;

&lt;p&gt;With DocIO, you can use the &lt;strong&gt;AddDigitalSignature()&lt;/strong&gt; method to sign a Word document using the loaded certificate.&lt;/p&gt;

&lt;p&gt;You can configure the &lt;strong&gt;SignatureSettings&lt;/strong&gt; class to specify details&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nc"&gt;SignatureSettings&lt;/span&gt; &lt;span class="n"&gt;settings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;SignatureSettings&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;SignTime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Now&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;Comments&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Approved"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddDigitalSignature&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;certificate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;settings&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Save&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"DigitallySigned.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here, &lt;strong&gt;SignTime&lt;/strong&gt; specifies the signing time, while &lt;strong&gt;Comments&lt;/strong&gt; stores additional information associated with the signature.&lt;/p&gt;

&lt;p&gt;Once the signature is added, save the document in DOCX format.&lt;/p&gt;

&lt;p&gt;The resulting document contains an invisible digital signature that can be validated later.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Important:&lt;/strong&gt; &lt;em&gt;Avoid modifying a signed document. Changes to its content can invalidate the existing digital signature.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3nyw6gs81x7va15zyhue.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F3nyw6gs81x7va15zyhue.png" alt="Adding an invisible digital signature to a Word document" width="800" height="415"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Adding an invisible digital signature to a Word document&lt;/em&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  Step 4: Add a visible digital signature to a Word document
&lt;/h3&gt;

&lt;p&gt;Some business documents need a visible approval area so readers can easily identify where a document was signed.&lt;/p&gt;

&lt;p&gt;You may see these signature lines in:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Contracts and legal agreements.&lt;/li&gt;
&lt;li&gt;Employees offer letters.&lt;/li&gt;
&lt;li&gt;Procurement approvals.&lt;/li&gt;
&lt;li&gt;Financial authorization documents.&lt;/li&gt;
&lt;li&gt;Business agreements.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;DocIO allows you to create a &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/working-with-digital-signature#sign-signature-line-visible-signature" rel="noopener noreferrer"&gt;signature line&lt;/a&gt; with signer details and a unique identifier. You can then use this identifier when applying the digital signature through &lt;a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.Office.SignatureSettings.html" rel="noopener noreferrer"&gt;SignatureSettings&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;First, create a signature line in the Word document and retrieve its unique ID. The &lt;strong&gt;signatureLineId&lt;/strong&gt; in the following example represents that ID.&lt;/p&gt;

&lt;p&gt;You can also provide a signature image to give the signature line a familiar handwritten-signature appearance.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="kt"&gt;byte&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="nc"&gt;SignatureLineImage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;File&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ReadAllBytes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"signature.png"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nc"&gt;SignatureSettings&lt;/span&gt; &lt;span class="n"&gt;visibleSettings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;SignatureSettings&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;SignatureLineId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;signatureLineId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;SignatureLineImage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;SignatureLineImage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;SignTime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Now&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;Comments&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Reviewed and approved"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddDigitalSignature&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;certificate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;visibleSettings&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Save&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="s2"&gt;"VisibleDigitalSignature.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;SignatureLineId&lt;/strong&gt; identifies the signature line to be signed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SignatureLineImage&lt;/strong&gt; specifies the image displayed in the signature area.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SignTime&lt;/strong&gt; records the signing time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Comments&lt;/strong&gt; adds information associated with the signature.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The &lt;strong&gt;signatureLineId&lt;/strong&gt; must match the unique ID of a signature line already created in the document.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A quick clarification:&lt;/strong&gt; The signature image provides the visual appearance of a handwritten signature. The certificate-based digital signature provides cryptographic verification and document integrity protection. Adding an image alone does not create a digital signature.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqrfn5n6bcovdg1zxzql0.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqrfn5n6bcovdg1zxzql0.png" alt="Adding a visible digital signature to a Word document" width="800" height="589"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Adding a visible digital signature to a Word document&lt;/em&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  Step 5: Validate digital signatures before sharing documents
&lt;/h3&gt;

&lt;p&gt;Adding a digital signature is only one part of the process. You should also check whether the signature is still valid before sharing, distributing, or archiving the document.&lt;/p&gt;

&lt;p&gt;For example, an enterprise document management system can validate a signed DOCX file before moving it into permanent storage.&lt;/p&gt;

&lt;p&gt;DocIO provides the &lt;strong&gt;DigitalSignatures&lt;/strong&gt; collection to access the signatures in a Word document.&lt;/p&gt;

&lt;p&gt;You can check whether a document contains signatures and whether those signatures are valid using the following properties:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;DigitalSignatures.Count:&lt;/strong&gt; Gets the number of signatures in the document.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;DigitalSignatures.IsValid:&lt;/strong&gt; Checks whether all signatures in the collection are valid.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;signature.IsValid:&lt;/strong&gt; Checks an individual signature.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;You can also retrieve details such as signing time and signature comments.&lt;/p&gt;

&lt;p&gt;Here’s how to check the signatures in a document:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt; &lt;span class="n"&gt;signedDocument&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="s2"&gt;"DigitallySigned.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kt"&gt;bool&lt;/span&gt; &lt;span class="n"&gt;hasSignatures&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;signedDocument&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DigitalSignatures&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Count&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kt"&gt;bool&lt;/span&gt; &lt;span class="n"&gt;allSignaturesValid&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
    &lt;span class="n"&gt;signedDocument&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DigitalSignatures&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;IsValid&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;foreach&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;signature&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;signedDocument&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DigitalSignatures&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kt"&gt;bool&lt;/span&gt; &lt;span class="n"&gt;isValid&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;IsValid&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="n"&gt;comments&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Comments&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nc"&gt;DateTime&lt;/span&gt; &lt;span class="n"&gt;signingTime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;signature&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;SigningTime&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This example checks whether the document contains signatures and whether they are valid. It also retrieves the validation status, comments, and signing time of each signature.&lt;/p&gt;

&lt;p&gt;For example, before sending an approved contract to a customer, your application can validate its signatures and proceed based on the validation result.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F14s5j0o52xvxysjo5b2u.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F14s5j0o52xvxysjo5b2u.png" alt="Validating a digital signature in a Word document" width="799" height="477"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Validating a digital signature in a Word document&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Try the &lt;a href="https://document.syncfusion.com/demos/word/digitalsignaturevalidation#/tailwind3" rel="noopener noreferrer"&gt;validation demo&lt;/a&gt; to verify signed documents and explore additional validation scenarios.&lt;/p&gt;
&lt;h3&gt;
  
  
  Step 6: Choose the right digital signature standard
&lt;/h3&gt;

&lt;p&gt;Different applications may have different digital signature requirements. Some may need standard XML digital signatures, while others may require additional signature policy information.&lt;/p&gt;

&lt;p&gt;DocIO allows you to specify the required signature standard using the &lt;a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.Office.XmlDsigLevel.html" rel="noopener noreferrer"&gt;XmlDsigLevel&lt;/a&gt; property in &lt;strong&gt;SignatureSettings&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;It supports the following standards:&lt;/p&gt;
&lt;h4&gt;
  
  
  XmlDSig
&lt;/h4&gt;

&lt;p&gt;XML Digital Signature (XMLDSig) is the standard W3C format for digitally signing XML content. It is suitable for standard document-signing scenarios.&lt;/p&gt;
&lt;h4&gt;
  
  
  XAdES-EPES
&lt;/h4&gt;

&lt;p&gt;XAdES-EPES extends XML digital signatures with explicit signature policy information. This allows applications to associate a signature with a defined signing policy.&lt;/p&gt;
&lt;h4&gt;
  
  
  Things to consider when choosing a standard:
&lt;/h4&gt;

&lt;ul&gt;
&lt;li&gt;Check your organization’s digital signature requirements.&lt;/li&gt;
&lt;li&gt;Select a standard that aligns with the applicable signing policy.&lt;/li&gt;
&lt;li&gt;Make sure the systems that receive and validate your documents support the selected standard.&lt;/li&gt;
&lt;li&gt;Verify any additional compliance requirements separately.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;You can configure the required standard using the &lt;strong&gt;XmlDsigLevel&lt;/strong&gt; enumeration. Here’s an example of configuring both standards:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nc"&gt;SignatureSettings&lt;/span&gt; &lt;span class="n"&gt;xmlSettings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;SignatureSettings&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;XmlDsigLevel&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;XmlDsigLevel&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;XmlDSig&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;SignTime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Now&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddDigitalSignature&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;certificate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;xmlSettings&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nc"&gt;SignatureSettings&lt;/span&gt; &lt;span class="n"&gt;xadesSettings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;SignatureSettings&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;XmlDsigLevel&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;XmlDsigLevel&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;XAdEsEpes&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;SignTime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Now&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddDigitalSignature&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;certificate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;xadesSettings&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Choose the appropriate standard based on your application’s requirements. Selecting a signature standard alone does not guarantee regulatory compliance; your complete signing process must meet the applicable certificate and policy requirements.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 7: Remove digital signatures before updating a document
&lt;/h3&gt;

&lt;p&gt;Need to update a document after it has been signed? You should remove the existing signatures before making changes. Otherwise, the signatures may no longer be valid.&lt;/p&gt;

&lt;p&gt;Consider a contract amendment. Once a contract has been signed, the business may need to update a clause or change an agreement date. The previous signature no longer represents the updated document.&lt;/p&gt;

&lt;p&gt;With DocIO, you can use the &lt;strong&gt;RemoveAllDigitalSignatures()&lt;/strong&gt; method to remove all digital signatures from a document.&lt;/p&gt;

&lt;p&gt;Here’s how to do it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt; &lt;span class="n"&gt;signedDocument&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;WordDocument&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="s2"&gt;"DigitallySigned.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;signedDocument&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;RemoveAllDigitalSignatures&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;signedDocument&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Save&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="s2"&gt;"UnsignedForRevision.docx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;FormatType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Docx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A good approach is to follow these steps:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Preserve the original signed document.&lt;/li&gt;
&lt;li&gt;Create a separate working copy.&lt;/li&gt;
&lt;li&gt;Remove signatures from the working copy.&lt;/li&gt;
&lt;li&gt;Make the required document changes.&lt;/li&gt;
&lt;li&gt;Apply new digital signatures after the changes are complete.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Keeping separate signed and unsigned copies helps maintain a clear document history and makes it easier to track revisions.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flgzpnwe8qbpaedcfgbfr.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flgzpnwe8qbpaedcfgbfr.png" alt="Removing a digital signature from a Word document" width="800" height="547"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Removing a digital signature from a Word document&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Learn more about &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/working-with-digital-signature#remove-digital-signature" rel="noopener noreferrer"&gt;removing signatures&lt;/a&gt; before revising document content.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 8: Manage multiple signature lines in a document
&lt;/h3&gt;

&lt;p&gt;What if a document needs approval from more than one person?&lt;/p&gt;

&lt;p&gt;For example, a procurement agreement may need signatures from a department manager, finance manager, and authorized approver.&lt;/p&gt;

&lt;p&gt;DocIO allows you to insert multiple signature lines into a Word document and sign each line individually.&lt;/p&gt;

&lt;p&gt;You can create separate signature lines using the &lt;strong&gt;AppendSignatureLine()&lt;/strong&gt; method. Each line has its own unique identifier, which you can retrieve and associate with the corresponding signer.&lt;/p&gt;

&lt;p&gt;When signing, pass the appropriate identifier through the &lt;strong&gt;SignatureSettings.SignatureLineId&lt;/strong&gt; property.&lt;/p&gt;

&lt;p&gt;You can then apply the digital signature to each signature line and save the signed document.&lt;/p&gt;

&lt;p&gt;This is useful for applications that need multiple approval sections in the same document.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; &lt;em&gt;DocIO provides the document-level signature capabilities. Your application is responsible for managing the approval process, such as assigning signers, sending notifications, controlling signing order, and tracking approval status.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Common scenarios for digital signature automation
&lt;/h2&gt;

&lt;p&gt;Digital signature automation can be useful in several types of applications.&lt;/p&gt;

&lt;p&gt;Here are a few examples:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;HR applications:&lt;/strong&gt; Automatically sign employees offer letters, appointment letters, and other employment documents.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Contract management systems:&lt;/strong&gt; Sign agreements and validate them before sharing with customers or partners.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Procurement applications:&lt;/strong&gt; Manage purchase agreements and approval documents.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Financial applications:&lt;/strong&gt; Sign financial reports and authorization documents.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Document management systems:&lt;/strong&gt; Validate signed documents before storing or archiving them.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In each scenario, automating digital signatures helps reduce manual work while keeping document signing and validation within the application.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: What is the difference between an invisible digital signature and a visible signature line?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;An invisible digital signature protects a document without displaying a signature area on the page.&lt;/p&gt;

&lt;p&gt;A visible signature line provides a designated area for signing. It can display signer information and an optional signature image. The signature line must also be digitally signed using a certificate to provide cryptographic verification.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Can multiple people sign the same DOCX document?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. DocIO supports multiple signature lines in a Word document. Each signature line has its own unique identifier and can be signed individually.&lt;/p&gt;

&lt;p&gt;However, managing the approval sequence and signer interactions must be handled by your application.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: When should digital signatures be removed?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Remove existing signatures whenever you need to modify the signed document. After making the required changes, apply new digital signatures to the updated document.&lt;/p&gt;

&lt;p&gt;It’s good practice to preserve the original signed copy for document history and audit purposes.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Which Word document formats support digital signatures in DocIO?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;DocIO currently supports digital signatures in DOCX format. Legacy DOC documents are not supported for this feature.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q6: Which digital signature standards are supported in the .NET Word Library?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;DocIO supports &lt;strong&gt;XMLDSig&lt;/strong&gt; and &lt;strong&gt;XAdES-EPES&lt;/strong&gt; through the &lt;strong&gt;SignatureSettings.XmlDsigLevel&lt;/strong&gt; property. You can select the appropriate standard based on your application’s signing requirements.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q7: Can I use a signature image without a digital certificate?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;A signature image provides a visual representation of a handwritten signature. However, an image alone does not provide cryptographic verification or protect the document from undetected changes.&lt;/p&gt;

&lt;p&gt;To create a digital signature, you need a valid signing certificate containing a private key.&lt;/p&gt;

&lt;h2&gt;
  
  
  Keep document signing within your application
&lt;/h2&gt;

&lt;p&gt;Why handle document signing manually when you can automate it directly in your .NET application?&lt;/p&gt;

&lt;p&gt;With the Syncfusion &lt;a href="https://www.syncfusion.com/document-sdk/net-word-library" rel="noopener noreferrer"&gt;.NET Word Library&lt;/a&gt;, you can add invisible digital signatures, create visible signature lines, validate signed documents, and manage document revisions using C#.&lt;/p&gt;

&lt;p&gt;Whether you’re building an HR application, contract management system, or enterprise document process, these capabilities help reduce manual steps while maintaining document integrity and auditability.&lt;/p&gt;

&lt;p&gt;Ready to try it in your application? Explore the &lt;a href="https://help.syncfusion.com/document-processing/word/word-library/net/working-with-digital-signature" rel="noopener noreferrer"&gt;digital signature documentation&lt;/a&gt; and download the &lt;a href="https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Digital-Signature" rel="noopener noreferrer"&gt;GitHub samples&lt;/a&gt; to see the complete implementation.&lt;/p&gt;

&lt;p&gt;This feature is available in the Essential Studio &lt;a href="https://www.syncfusion.com/forums/198591/essential-studio-2026-volume-3-main-release-v35-1-37-is-available-for-download" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt; release. You can also explore the &lt;a href="https://www.syncfusion.com/products/release-history" rel="noopener noreferrer"&gt;Release Notes&lt;/a&gt; and &lt;a href="https://www.syncfusion.com/products/whatsnew" rel="noopener noreferrer"&gt;What’s New pages&lt;/a&gt; for additional updates.&lt;/p&gt;

&lt;p&gt;Existing customers can access the latest version through the &lt;a href="https://www.syncfusion.com/sales/pricing?category=ui-components" rel="noopener noreferrer"&gt;License and Downloads&lt;/a&gt; page. New users can start a &lt;a href="https://www.syncfusion.com/downloads" rel="noopener noreferrer"&gt;30-day free trial&lt;/a&gt; and explore the capabilities of the Syncfusion .NET Word Library.&lt;/p&gt;

&lt;p&gt;If you have questions or feedback, reach out through our &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;. We’re happy to help!&lt;/p&gt;

</description>
      <category>word</category>
      <category>networdlibrary</category>
      <category>documentprocessing</category>
      <category>whatsnew</category>
    </item>
    <item>
      <title>Introducing BoldDocServer: An Office Online Server Alternative for SharePoint Server</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Thu, 12 Nov 2026 17:19:07 +0000</pubDate>
      <link>https://dev.to/syncfusion/introducing-bolddocserver-an-office-online-server-alternative-for-sharepoint-server-1ihc</link>
      <guid>https://dev.to/syncfusion/introducing-bolddocserver-an-office-online-server-alternative-for-sharepoint-server-1ihc</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt;  &lt;em&gt;**Syncfusion introduces BoldDocServer&lt;/em&gt;&lt;em&gt;, a new solution for browser-based Word, Excel, and PDF experiences in SharePoint Server. With Office Online Server support ending on **December 31, 2026&lt;/em&gt;&lt;em&gt;, BoldDocServer gives organizations a new option to continue supported document viewing, editing, review, and collaboration while keeping SharePoint as the document repository.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Why BoldDocServer, and why now?
&lt;/h2&gt;

&lt;p&gt;December 31, 2026, is becoming an important date for organizations running Office Online Server with SharePoint Server.&lt;/p&gt;

&lt;p&gt;Microsoft support for Office Online Server ends on that date. For teams that depend on browser-based document viewing and editing, the approaching deadline raises a practical question:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What happens to those SharePoint document processes next?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Some organizations may choose to change their broader Microsoft architecture. Others may want to continue operating SharePoint Server and replace the browser-based document layer that Office Online Server provided.&lt;/p&gt;

&lt;p&gt;That second scenario is where &lt;a href="https://www.bolddocserver.com/" rel="noopener noreferrer"&gt;BoldDocServer&lt;/a&gt; fits.&lt;/p&gt;

&lt;p&gt;Syncfusion® is introducing BoldDocServer to bring browser-based Word, Excel, and PDF experiences to SharePoint Server through WOPI. Users can work with supported documents from the browser, while SharePoint remains responsible for document storage, permissions, and repository operations.&lt;/p&gt;

&lt;p&gt;Let’s look at what BoldDocServer provides, how it works with SharePoint, and what organizations evaluating their post-Office Online Server strategy should know.&lt;/p&gt;

&lt;h2&gt;
  
  
  Office Online Server support ends December 31, 2026
&lt;/h2&gt;

&lt;p&gt;Office Online Server has long provided browser-based viewing and editing experiences for Microsoft Office documents in supported server environments.&lt;/p&gt;

&lt;p&gt;According to &lt;a href="https://learn.microsoft.com/en-us/lifecycle/products/office-online-server" rel="noopener noreferrer"&gt;Microsoft’s product lifecycle&lt;/a&gt;, Office Online Server reaches the end of support on &lt;strong&gt;December 31, 2026&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;That does not mean every existing deployment suddenly stops functioning on January 1, 2027. It does mean organizations relying on Office Online Server need a plan for operating beyond its supported lifecycle.&lt;/p&gt;

&lt;p&gt;For organizations using SharePoint Server, now is the time to consider questions such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Do we intend to continue running SharePoint Server?&lt;/li&gt;
&lt;li&gt;Which browser-based document experiences do our users depend on?&lt;/li&gt;
&lt;li&gt;Do we need Word and Excel editing directly from SharePoint?&lt;/li&gt;
&lt;li&gt;Do users also need PDF viewing and review scenarios?&lt;/li&gt;
&lt;li&gt;Which document permissions and repository processes must remain in SharePoint?&lt;/li&gt;
&lt;li&gt;What replacement or migration path should we validate before the deadline?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Planning early gives teams time to test document behavior, permissions, save-back processes, collaboration, and deployment requirements before Office Online Server reaches retirement.&lt;/p&gt;

&lt;h2&gt;
  
  
  What are the options for SharePoint Server teams?
&lt;/h2&gt;

&lt;p&gt;There is no single path that fits every organization. Teams evaluating Office Online Server retirement may broadly consider the following approaches:&lt;/p&gt;


&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;colgroup&gt;
&lt;col&gt;
&lt;col&gt;
&lt;/colgroup&gt;
&lt;thead&gt;&lt;tr&gt;
&lt;th&gt;Approach&lt;/th&gt;
&lt;th&gt;What it means&lt;/th&gt;
&lt;/tr&gt;&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Keep SharePoint Server and replace the browser document layer&lt;/td&gt;
&lt;td&gt;Continue using SharePoint as the document repository while introducing another solution for supported browser-based viewing and editing.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Move document workloads to Microsoft’s cloud services&lt;/td&gt;
&lt;td&gt;Reevaluate the broader SharePoint and Microsoft 365 architecture and move applicable workloads to supported cloud services.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Continue with the existing environment after support ends&lt;/td&gt;
&lt;td&gt;Keep operating Office Online Server outside its supported lifecycle, with the corresponding operational and support considerations.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;p&gt;&lt;strong&gt;BoldDocServer is designed for the first path:&lt;/strong&gt; Organizations that plan to continue using SharePoint Server while replacing the browser-based document experience provided by Office Online Server.&lt;/p&gt;

&lt;h2&gt;
  
  
  Introducing BoldDocServer
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;&lt;a href="https://www.bolddocserver.com/" rel="noopener noreferrer"&gt;BoldDocServer&lt;/a&gt;&lt;/strong&gt; is a Syncfusion product for browser-based document viewing, editing, review, and collaboration with SharePoint Server. It connects SharePoint with Syncfusion’s document experiences through the Web Application Open Platform Interface (WOPI).&lt;/p&gt;

&lt;p&gt;The responsibilities remain clearly separated:&lt;/p&gt;


&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;colgroup&gt;
&lt;col&gt;
&lt;col&gt;
&lt;/colgroup&gt;
&lt;thead&gt;&lt;tr&gt;
&lt;th&gt;Component&lt;/th&gt;
&lt;th&gt;Role&lt;/th&gt;
&lt;/tr&gt;&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;SharePoint Server&lt;/td&gt;
&lt;td&gt;Stores documents, manages permissions, and handles repository operations.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;BoldDocServer&lt;/td&gt;
&lt;td&gt;Connects SharePoint to the browser-based document experience through WOPI.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Syncfusion document experiences&lt;/td&gt;
&lt;td&gt;Provide supported Word editing, Excel editing, and PDF viewing and review capabilities.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Collaboration services&lt;/td&gt;
&lt;td&gt;Support applicable collaborative scenarios when enabled and configured.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;p&gt;The important point is that BoldDocServer does not replace SharePoint as the document repository. SharePoint continues to store documents and manage access. BoldDocServer provides the browser-based experience for supported document types.&lt;/p&gt;

&lt;h2&gt;
  
  
  Work with Word, Excel, and PDF documents from SharePoint
&lt;/h2&gt;

&lt;p&gt;BoldDocServer brings common enterprise document scenarios into the browser.&lt;/p&gt;

&lt;h3&gt;
  
  
  Edit Word documents
&lt;/h3&gt;

&lt;p&gt;Users can open supported Word files stored in SharePoint through the integrated &lt;a href="https://www.syncfusion.com/docx-editor-sdk" rel="noopener noreferrer"&gt;Syncfusion document editing experience&lt;/a&gt;. They can view and modify supported document content and save supported changes back to SharePoint through the configured WOPI workflow.&lt;/p&gt;

&lt;p&gt;Spell-check functionality can also be used when the required dictionary resources are configured.&lt;/p&gt;

&lt;h3&gt;
  
  
  Work with Excel workbooks
&lt;/h3&gt;

&lt;p&gt;For Excel files, the integrated &lt;a href="https://www.syncfusion.com/spreadsheet-editor-sdk" rel="noopener noreferrer"&gt;Syncfusion Spreadsheet Editor&lt;/a&gt; provides the browser-based workbook experience.&lt;/p&gt;

&lt;p&gt;Users can open workbooks stored in SharePoint, work with supported spreadsheet content, and save supported changes through the configured integration.&lt;/p&gt;

&lt;h3&gt;
  
  
  Review PDF documents
&lt;/h3&gt;

&lt;p&gt;PDF document experiences use the integrated &lt;a href="https://www.syncfusion.com/pdf-viewer-sdk" rel="noopener noreferrer"&gt;Syncfusion PDF Viewer&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Users can open PDFs stored in SharePoint and use supported viewing, annotation, and review capabilities without leaving the browser-based workflow.&lt;/p&gt;

&lt;h3&gt;
  
  
  Supported document experiences at a glance
&lt;/h3&gt;


&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;colgroup&gt;
&lt;col&gt;
&lt;col&gt;
&lt;/colgroup&gt;
&lt;thead&gt;&lt;tr&gt;
&lt;th&gt;Format&lt;/th&gt;
&lt;th&gt;Experience&lt;/th&gt;
&lt;/tr&gt;&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;DOCX, DOC, DOTX, DOCM, DOTM, DOT&lt;/td&gt;
&lt;td&gt;Viewing and editing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;XLSX, XLS, CSV, XLSM, XLSB&lt;/td&gt;
&lt;td&gt;Viewing and editing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;PDF&lt;/td&gt;
&lt;td&gt;Viewing and supported annotation and review&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;p&gt;Available operations depend on the corresponding document experience and deployment configuration.&lt;/p&gt;

&lt;h2&gt;
  
  
  Collaborate on document processes
&lt;/h2&gt;

&lt;p&gt;SharePoint document scenarios often involve multiple users. A Word document may move between authors and reviewers. A workbook may need updates from several team members. A PDF may require annotations before approval.&lt;/p&gt;

&lt;p&gt;BoldDocServer supports collaboration for applicable Word, Excel, and PDF experiences when the required collaboration services are enabled and configured. The exact collaboration experience depends on the document type and the capabilities enabled for the deployment.&lt;/p&gt;

&lt;h2&gt;
  
  
  Keep SharePoint in control of documents and permissions
&lt;/h2&gt;

&lt;p&gt;For organizations already invested in SharePoint Server, an important question is whether replacing the document-editing layer also means changing the way documents are stored or secured.&lt;/p&gt;

&lt;p&gt;With BoldDocServer, &lt;strong&gt;SharePoint remains the document repository and source of document permissions&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;When a document is opened, SharePoint and BoldDocServer communicate through the configured WOPI workflow. The user’s effective access determines whether the document can be edited or should be opened with restricted access.&lt;/p&gt;

&lt;p&gt;For example, when a user does not have permission to modify a document, editing operations can be restricted accordingly. This lets organizations introduce a new browser-based document experience without moving responsibility for document permissions away from SharePoint.&lt;/p&gt;

&lt;h2&gt;
  
  
  How BoldDocServer works with SharePoint
&lt;/h2&gt;

&lt;p&gt;The process can be summarized in five steps.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Select a document
&lt;/h3&gt;

&lt;p&gt;A user chooses a supported document from SharePoint.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Open the document experience
&lt;/h3&gt;

&lt;p&gt;SharePoint initiates the configured WOPI action and opens the corresponding BoldDocServer experience in the browser.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Access the document
&lt;/h3&gt;

&lt;p&gt;BoldDocServer communicates with SharePoint through the configured WOPI workflow to access the file.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. View, edit, or review
&lt;/h3&gt;

&lt;p&gt;The user works with the document through the corresponding Syncfusion document experience. Collaborative editing is available where supported and configured.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. Save supported changes
&lt;/h3&gt;

&lt;p&gt;Supported changes are saved back to SharePoint through the configured save-back process.&lt;/p&gt;

&lt;p&gt;A simplified architecture looks like this: SharePoint Server connects through WOPI to BoldDocServer, which serves the DOCX Editor, Spreadsheet Editor and PDF Viewer as a browser-based document experience.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fabty4tmpvgg6nsf62alv.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fabty4tmpvgg6nsf62alv.png" alt="How SharePoint and the browser editor work together" width="800" height="315"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Throughout the process, SharePoint remains responsible for document storage and permissions.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why BoldDocServer matters for SharePoint teams
&lt;/h2&gt;

&lt;p&gt;Office Online Server retirement creates an opportunity to review browser-based document experiences that may have been operating unchanged for years.&lt;/p&gt;

&lt;p&gt;For teams planning to continue with SharePoint Server, that review should answer questions such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Which Office Online Server workloads are business-critical?&lt;/li&gt;
&lt;li&gt;Which document types are frequently edited in the browser?&lt;/li&gt;
&lt;li&gt;Which collaboration and review features are required?&lt;/li&gt;
&lt;li&gt;Which SharePoint permission behaviors must remain unchanged?&lt;/li&gt;
&lt;li&gt;How much infrastructure change is acceptable?&lt;/li&gt;
&lt;li&gt;How early should a replacement environment be tested?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;BoldDocServer gives organizations another option when the requirement is to retain SharePoint Server while continuing supported browser-based document experiences.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who should evaluate BoldDocServer?
&lt;/h2&gt;

&lt;p&gt;BoldDocServer is especially relevant to organizations that:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Currently use Office Online Server with SharePoint Server.&lt;/li&gt;
&lt;li&gt;Plan to continue using SharePoint Server beyond December 31, 2026.&lt;/li&gt;
&lt;li&gt;Need browser-based Word and Excel editing.&lt;/li&gt;
&lt;li&gt;Need PDF viewing, annotation, or review as part of SharePoint document scenarios.&lt;/li&gt;
&lt;li&gt;Want SharePoint to remain responsible for document storage and permissions.&lt;/li&gt;
&lt;li&gt;Need a WOPI-based browser document experience.&lt;/li&gt;
&lt;li&gt;Want to test a replacement before Office Online Server reaches retirement.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Organizations with business-critical Office Online Server workloads should consider beginning their evaluation well before the deadline.&lt;/p&gt;

&lt;h2&gt;
  
  
  Is BoldDocServer a complete replacement for every Office Online Server workload?
&lt;/h2&gt;

&lt;p&gt;Not necessarily. BoldDocServer is specifically designed around SharePoint Server document scenarios involving supported Word, Excel, and PDF experiences.&lt;/p&gt;

&lt;p&gt;If your organization uses Office Online Server with other Microsoft server products or for workloads outside SharePoint, evaluate those dependencies separately as part of your transition plan.&lt;/p&gt;

&lt;p&gt;This distinction helps ensure that migration planning reflects the actual workloads used within your environment.&lt;/p&gt;

&lt;h2&gt;
  
  
  Start planning before the deadline
&lt;/h2&gt;

&lt;p&gt;December 31, 2026, may still leave some planning time, but enterprise infrastructure changes involve more than installing a replacement product.&lt;/p&gt;

&lt;p&gt;A practical evaluation can follow these steps:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Inventory your current Office Online Server workloads:&lt;/strong&gt; Identify the SharePoint sites, document types, departments, and business processes that depend on browser-based document access.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Confirm your required document capabilities:&lt;/strong&gt; Separate essential editing, review, and collaboration scenarios from features that are rarely used.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deploy BoldDocServer in a test environment:&lt;/strong&gt; Begin with a test SharePoint farm or test site rather than changing production immediately.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Configure and validate the WOPI integration:&lt;/strong&gt; Verify document opening, permissions, editing, reviewing, and save-back behavior.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test representative Word, Excel, and PDF files:&lt;/strong&gt; Use realistic documents from your organization’s existing scenarios.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Validate permissions and multiuser scenarios:&lt;/strong&gt; Test users with different SharePoint permission levels and collaboration requirements.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Plan production rollout before Office Online Server retirement:&lt;/strong&gt; Leave enough time for technical validation, security review, user testing, and operational preparation.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The goal should not simply be to replace one server with another. It should be to verify that the document processes your organization depends on continue to operate as expected.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;em&gt;Q1: What is BoldDocServer?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;BoldDocServer is a Syncfusion product that connects SharePoint Server with supported browser-based Word, Excel, and PDF experiences through WOPI. SharePoint continues to manage document storage and permissions.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q2: Why is Syncfusion introducing BoldDocServer now?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Microsoft Office Online Server reaches the end of support on December 31, 2026. BoldDocServer gives organizations that plan to continue using SharePoint Server another option for supported browser-based document experiences.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q3: Is BoldDocServer an Office Online Server alternative?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;For supported SharePoint Server document viewing, editing, review, and collaboration scenarios, BoldDocServer is designed as an alternative browser-document layer.&lt;/p&gt;

&lt;p&gt;Organizations using Office Online Server for workloads outside SharePoint should evaluate those scenarios separately.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q4: Which document formats does BoldDocServer support?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;BoldDocServer supports DOCX, DOC, DOTX, DOCM, DOTM, DOT files for Word documents, XLSX, XLS, CSV, XLSM, XLSB files for Excel workbooks, and PDF viewing with supported annotation and review operations.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q5: Does BoldDocServer replace SharePoint Server?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;No. SharePoint continues to store documents, manage permissions, and handle repository operations. BoldDocServer provides the browser-based document experience through WOPI.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q6: Can users save documents back to SharePoint?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Yes, supported changes can be saved back to SharePoint through the configured WOPI workflow. Available save operations depend on the document type, supported capabilities, and deployment configuration.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q7: Does BoldDocServer support collaboration?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;BoldDocServer supports collaboration for applicable document scenarios when the required collaboration services and features are enabled and configured. The exact behavior depends on the document type and deployment configuration.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q8: When does Office Online Server support end?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Microsoft lists December 31, 2026 as the retirement date for Office Online Server.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Q9: When should organizations begin evaluating a replacement?&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Organizations that rely on Office Online Server should begin evaluating their options before the retirement date so they have enough time to inventory document scenarios, test documents, validate SharePoint permissions and WOPI integration, and prepare for production rollout.&lt;/p&gt;

&lt;h2&gt;
  
  
  Explore BoldDocServer
&lt;/h2&gt;

&lt;p&gt;Office Online Server support ends on &lt;strong&gt;December 31, 2026&lt;/strong&gt;, but organizations do not need to wait until the deadline to decide what comes next.&lt;/p&gt;

&lt;p&gt;BoldDocServer gives SharePoint Server teams a new option for browser-based Word, Excel, and PDF experiences while keeping SharePoint at the center of document storage and permissions.&lt;/p&gt;

&lt;p&gt;If your organization expects to continue using SharePoint Server after Office Online Server retires, now is a good time to evaluate your document requirements and test your transition plan.&lt;/p&gt;

&lt;p&gt;Explore &lt;a href="https://www.bolddocserver.com/" rel="noopener noreferrer"&gt;BoldDocServer&lt;/a&gt;, &lt;a href="https://www.bolddocserver.com/downloads/confirm/" rel="noopener noreferrer"&gt;start a free trial&lt;/a&gt;, and follow the &lt;a href="https://docs.bolddocserver.com/quick-start.html" rel="noopener noreferrer"&gt;Quick Start&lt;/a&gt; and &lt;a href="https://docs.bolddocserver.com/sharepoint-integration.html" rel="noopener noreferrer"&gt;SharePoint Integration&lt;/a&gt; guides to evaluate it with your SharePoint environment.&lt;/p&gt;

</description>
      <category>sharepoint</category>
      <category>syncfusion</category>
      <category>bolddocserver</category>
      <category>documentcollaboration</category>
    </item>
    <item>
      <title>A Who's Who and a What's What of GDPR</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Thu, 12 Nov 2026 05:00:00 +0000</pubDate>
      <link>https://dev.to/syncfusion/a-whos-who-and-a-whats-what-of-gdpr-1d1f</link>
      <guid>https://dev.to/syncfusion/a-whos-who-and-a-whats-what-of-gdpr-1d1f</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;GDPR affects any organization that collects or processes personal data from individuals in the EU. This article introduces the key GDPR concepts, including personal data, anonymized data, and special category data, while explaining the roles of data controllers, processors, data subjects, DPOs, and GDPR representatives. It provides a practical foundation for understanding how modern data protection regulations work and why compliance matters.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The General Data Protection Regulation (GDPR) is the European Union’s comprehensive law that sets strict rules for how organizations collect, use, and protect EU citizens’ personal data, regardless of where the organization is based. It establishes individual rights, mandates accountability, and turns data privacy from a best practice into a legal obligation with global reach.&lt;/p&gt;

&lt;p&gt;“Who’s Who and a What’s What of GDPR” refers to understanding who the key roles are in the General Data Protection Regulation, such as data subjects, controllers, and processors, and what the important GDPR concepts are, like personal data, anonymized data, and more.&lt;/p&gt;

&lt;h2&gt;
  
  
  What’s What: Key Concepts
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Personal Data
&lt;/h3&gt;

&lt;p&gt;Personal data is any information that relates to an individual who can be directly or indirectly identified. Names, email addresses, credit card numbers, date of birth, etcetera are probably the first that come to mind when you think of the definition of personal data. However, location information, such as IP address, or other online identifiers, such as cookie ID, can also be personal data.&lt;/p&gt;

&lt;h3&gt;
  
  
  Anonymized Data
&lt;/h3&gt;

&lt;p&gt;Anonymized data is personal data that, through the use of technology, has been rendered anonymous so that it is no longer possible to identify an individual through the data, either directly or indirectly, or in combination with other data.&lt;/p&gt;

&lt;p&gt;Anonymized data is not personal data and is therefore not covered by the GDPR -provided that the personal data has been anonymized in accordance with the three criteria laid down by the European Data Protection Authorities.&lt;/p&gt;

&lt;h3&gt;
  
  
  Special Category Data
&lt;/h3&gt;

&lt;p&gt;GDPR classifies the following types of personal data as potentially more sensitive and provides them with additional protection:&lt;/p&gt;

&lt;p&gt;The special categories of personal data are:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Personal data about racial or ethnic origin.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Personal data about political opinions.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Personal data about religious or philosophical beliefs.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Personal data about trade union membership.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Genetic data.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Biometric data (where used for identification purposes)—this could be data such as fingerprints or retina scans.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Data concerning health.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These types of personal data merit specific protection and must be handled with greater care, as using them could create significant risks to an individual’s fundamental rights and freedoms or expose them to discrimination.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who’s Who: Key Roles
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Data Controller
&lt;/h3&gt;

&lt;p&gt;The data controller determines the purposes for which and how personal data is processed. So, if your company or organization decides why and how the personal data should be processed, it is the data controller. Employees process personal data within your organization to fulfill their tasks as data controllers.&lt;/p&gt;

&lt;h3&gt;
  
  
  Data Processor
&lt;/h3&gt;

&lt;p&gt;A data processor is the individual (other than an employee of the controller) or the legal person that carries out processing activities, on behalf of and in accordance with the controller’s instructions. In other words, the data controller can provide personal data to the data processor to carry out such processing activities on its behalf. A legal agreement governs arrangements between the data controller and the data processor.&lt;/p&gt;

&lt;h3&gt;
  
  
  Data Subject
&lt;/h3&gt;

&lt;p&gt;A data subject is any individual whose personal data is being collected, processed, or stored. This could include names, email addresses, ID numbers, IP addresses, biometric data, and anything else covered under GDPR’s definition of personal data. Under regulations like GDPR, the data subject is the individual the data refers to and is central to modern data protection laws.&lt;/p&gt;

&lt;h3&gt;
  
  
  Data Protection Officer
&lt;/h3&gt;

&lt;p&gt;Some data controllers must have a Data Protection Officer (DPO), while others choose to appoint a DPO (or an assigned individual) to handle data protection matters on their behalf. Individuals can also contact the DPO with data protection queries or concerns. If a company has no DPO, other people in the company will address any data protection queries or concerns on behalf of the data controller. Note that these individuals are not data controllers themselves; they are acting on behalf of the data controller.&lt;/p&gt;

&lt;h2&gt;
  
  
  GDPR Representative
&lt;/h2&gt;

&lt;p&gt;If you do not have an office in the EU/EEA but still process data from individuals based in the EU/EEA, then you still need to comply with the GDPR regarding your data processing, and the GDPR requires you to appoint a representative. This representative must be based in an EU or EEA state where some of the individuals whose personal data you process are located.&lt;/p&gt;

&lt;p&gt;You must authorize the representative in writing to act on your behalf for GDPR compliance. Be aware that a Data Representative is not a Data Protection Officer (DPO). It has a distinct role with its own responsibilities. The representative’s role is to ensure that you comply with the GDPR by enabling communication with individuals in Europe and European data protection authorities.&lt;/p&gt;

&lt;p&gt;You should provide details of your representative to EEA-based individuals whose personal data you process, typically by including the contact details in your privacy policy. The representative must also be able to act on your behalf with European data protection authorities.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;As we’ve explored, GDPR is more than just a set of rules; it’s a fundamental shift in how we approach data protection. It empowers individuals, holds organizations accountable, and aims to create a safer digital environment for all of us. Whether you’re an individual concerned about your privacy or a business striving for compliance, understanding GDPR is crucial in today’s data-driven world.&lt;/p&gt;

&lt;p&gt;GDPR compliance is an ongoing journey. It requires continuous attention, adaptation, and improvement. But by embracing its principles and implementing robust data protection practices, we can all contribute to a digital landscape where personal data is respected and protected.&lt;/p&gt;

</description>
      <category>dataprivacy</category>
      <category>gdpr</category>
      <category>compliance</category>
      <category>dataprotection</category>
    </item>
    <item>
      <title>Syncfusion Essential Studio Adds Day-One Support for .NET 11</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Wed, 11 Nov 2026 12:33:11 +0000</pubDate>
      <link>https://dev.to/jollenmoyani/syncfusion-essential-studio-adds-day-one-support-for-net-11-l34</link>
      <guid>https://dev.to/jollenmoyani/syncfusion-essential-studio-adds-day-one-support-for-net-11-l34</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Syncfusion Essential Studio now supports .NET 11 from day one across .NET MAUI, Blazor, WPF, WinForms, WinUI, and Document SDK libraries. Developers can begin evaluating and upgrading supported Syncfusion applications to .NET 11 while taking advantage of the latest runtime, framework, tooling, and C# 15 capabilities.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  .NET 11 is here and Syncfusion Essential Studio is ready
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://devblogs.microsoft.com/dotnet/announcing-dotnet-11/" rel="noopener noreferrer"&gt;.NET 11&lt;/a&gt; is now generally available, bringing updates across the .NET runtime, C# 15, ASP.NET Core and Blazor, .NET MAUI, Windows development, libraries, tooling, and AI development.&lt;/p&gt;

&lt;p&gt;For teams maintaining production applications, however, a new .NET release brings an immediate practical question:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Are the UI components and document-processing libraries our applications depend on ready for the new runtime?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;With day-one .NET 11 support, Syncfusion® &lt;a href="https://www.syncfusion.com/ui-component-suite" rel="noopener noreferrer"&gt;Essential Studio&lt;/a&gt; enables developers to begin evaluating the new release without waiting for a later compatibility update across supported Syncfusion platforms.&lt;/p&gt;

&lt;p&gt;That includes applications built with:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/maui-controls" rel="noopener noreferrer"&gt;.NET MAUI&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blazor-components" rel="noopener noreferrer"&gt;Blazor&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/wpf-controls" rel="noopener noreferrer"&gt;WPF&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/winforms-ui-controls" rel="noopener noreferrer"&gt;WinForms&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/winui-controls" rel="noopener noreferrer"&gt;WinUI&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Syncfusion Document SDK libraries&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Upgrading a production application still requires testing your own dependencies, application scenarios, deployment environment, and Microsoft’s .NET 11 breaking changes. Day-one support means the Syncfusion compatibility layer is available when you begin that evaluation.&lt;/p&gt;

&lt;p&gt;Let’s look at what .NET 11 support means for Syncfusion developers, the framework changes worth knowing about, and the steps to consider when upgrading.&lt;/p&gt;

&lt;h2&gt;
  
  
  Syncfusion .NET 11 support at a glance
&lt;/h2&gt;


&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;&lt;tr&gt;
&lt;th&gt;Syncfusion platform&lt;/th&gt;
&lt;th&gt;.NET 11 support&lt;/th&gt;
&lt;/tr&gt;&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;.NET MAUI&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Blazor&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;WPF&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;WinForms&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;WinUI&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Document SDK libraries&lt;/td&gt;
&lt;td&gt;Supported&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;p&gt;If your application uses more than one Syncfusion package or platform dependency, update the related packages together and validate the complete application before deploying the .NET 11 build to production.&lt;/p&gt;

&lt;h2&gt;
  
  
  What day-one .NET 11 support means for developers
&lt;/h2&gt;

&lt;p&gt;Framework compatibility involves more than changing the target framework and rebuilding.&lt;/p&gt;

&lt;p&gt;A .NET application can depend on UI components, document libraries, third-party packages, native dependencies, publishing modes, operating-system capabilities, and application-specific requirements.&lt;/p&gt;

&lt;p&gt;When evaluating .NET 11, consider the complete application.&lt;/p&gt;

&lt;h3&gt;
  
  
  Update supported packages
&lt;/h3&gt;

&lt;p&gt;Use &lt;a href="https://www.nuget.org/profiles/SyncfusionInc" rel="noopener noreferrer"&gt;Syncfusion NuGet&lt;/a&gt; package versions that support .NET 11 and keep related Syncfusion packages aligned.&lt;/p&gt;

&lt;h3&gt;
  
  
  Review .NET 11 breaking changes
&lt;/h3&gt;

&lt;p&gt;Review Microsoft’s &lt;a href="https://learn.microsoft.com/en-us/dotnet/core/compatibility/11" rel="noopener noreferrer"&gt;compatibility and breaking changes&lt;/a&gt; documentation for the frameworks and APIs your application uses.&lt;/p&gt;

&lt;h3&gt;
  
  
  Test platform-specific behavior
&lt;/h3&gt;

&lt;p&gt;Validate behavior that matters to your application, such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Data loading and editing.&lt;/li&gt;
&lt;li&gt;Filtering and sorting.&lt;/li&gt;
&lt;li&gt;Virtualization.&lt;/li&gt;
&lt;li&gt;Charts and visualization.&lt;/li&gt;
&lt;li&gt;Forms and validation.&lt;/li&gt;
&lt;li&gt;Scheduling.&lt;/li&gt;
&lt;li&gt;Themes and styling.&lt;/li&gt;
&lt;li&gt;Printing and export.&lt;/li&gt;
&lt;li&gt;Document generation and conversion.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Retest business-critical scenarios
&lt;/h3&gt;

&lt;p&gt;A successful build does not confirm that every application scenario behaves exactly as it did previously.&lt;/p&gt;

&lt;p&gt;Run your application’s unit, integration, UI, regression, and performance tests against representative workloads before production deployment.&lt;/p&gt;

&lt;h2&gt;
  
  
  .NET 11 highlights that matter for Syncfusion developers
&lt;/h2&gt;

&lt;p&gt;.NET 11 includes a large number of changes across the ecosystem.&lt;/p&gt;

&lt;p&gt;Rather than reproducing the complete .NET 11 release notes, here are some of the changes particularly relevant to developers building UI-heavy and enterprise applications with Syncfusion.&lt;/p&gt;

&lt;h3&gt;
  
  
  .NET MAUI: CoreCLR, XAML, and developer productivity
&lt;/h3&gt;

&lt;p&gt;One of the most significant changes in .NET 11 for .NET MAUI is the move to &lt;strong&gt;CoreCLR as the default runtime&lt;/strong&gt; across supported MAUI platforms.&lt;/p&gt;

&lt;p&gt;For developers, this brings the MAUI runtime closer to the broader .NET ecosystem and contributes to improvements in areas such as debugging, profiling, performance, and development experience.&lt;/p&gt;

&lt;p&gt;.NET 11 also continues improving the XAML development experience.&lt;/p&gt;

&lt;p&gt;Highlights include:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Improvements to XAML source generation.&lt;/li&gt;
&lt;li&gt;Better binding diagnostics.&lt;/li&gt;
&lt;li&gt;Lazy &lt;code&gt;ResourceDictionary&lt;/code&gt; loading.&lt;/li&gt;
&lt;li&gt;XAML Incremental Hot Reload improvements.&lt;/li&gt;
&lt;li&gt;Improvements for compiled bindings.&lt;/li&gt;
&lt;li&gt;Additional controls and platform capabilities.&lt;/li&gt;
&lt;li&gt;Testing and accessibility improvements.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The framework also includes enhancements to maps, animations, &lt;code&gt;CollectionView&lt;/code&gt; behavior, and native platform experiences.&lt;/p&gt;

&lt;h4&gt;
  
  
  What this means for Syncfusion .NET MAUI developers
&lt;/h4&gt;

&lt;p&gt;Syncfusion &lt;a href="https://www.syncfusion.com/maui-controls" rel="noopener noreferrer"&gt;.NET MAUI controls&lt;/a&gt; support .NET 11, so existing applications can evaluate the new runtime while continuing to use controls such as &lt;a href="https://www.syncfusion.com/maui-controls/maui-datagrid" rel="noopener noreferrer"&gt;DataGrid&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/scheduler-sdk/maui-scheduler" rel="noopener noreferrer"&gt;Scheduler&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/maui-controls/maui-cartesian-charts" rel="noopener noreferrer"&gt;Charts&lt;/a&gt;, and other Syncfusion UI components.&lt;/p&gt;

&lt;p&gt;When upgrading, test the scenarios most important to your application.&lt;/p&gt;

&lt;p&gt;For example:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;DataGrid grouping, filtering, editing, and virtualization.&lt;/li&gt;
&lt;li&gt;Scheduler navigation and interactions.&lt;/li&gt;
&lt;li&gt;Chart rendering and updates.&lt;/li&gt;
&lt;li&gt;Large datasets.&lt;/li&gt;
&lt;li&gt;Device-specific layouts.&lt;/li&gt;
&lt;li&gt;Application startup and navigation.&lt;/li&gt;
&lt;li&gt;Existing XAML and binding behavior.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Blazor: Better forms, virtualization, and agentic UI experiences
&lt;/h3&gt;

&lt;p&gt;.NET 11 adds several capabilities to Blazor and ASP.NET Core that are relevant to data-driven enterprise applications.&lt;/p&gt;

&lt;h4&gt;
  
  
  Improved form validation
&lt;/h4&gt;

&lt;p&gt;Blazor static server-side rendering forms gain improved client-side and asynchronous validation capabilities.&lt;/p&gt;

&lt;p&gt;For applications with complex forms, this makes it easier to provide immediate validation while supporting rules that depend on remote APIs or other asynchronous operations.&lt;/p&gt;

&lt;h4&gt;
  
  
  Better virtualization
&lt;/h4&gt;

&lt;p&gt;The &lt;code&gt;Virtualize&lt;/code&gt; component receives improvements for items with different heights and adds capabilities for controlling scrolling and viewport behavior.&lt;/p&gt;

&lt;p&gt;These improvements can be useful in interfaces such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Chat experiences.&lt;/li&gt;
&lt;li&gt;Activity feeds.&lt;/li&gt;
&lt;li&gt;Logs.&lt;/li&gt;
&lt;li&gt;Large dynamic lists.&lt;/li&gt;
&lt;/ul&gt;

&lt;h4&gt;
  
  
  Static SSR improvements
&lt;/h4&gt;

&lt;p&gt;.NET 11 expands static SSR capabilities, including improvements around caching, session-related scenarios, and state management.&lt;/p&gt;

&lt;h4&gt;
  
  
  Agentic UI development
&lt;/h4&gt;

&lt;p&gt;.NET 11 also advances the AI application story for Blazor.&lt;/p&gt;

&lt;p&gt;Microsoft is introducing experimental capabilities for building richer agentic interfaces, including scenarios where applications can stream AI output, render tool interactions, manage approvals, and coordinate UI state with AI agents.&lt;/p&gt;

&lt;p&gt;For Syncfusion Blazor developers, this expands the range of AI-driven application experiences that can be explored alongside existing Syncfusion UI components.&lt;/p&gt;

&lt;h4&gt;
  
  
  What this means for Syncfusion Blazor developers
&lt;/h4&gt;

&lt;p&gt;Syncfusion &lt;a href="https://www.syncfusion.com/blazor-components" rel="noopener noreferrer"&gt;Blazor components&lt;/a&gt; support .NET 11.&lt;/p&gt;

&lt;p&gt;For applications using &lt;a href="https://www.syncfusion.com/blazor-components/blazor-datagrid" rel="noopener noreferrer"&gt;DataGrid&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/blazor-components/blazor-scheduler" rel="noopener noreferrer"&gt;Scheduler&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/blazor-components/blazor-charts" rel="noopener noreferrer"&gt;Charts&lt;/a&gt;, forms, dashboards, or other interactive components, validate:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Data binding.&lt;/li&gt;
&lt;li&gt;Sorting and filtering.&lt;/li&gt;
&lt;li&gt;Virtualization.&lt;/li&gt;
&lt;li&gt;Form validation.&lt;/li&gt;
&lt;li&gt;Interactive render modes.&lt;/li&gt;
&lt;li&gt;Export operations.&lt;/li&gt;
&lt;li&gt;Authentication-related behavior.&lt;/li&gt;
&lt;li&gt;Server and WebAssembly deployment scenarios used by your application.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Desktop development: WPF, WinForms, and WinUI
&lt;/h3&gt;

&lt;p&gt;.NET 11 also brings runtime, library, tooling, and Windows-development improvements relevant to desktop applications.&lt;/p&gt;

&lt;h4&gt;
  
  
  Runtime and JIT improvements
&lt;/h4&gt;

&lt;p&gt;The .NET 11 runtime includes optimizations across JIT compilation, asynchronous operations, code generation, and core libraries.&lt;/p&gt;

&lt;p&gt;These improvements can benefit applicable workloads, although the impact depends on the code paths and application.&lt;/p&gt;

&lt;h4&gt;
  
  
  Runtime Async
&lt;/h4&gt;

&lt;p&gt;.NET 11 includes Runtime Async as a preview feature.&lt;/p&gt;

&lt;p&gt;Runtime Async moves more of the mechanics behind asynchronous execution into the runtime, with goals including lower overhead and cleaner async stack traces.&lt;/p&gt;

&lt;p&gt;Because it remains a preview capability, evaluate it separately before considering it for production application code.&lt;/p&gt;

&lt;h4&gt;
  
  
  WinForms improvements
&lt;/h4&gt;

&lt;p&gt;.NET 11 includes improvements for Windows Forms across areas such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Visual styling.&lt;/li&gt;
&lt;li&gt;Full-screen and kiosk scenarios.&lt;/li&gt;
&lt;li&gt;System visual settings.&lt;/li&gt;
&lt;li&gt;Startup behavior.&lt;/li&gt;
&lt;li&gt;Rendering and layout.&lt;/li&gt;
&lt;li&gt;Input handling.&lt;/li&gt;
&lt;/ul&gt;

&lt;h4&gt;
  
  
  WPF improvements
&lt;/h4&gt;

&lt;p&gt;WPF receives reliability and rendering updates across several desktop scenarios.&lt;/p&gt;

&lt;h4&gt;
  
  
  Syncfusion desktop controls
&lt;/h4&gt;

&lt;p&gt;Syncfusion &lt;a href="https://www.syncfusion.com/wpf-controls" rel="noopener noreferrer"&gt;WPF&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/winforms-ui-controls" rel="noopener noreferrer"&gt;WinForms&lt;/a&gt;, and &lt;a href="https://www.syncfusion.com/winui-controls" rel="noopener noreferrer"&gt;WinUI&lt;/a&gt; controls support .NET 11.&lt;/p&gt;

&lt;p&gt;When upgrading a desktop application, validate scenarios such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;DataGrid rendering and editing.&lt;/li&gt;
&lt;li&gt;Chart updates.&lt;/li&gt;
&lt;li&gt;Theming.&lt;/li&gt;
&lt;li&gt;High-DPI behavior.&lt;/li&gt;
&lt;li&gt;Keyboard and pointer interaction.&lt;/li&gt;
&lt;li&gt;Printing.&lt;/li&gt;
&lt;li&gt;Export.&lt;/li&gt;
&lt;li&gt;Document viewing.&lt;/li&gt;
&lt;li&gt;Window and layout behavior.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  C# 15 comes with .NET 11
&lt;/h3&gt;

&lt;p&gt;C# 15 is the default language version for projects targeting .NET 11.&lt;/p&gt;

&lt;p&gt;It introduces new language capabilities including:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Collection expression arguments.&lt;/li&gt;
&lt;li&gt;Union types.&lt;/li&gt;
&lt;li&gt;Closed hierarchies.&lt;/li&gt;
&lt;li&gt;Extension indexers.&lt;/li&gt;
&lt;li&gt;Labeled &lt;code&gt;break&lt;/code&gt; and &lt;code&gt;continue&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Additional memory-safety work.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These language features are independent of Syncfusion components, but developers can use supported C# 15 capabilities alongside Syncfusion applications targeting .NET 11.&lt;/p&gt;

&lt;p&gt;As with any new language feature, evaluate whether it improves the clarity and maintainability of the specific application rather than adopting it simply because it is new.&lt;/p&gt;

&lt;h2&gt;
  
  
  Syncfusion Document SDK libraries on .NET 11
&lt;/h2&gt;

&lt;p&gt;Syncfusion &lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Document SDK libraries&lt;/a&gt; also support .NET 11.&lt;/p&gt;

&lt;p&gt;This means document-processing applications can evaluate the new runtime while continuing to use Syncfusion libraries for document-processing tasks involving formats such as &lt;a href="https://www.syncfusion.com/document-sdk/net-pdf-library" rel="noopener noreferrer"&gt;PDF&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/document-sdk/net-word-library" rel="noopener noreferrer"&gt;Word&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/document-sdk/net-excel-library" rel="noopener noreferrer"&gt;Excel&lt;/a&gt;, and &lt;a href="https://www.syncfusion.com/document-sdk/net-powerpoint-library" rel="noopener noreferrer"&gt;PowerPoint&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;.NET 11 includes runtime and library optimizations that may benefit some document-processing workloads.&lt;/p&gt;

&lt;p&gt;However, a newer runtime does not guarantee that every document operation becomes faster.&lt;/p&gt;

&lt;p&gt;The performance difference depends on factors including:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The document operation.&lt;/li&gt;
&lt;li&gt;Input-file size and complexity.&lt;/li&gt;
&lt;li&gt;Memory allocation behavior.&lt;/li&gt;
&lt;li&gt;Runtime execution paths.&lt;/li&gt;
&lt;li&gt;Application concurrency.&lt;/li&gt;
&lt;li&gt;Publishing configuration.&lt;/li&gt;
&lt;li&gt;Hardware.&lt;/li&gt;
&lt;li&gt;Syncfusion package version.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Our internal validation showed lower execution times in several selected Document SDK operations on .NET 11, while some operations showed little or no difference compared with .NET 10.&lt;/p&gt;

&lt;p&gt;The important takeaway is not that every operation receives the same improvement.&lt;/p&gt;

&lt;p&gt;If document-processing performance matters to your application, benchmark your own representative files and workloads on both runtimes before making performance assumptions.&lt;/p&gt;

&lt;h2&gt;
  
  
  How to upgrade a Syncfusion application to .NET 11
&lt;/h2&gt;

&lt;p&gt;The exact upgrade process depends on your application platform, but this provides a practical starting point.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Install the .NET 11 SDK and compatible development tools
&lt;/h3&gt;

&lt;p&gt;Install the final .NET 11 SDK and ensure that your development and CI environments use compatible tooling.&lt;/p&gt;

&lt;p&gt;Verify the installed SDKs with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;button &lt;span class="nv"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"button"&lt;/span&gt; aria-label=&lt;span class="s2"&gt;"Copy code"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;svg &lt;span class="nv"&gt;width&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"16"&lt;/span&gt; &lt;span class="nv"&gt;height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"16"&lt;/span&gt; &lt;span class="nv"&gt;viewbox&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"0 0 16 16"&lt;/span&gt; &lt;span class="nv"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"none"&lt;/span&gt; aria-hidden=&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="nv"&gt;focusable&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"false"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;path fill-rule=&lt;span class="s2"&gt;"evenodd"&lt;/span&gt; clip-rule=&lt;span class="s2"&gt;"evenodd"&lt;/span&gt; &lt;span class="nv"&gt;d&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"M4.889 1.556C4.889.696 5.585 0 6.444 0h8c.86 0 1.556.696 1.556 1.556v8c0 .859-.696 1.555-1.556 1.555h-8c-.859 0-1.555-.696-1.555-1.555v-8zm1.555-.223a.222.222 0 0 0-.222.223v8c0 .122.1.222.222.222h8c.123 0 .223-.1.223-.222v-8a.222.222 0 0 0-.223-.223h-8zM1.556 6.222a.222.222 0 0 0-.223.222v8c0 .123.1.223.223.223h8c.122 0 .222-.1.222-.223v-.888a.667.667 0 1 1 1.333 0v.888c0 .86-.696 1.556-1.555 1.556h-8C.696 16 0 15.304 0 14.444v-8c0-.859.696-1.555 1.556-1.555h.888a.667.667 0 1 1 0 1.333h-.888z"&lt;/span&gt; &lt;span class="nv"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"#fff"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/path&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/svg&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/button&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;dotnet --list-sdks

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Avoid mixing preview and final SDK versions between developer machines and CI unless that configuration is intentional.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Update the target framework
&lt;/h3&gt;

&lt;p&gt;Update the project’s target framework to the appropriate .NET 11 target framework moniker for your application type.&lt;/p&gt;

&lt;p&gt;For a standard .NET application, for example:&lt;/p&gt;

&lt;p&gt;XML&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;button&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt; &lt;span class="na"&gt;aria-label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Copy code"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;svg&lt;/span&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"16"&lt;/span&gt; &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"16"&lt;/span&gt; &lt;span class="na"&gt;viewbox&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"0 0 16 16"&lt;/span&gt; &lt;span class="na"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"none"&lt;/span&gt; &lt;span class="na"&gt;aria-hidden&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"true"&lt;/span&gt; &lt;span class="na"&gt;focusable&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"false"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;path&lt;/span&gt; &lt;span class="na"&gt;fill-rule&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"evenodd"&lt;/span&gt; &lt;span class="na"&gt;clip-rule&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"evenodd"&lt;/span&gt; &lt;span class="na"&gt;d&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"M4.889 1.556C4.889.696 5.585 0 6.444 0h8c.86 0 1.556.696 1.556 1.556v8c0 .859-.696 1.555-1.556 1.555h-8c-.859 0-1.555-.696-1.555-1.555v-8zm1.555-.223a.222.222 0 0 0-.222.223v8c0 .122.1.222.222.222h8c.123 0 .223-.1.223-.222v-8a.222.222 0 0 0-.223-.223h-8zM1.556 6.222a.222.222 0 0 0-.223.222v8c0 .123.1.223.223.223h8c.122 0 .222-.1.222-.223v-.888a.667.667 0 1 1 1.333 0v.888c0 .86-.696 1.556-1.555 1.556h-8C.696 16 0 15.304 0 14.444v-8c0-.859.696-1.555 1.556-1.555h.888a.667.667 0 1 1 0 1.333h-.888z"&lt;/span&gt; &lt;span class="na"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"#fff"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/path&amp;gt;&amp;lt;/svg&amp;gt;&amp;lt;/button&amp;gt;&amp;lt;TargetFramework&amp;gt;&lt;/span&gt;net11.0&lt;span class="nt"&gt;&amp;lt;/TargetFramework&amp;gt;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Windows desktop and .NET MAUI projects use the corresponding platform-specific target frameworks.&lt;/p&gt;

&lt;p&gt;Follow Microsoft’s platform documentation for the exact TFM required by your application.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Update Syncfusion packages
&lt;/h3&gt;

&lt;p&gt;Update to Syncfusion package versions that support .NET 11.&lt;/p&gt;

&lt;p&gt;For applications using multiple Syncfusion packages, keep compatible package versions aligned instead of updating individual dependencies in isolation.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Restore packages and workloads
&lt;/h3&gt;

&lt;p&gt;Restore the application dependencies and any required platform workloads.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;button &lt;span class="nv"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"button"&lt;/span&gt; aria-label=&lt;span class="s2"&gt;"Copy code"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;svg &lt;span class="nv"&gt;width&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"16"&lt;/span&gt; &lt;span class="nv"&gt;height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"16"&lt;/span&gt; &lt;span class="nv"&gt;viewbox&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"0 0 16 16"&lt;/span&gt; &lt;span class="nv"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"none"&lt;/span&gt; aria-hidden=&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="nv"&gt;focusable&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"false"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;path fill-rule=&lt;span class="s2"&gt;"evenodd"&lt;/span&gt; clip-rule=&lt;span class="s2"&gt;"evenodd"&lt;/span&gt; &lt;span class="nv"&gt;d&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"M4.889 1.556C4.889.696 5.585 0 6.444 0h8c.86 0 1.556.696 1.556 1.556v8c0 .859-.696 1.555-1.556 1.555h-8c-.859 0-1.555-.696-1.555-1.555v-8zm1.555-.223a.222.222 0 0 0-.222.223v8c0 .122.1.222.222.222h8c.123 0 .223-.1.223-.222v-8a.222.222 0 0 0-.223-.223h-8zM1.556 6.222a.222.222 0 0 0-.223.222v8c0 .123.1.223.223.223h8c.122 0 .222-.1.222-.223v-.888a.667.667 0 1 1 1.333 0v.888c0 .86-.696 1.556-1.555 1.556h-8C.696 16 0 15.304 0 14.444v-8c0-.859.696-1.555 1.556-1.555h.888a.667.667 0 1 1 0 1.333h-.888z"&lt;/span&gt; &lt;span class="nv"&gt;fill&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"#fff"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/path&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/svg&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/button&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;dotnet restore

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For platforms such as .NET MAUI, make sure the corresponding .NET 11 workloads are installed and up to date.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. Review breaking changes
&lt;/h3&gt;

&lt;p&gt;Check Microsoft’s &lt;a href="https://learn.microsoft.com/en-us/dotnet/core/compatibility/11" rel="noopener noreferrer"&gt;.NET 11 compatibility documentation&lt;/a&gt; for changes relevant to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Runtime behavior.&lt;/li&gt;
&lt;li&gt;ASP.NET Core.&lt;/li&gt;
&lt;li&gt;.NET MAUI.&lt;/li&gt;
&lt;li&gt;WPF.&lt;/li&gt;
&lt;li&gt;WinForms.&lt;/li&gt;
&lt;li&gt;Libraries.&lt;/li&gt;
&lt;li&gt;SDK and tooling.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Also review application-specific third-party dependencies before upgrading production projects.&lt;/p&gt;

&lt;h3&gt;
  
  
  6. Build the application
&lt;/h3&gt;

&lt;p&gt;Perform a clean build and resolve any compilation, package, workload, or analyzer issues.&lt;/p&gt;

&lt;h3&gt;
  
  
  7. Run regression tests
&lt;/h3&gt;

&lt;p&gt;Test the application scenarios your users actually depend on.&lt;/p&gt;

&lt;p&gt;Do not treat a successful build as the end of the upgrade validation.&lt;/p&gt;

&lt;h2&gt;
  
  
  What should you test before moving to production?
&lt;/h2&gt;

&lt;p&gt;The validation checklist depends on the platform.&lt;/p&gt;

&lt;h3&gt;
  
  
  .NET MAUI
&lt;/h3&gt;

&lt;p&gt;Test:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Startup.&lt;/li&gt;
&lt;li&gt;Navigation.&lt;/li&gt;
&lt;li&gt;DataGrid behavior.&lt;/li&gt;
&lt;li&gt;Charts.&lt;/li&gt;
&lt;li&gt;Scheduler.&lt;/li&gt;
&lt;li&gt;XAML bindings.&lt;/li&gt;
&lt;li&gt;Large datasets.&lt;/li&gt;
&lt;li&gt;Device-specific layouts.&lt;/li&gt;
&lt;li&gt;Android, iOS, Windows, and macOS scenarios your application supports.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Blazor
&lt;/h3&gt;

&lt;p&gt;Test:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Server and WebAssembly scenarios you use.&lt;/li&gt;
&lt;li&gt;Forms and validation.&lt;/li&gt;
&lt;li&gt;Data loading.&lt;/li&gt;
&lt;li&gt;Virtualization.&lt;/li&gt;
&lt;li&gt;Authentication.&lt;/li&gt;
&lt;li&gt;Grid operations.&lt;/li&gt;
&lt;li&gt;Export.&lt;/li&gt;
&lt;li&gt;Interactive components.&lt;/li&gt;
&lt;li&gt;Reconnection and server-state behavior where applicable.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  WPF, WinForms, and WinUI
&lt;/h3&gt;

&lt;p&gt;Test:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Rendering.&lt;/li&gt;
&lt;li&gt;Editing.&lt;/li&gt;
&lt;li&gt;Themes.&lt;/li&gt;
&lt;li&gt;High-DPI displays.&lt;/li&gt;
&lt;li&gt;Accessibility.&lt;/li&gt;
&lt;li&gt;Printing.&lt;/li&gt;
&lt;li&gt;Export.&lt;/li&gt;
&lt;li&gt;Keyboard and pointer input.&lt;/li&gt;
&lt;li&gt;Window behavior.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Document SDK
&lt;/h3&gt;

&lt;p&gt;Test representative:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;PDF operations.&lt;/li&gt;
&lt;li&gt;Word conversions.&lt;/li&gt;
&lt;li&gt;Excel imports and exports.&lt;/li&gt;
&lt;li&gt;PowerPoint operations.&lt;/li&gt;
&lt;li&gt;Large files.&lt;/li&gt;
&lt;li&gt;Concurrent processing.&lt;/li&gt;
&lt;li&gt;Memory consumption.&lt;/li&gt;
&lt;li&gt;Production deployment configuration.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Whenever performance is important, measure the application using the files, hardware, concurrency, and deployment model that reflect your actual production workload.&lt;/p&gt;

&lt;h2&gt;
  
  
  Should you move to .NET 11 immediately?
&lt;/h2&gt;

&lt;p&gt;.NET 11 is a &lt;strong&gt;Standard Term Support (STS)&lt;/strong&gt; release.&lt;/p&gt;

&lt;p&gt;Whether you should upgrade immediately depends on your organization’s requirements.&lt;/p&gt;

&lt;p&gt;.NET 11 may be a good fit when you want:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Access to the latest framework and runtime capabilities.&lt;/li&gt;
&lt;li&gt;The newest .NET MAUI and Blazor improvements.&lt;/li&gt;
&lt;li&gt;C# 15.&lt;/li&gt;
&lt;li&gt;Current AI and agentic development capabilities.&lt;/li&gt;
&lt;li&gt;The latest runtime and tooling improvements.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Organizations that prioritize a longer support window may decide to remain on a supported LTS release depending on their lifecycle requirements.&lt;/p&gt;

&lt;p&gt;The important point is that &lt;strong&gt;Syncfusion’s .NET 11 support lets you make that decision based on your application strategy rather than waiting for component compatibility&lt;/strong&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently asked questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: Does Syncfusion Essential Studio support .NET 11?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Syncfusion Essential Studio provides .NET 11 support across .NET MAUI, Blazor, WPF, WinForms, WinUI, and Document SDK libraries.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Which Syncfusion platforms support .NET 11?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The support covered in this release includes .NET MAUI, Blazor, WPF, WinForms, WinUI, and Syncfusion Document SDK libraries.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Do I need to rewrite my Syncfusion application to move to .NET 11?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Not necessarily, but every application should be evaluated individually.&lt;/p&gt;

&lt;p&gt;Retarget the application, update compatible Syncfusion and third-party packages, review Microsoft’s breaking changes, and run regression tests against your important application scenarios.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Does .NET 11 automatically make Syncfusion applications faster?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;No. .NET 11 contains runtime and JIT optimizations that can improve applicable workloads, but actual results depend on the application, data, hardware, operation, and deployment environment.&lt;/p&gt;

&lt;p&gt;Measure performance using representative workloads before drawing conclusions.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Is Runtime Async production-ready in .NET 11?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Runtime Async is available in .NET 11 as a preview feature. Evaluate it separately before using it for production-specific application code.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q6: Does .NET 11 use C# 15?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. C# 15 is the default language version for projects targeting .NET 11 with the .NET 11 SDK.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q7: Is .NET 11 an LTS release?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;No. .NET 11 is a Standard Term Support (STS) release. Organizations should consider their support-lifecycle requirements when deciding between .NET 11 and a supported LTS release.&lt;/p&gt;

&lt;h2&gt;
  
  
  Get started with Syncfusion and .NET 11
&lt;/h2&gt;

&lt;p&gt;.NET 11 brings updates across runtime performance, developer tooling, C# 15, .NET MAUI, Blazor, desktop development, core libraries, and AI application development.&lt;/p&gt;

&lt;p&gt;With day-one .NET 11 support across Syncfusion Essential Studio UI components and Document SDK libraries, developers can begin evaluating these capabilities within their existing Syncfusion development environments.&lt;/p&gt;

&lt;p&gt;If you’re planning an upgrade:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Install the final &lt;a href="https://dotnet.microsoft.com/en-us/download/dotnet/11.0" rel="noopener noreferrer"&gt;.NET 11 SDK&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Update to the &lt;a href="https://www.nuget.org/profiles/SyncfusionInc" rel="noopener noreferrer"&gt;Syncfusion packages&lt;/a&gt; that support .NET 11.&lt;/li&gt;
&lt;li&gt;Retarget the application.&lt;/li&gt;
&lt;li&gt;Review breaking changes.&lt;/li&gt;
&lt;li&gt;Build and test representative workloads.&lt;/li&gt;
&lt;li&gt;Validate production-critical behavior before deployment.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Explore the latest Syncfusion Essential Studio release from your Syncfusion &lt;a href="https://www.syncfusion.com/account" rel="noopener noreferrer"&gt;license and download&lt;/a&gt; page.&lt;/p&gt;

&lt;p&gt;If you have questions while upgrading, use the Syncfusion &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forum&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback/" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/model-context-protocol-handbook" rel="noopener noreferrer"&gt;Tired of Fragile AI Integrations? Learn MCP Before Your Next Project&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-coding-assistant-agent-skills-mcp" rel="noopener noreferrer"&gt;Build Faster with Syncfusion AI Coding Assistant Tools: Agent Skills and MCP Servers&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/model-context-protocol-csharp-sdk" rel="noopener noreferrer"&gt;Model Context Protocol (MCP): Building AI Integrations in .NET Using the C# SD&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/enterprise-ui-with-mcp-servers" rel="noopener noreferrer"&gt;Introducing Agentic UI Builder: Build Complete Enterprise UIs with Syncfusion MCP Servers&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>syncfusion</category>
      <category>dotnet</category>
      <category>development</category>
      <category>dotnet11</category>
    </item>
    <item>
      <title>Jev AI vs. Structured-Output LLMs: Which One Should You Actually Use?</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Mon, 02 Nov 2026 22:30:00 +0000</pubDate>
      <link>https://dev.to/syncfusion/jev-ai-vs-structured-output-llms-which-one-should-you-actually-use-1ga1</link>
      <guid>https://dev.to/syncfusion/jev-ai-vs-structured-output-llms-which-one-should-you-actually-use-1ga1</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Choosing between Jev AI and structured-output LLMs? It comes down to the task. Jev AI is great for quick decisions like categorizing, scoring, and routing, while structured-output LLMs handle tasks like extracting data, explaining results, and planning. Need both? You can combine them. Just remember: well-formatted output doesn’t always mean a correct decision. Test with your own data, and keep critical business rules in your application code.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Imagine a customer submits a support ticket saying they’re locked out of their account. Your AI model reads the ticket, returns perfectly formatted JSON, and routes the issue to the billing team instead of security.&lt;/p&gt;

&lt;p&gt;Here’s an example response:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;{
  "route": "billing",
  "priority": "low",
  "requires_human_review": false
}

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The format is flawless. The decision is wrong.&lt;/p&gt;

&lt;p&gt;That’s the problem in a nutshell. A model can return an answer that passes every structural check and still misunderstand the actual situation.&lt;/p&gt;

&lt;p&gt;There are two approaches worth considering:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Structured-output LLMs:&lt;/strong&gt; Constrain a model’s response to a format or schema you define.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Typed decision models like Jev AI:&lt;/strong&gt; Return clear, bounded answers, such as a category, score, or yes/no probability.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In this guide, we’ll explore how each approach works, when to use it, how to test it, and where document data fits into the process.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;A note on sources:&lt;/strong&gt; &lt;em&gt;Information about Jev AI and its maker, TypeSafe, in this article is based on their published documentation at the time of writing. Treat any performance, speed, cost, or capability claims as the provider’s reported figures until you’ve tested them with your own data. Always check the official TypeSafe &lt;a href="https://docs.typesafe.ai/introduction/quickstart" rel="noopener noreferrer"&gt;Quick Start&lt;/a&gt; and &lt;a href="https://docs.typesafe.ai/api/system-one" rel="noopener noreferrer"&gt;API Reference&lt;/a&gt; for the latest request and response formats before implementation.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  How we used to handle messy model output
&lt;/h2&gt;

&lt;p&gt;For a long time, working with LLM output involved the same repetitive process: write detailed prompt instructions, parse the JSON, validate it, and retry whenever the response broke the expected format.&lt;/p&gt;

&lt;p&gt;Then providers such as OpenAI and Anthropic introduced structured-output features. These allow developers to constrain a model’s response to a predefined schema. That’s a significant improvement, although the exact rules and capabilities vary by provider and API version.&lt;/p&gt;

&lt;p&gt;Structured output helps address several common problems:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Required fields must be present.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Field types remain consistent.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Dropdown-style values stay within the allowed options.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Tool inputs match their definitions.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Your application code spends less time handling malformed JSON.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;However, structured output doesn’t guarantee that the answer is correct. It controls the shape of the response, not the accuracy of the model’s judgment.&lt;/p&gt;

&lt;h2&gt;
  
  
  Structured outputs in 60 seconds
&lt;/h2&gt;

&lt;p&gt;A structured-output LLM is a regular text-generating model configured to return its response in a format you define.&lt;/p&gt;

&lt;p&gt;For example, you might define a TypeScript type for assessing support tickets:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;TicketAssessment&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;summary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;route&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"billing"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="s2"&gt;"technical"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="s2"&gt;"account"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;urgency&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;explanation&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This approach is useful when a task requires more than a simple decision, such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Extracting multiple fields from a contract.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Writing an explanation for a human reviewer.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Summarizing an incident before categorizing it.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Creating a step-by-step plan.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Converting a conversation into tool inputs.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Returning supporting quotes or evidence alongside an answer.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The biggest advantage is flexibility. One model can interpret instructions, summarize information, generate text, call tools, and populate structured data.&lt;/p&gt;

&lt;p&gt;The limitation is that matching a schema doesn’t prove the content is accurate or that the model’s confidence is reliable. For example, a field such as “confidence”: 0.93 is just a number generated by the model until you’ve tested how often its predictions are actually correct.&lt;/p&gt;

&lt;h2&gt;
  
  
  So, what is Jev AI?
&lt;/h2&gt;

&lt;p&gt;Jev AI is TypeSafe’s flagship &lt;a href="https://docs.typesafe.ai/concepts/system-one" rel="noopener noreferrer"&gt;System One&lt;/a&gt; model. The name reflects its focus: quick, bounded judgments rather than lengthy reasoning or essay writing.&lt;/p&gt;

&lt;p&gt;Instead of returning paragraphs, Jev AI provides clear, typed answers.&lt;/p&gt;

&lt;p&gt;You send Jev two things:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://docs.typesafe.ai/concepts/state" rel="noopener noreferrer"&gt;State&lt;/a&gt;:&lt;/strong&gt; The information it needs to evaluate, such as a support ticket, transaction, policy, or application data.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Typed questions:&lt;/strong&gt; The specific decisions you want it to make.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Jev AI returns answers through three main building blocks:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://docs.typesafe.ai/primitives/choice" rel="noopener noreferrer"&gt;Choice&lt;/a&gt;:&lt;/strong&gt; Selects one option from a list you define and provides the probability for each option, along with a confidence value.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://docs.typesafe.ai/primitives/score" rel="noopener noreferrer"&gt;Score&lt;/a&gt;:&lt;/strong&gt; Evaluates a situation against levels you define and returns a score, the probability for each level, and a confidence value.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://docs.typesafe.ai/primitives/noul" rel="noopener noreferrer"&gt;Noul&lt;/a&gt;:&lt;/strong&gt; Answers a single yes/no question and provides the probability that the answer is yes.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;There’s also an experimental &lt;strong&gt;&lt;code&gt;Box&lt;/code&gt;&lt;/strong&gt; building block for image-related tasks. However, TypeSafe identifies it as a feature that is still changing, so avoid depending on it for critical workflows until its behavior is established. Always confirm these definitions in the current documentation.&lt;/p&gt;

&lt;p&gt;The key is to break a large decision into smaller, specific questions.&lt;/p&gt;

&lt;p&gt;Instead of asking a model, “Look at this ticket and decide what to do,” you could ask:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Choice:&lt;/strong&gt; Which team should handle this ticket?&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Score:&lt;/strong&gt; How seriously is the customer affected?&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Noul:&lt;/strong&gt; Does this situation require immediate human review?&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Your application code then uses those answers alongside business rules and authoritative account data to make the final decision.&lt;/p&gt;

&lt;h2&gt;
  
  
  Jev AI vs. Structured-Output LLMs: A side-by-side comparison
&lt;/h2&gt;

&lt;p&gt;Capabilities vary by provider, model, and version. Use this comparison as a general guide rather than a guarantee about every available tool.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
  &lt;thead&gt;
    &lt;tr&gt;
      &lt;th&gt;Comparison&lt;/th&gt;
      &lt;th&gt;Jev AI&lt;/th&gt;
      &lt;th&gt;Structured-output LLM&lt;/th&gt;
    &lt;/tr&gt;
  &lt;/thead&gt;

  &lt;tbody&gt;
    &lt;tr&gt;
      &lt;td&gt;What do you send?&lt;/td&gt;
      &lt;td&gt;State and typed questions.&lt;/td&gt;
      &lt;td&gt;A prompt and a schema or tool definition.&lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;What do you get back?&lt;/td&gt;
      &lt;td&gt;
        &lt;strong&gt;&lt;code&gt;Choice&lt;/code&gt;&lt;/strong&gt;,
        &lt;strong&gt;&lt;code&gt;Score&lt;/code&gt;&lt;/strong&gt;, and
        &lt;strong&gt;&lt;code&gt;Noul&lt;/code&gt;&lt;/strong&gt; responses.
      &lt;/td&gt;
      &lt;td&gt;
        Objects, arrays, or tool inputs that match your schema.
      &lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;Can it generate prose?&lt;/td&gt;
      &lt;td&gt;Not really. That is not its primary purpose.&lt;/td&gt;
      &lt;td&gt;Yes, when the schema allows text fields.&lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;What confidence information is available?&lt;/td&gt;
      &lt;td&gt;
        &lt;strong&gt;&lt;code&gt;Choice&lt;/code&gt;&lt;/strong&gt; and
        &lt;strong&gt;&lt;code&gt;Score&lt;/code&gt;&lt;/strong&gt; provide probabilities and
        confidence. &lt;strong&gt;&lt;code&gt;Noul&lt;/code&gt;&lt;/strong&gt; provides a
        “yes” probability.
      &lt;/td&gt;
      &lt;td&gt;
        Some models provide confidence-like values, but you must test
        whether they are trustworthy.
      &lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;How is the output controlled?&lt;/td&gt;
      &lt;td&gt;It is constrained to the selected building block.&lt;/td&gt;
      &lt;td&gt;
        Some APIs enforce the schema, although the available features vary.
      &lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;Where should business rules live?&lt;/td&gt;
      &lt;td&gt;In your application code.&lt;/td&gt;
      &lt;td&gt;In your application code, not buried in prompts.&lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;What is it best suited for?&lt;/td&gt;
      &lt;td&gt;Sorting, scoring, routing, and gating.&lt;/td&gt;
      &lt;td&gt;Extracting, explaining, planning, and generating.&lt;/td&gt;
    &lt;/tr&gt;

    &lt;tr&gt;
      &lt;td&gt;What is the biggest limitation?&lt;/td&gt;
      &lt;td&gt;A valid answer can still be wrong.&lt;/td&gt;
      &lt;td&gt;A valid answer can still be wrong.&lt;/td&gt;
    &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Understanding Jev AI’s confidence values
&lt;/h2&gt;

&lt;p&gt;For &lt;strong&gt;&lt;code&gt;Choice&lt;/code&gt;&lt;/strong&gt; and &lt;strong&gt;&lt;code&gt;Score&lt;/code&gt;&lt;/strong&gt;, Jev AI provides a confidence value between 0 and 1. This value reflects how clearly the probabilities point toward one outcome.&lt;/p&gt;

&lt;p&gt;If one option clearly stands out, confidence is high. If the probabilities are close, confidence is low.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;&lt;code&gt;Noul&lt;/code&gt;&lt;/strong&gt; doesn’t provide a separate confidence field. Its output is the probability that the yes/no statement is true.&lt;/p&gt;

&lt;p&gt;In either case, test these values against your own labeled data before relying on them.&lt;/p&gt;

&lt;h2&gt;
  
  
  A bounded answer can still be wrong
&lt;/h2&gt;

&lt;p&gt;Suppose a &lt;strong&gt;&lt;code&gt;Choice&lt;/code&gt;&lt;/strong&gt; question allows only four options: billing, technical, security, and other.&lt;/p&gt;

&lt;p&gt;Jev AI can’t return a fifth option outside that list. However, it can still select billing for a ticket that describes a security problem.&lt;/p&gt;

&lt;p&gt;Staying within the allowed options doesn’t mean the selected option is correct.&lt;/p&gt;

&lt;h2&gt;
  
  
  Which one should you choose?
&lt;/h2&gt;

&lt;p&gt;Here’s a simple way to decide:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Need text generation, data extraction, or planning? Use a &lt;strong&gt;structured-output LLM&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Need a clear, bounded decision? Try &lt;strong&gt;Jev AI&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Need to generate data and make decisions about it? Use &lt;strong&gt;both together&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Have a non-negotiable rule? Keep it in &lt;strong&gt;application code&lt;/strong&gt;, not in a model.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  First, where does the data come from?
&lt;/h2&gt;

&lt;p&gt;Here’s something that’s easy to overlook: both approaches depend on the quality of the data you provide.&lt;/p&gt;

&lt;p&gt;Feed a model incomplete or incorrect information, and you can get confident, well-formatted but equally incorrect results.&lt;/p&gt;

&lt;p&gt;In most business applications, that information starts in documents. These might include PDFs, Word files, Excel spreadsheets, scanned images, or email attachments.&lt;/p&gt;

&lt;p&gt;Converting these files into clean, usable data is a document-processing task. That’s where the Syncfusion&lt;sup&gt;®&lt;/sup&gt; &lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Document SDK&lt;/a&gt; can help:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://www.syncfusion.com/document-sdk/net-pdf-library" rel="noopener noreferrer"&gt;PDF Library&lt;/a&gt;:&lt;/strong&gt; Extract text and form data from PDF documents.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://www.syncfusion.com/document-sdk/net-word-library" rel="noopener noreferrer"&gt;Word Library (DocIO)&lt;/a&gt;:&lt;/strong&gt; Extract clauses, headings, and fields from Word documents.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://www.syncfusion.com/document-sdk/net-excel-library" rel="noopener noreferrer"&gt;Excel Library (XlsIO)&lt;/a&gt;:&lt;/strong&gt; Extract line items and totals from spreadsheets.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&lt;a href="https://www.syncfusion.com/document-sdk/net-pdf-library/ocr-process" rel="noopener noreferrer"&gt;OCR processor&lt;/a&gt;:&lt;/strong&gt; Convert scanned or image-based documents into readable text.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  A typical document-to-AI pipeline
&lt;/h2&gt;

&lt;p&gt;A real-world pipeline might look like this:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Extract document content:&lt;/strong&gt; Use Syncfusion&lt;sup&gt;®&lt;/sup&gt; &lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Document SDK&lt;/a&gt; to retrieve content from the source file without involving an AI model.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Structure the data:&lt;/strong&gt; Use a structured-output LLM to organize the extracted content into fields such as names, dates, and line items.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Make bounded decisions:&lt;/strong&gt; Use Jev AI to answer specific questions about the structured data, such as which queue should handle it, how serious a mismatch is, or whether it should be escalated.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Apply application rules:&lt;/strong&gt; Use your code to enforce non-negotiable rules and validate decisions against authoritative data.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The benefit is straightforward: reliable document processing gives your AI layer cleaner input. This also helps ensure your tests measure the model’s performance rather than errors introduced during document parsing.&lt;/p&gt;

&lt;p&gt;Explore the Syncfusion &lt;a href="https://help.syncfusion.com/document-processing/introduction" rel="noopener noreferrer"&gt;Document SDK documentation&lt;/a&gt; and samples to find the formats and APIs that fit your platform.&lt;/p&gt;

&lt;h2&gt;
  
  
  A smart way to connect everything
&lt;/h2&gt;

&lt;p&gt;The golden rule is simple: keep model judgments separate from hard rules.&lt;/p&gt;

&lt;p&gt;Security, authentication, permissions, compliance, and validation rules should run independently. A model must never be allowed to override them.&lt;/p&gt;

&lt;p&gt;Here’s the workflow:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Start with a document source, such as a PDF, Word document, Excel spreadsheet, or scanned file.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Use the Syncfusion&lt;sup&gt;®&lt;/sup&gt; &lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Document SDK&lt;/a&gt; to extract the content and convert it into application data (state).&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Send that state through two separate paths:&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Path 1 – Hard rules:&lt;/strong&gt; Apply security, authentication, and compliance checks to determine the enforced outcome.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Path 2 – Model judgments:&lt;/strong&gt; Use Jev AI or a structured-output LLM, then validate the results against your checks and risk thresholds.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Automate the action when the result is sufficiently reliable and low risk.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Send uncertain or high-risk results to a human reviewer.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Example: Enforcing a Security Policy Before Routing a Ticket
&lt;/h2&gt;

&lt;p&gt;The following example illustrates how application code can enforce a mandatory security rule before using model-generated decisions.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Important:&lt;/strong&gt; &lt;em&gt;This is a conceptual example, not production-ready SDK code. It is not a real Jev integration, and TicketDecision is not a real Jev type. A production implementation would also need to handle authentication errors, timeouts, rate limits, and unexpected responses. Refer to the official TypeSafe documentation for the actual request and response formats.&lt;/em&gt;&lt;br&gt;
&lt;/p&gt;
&lt;/blockquote&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;Department&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"billing"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="s2"&gt;"technical"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="s2"&gt;"security"&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="s2"&gt;"other"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;TicketState&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;suspectedAccountCompromise&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;boolean&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;TicketDecision&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;choice&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="kt"&gt;unknown&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;confidence&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;immediateEscalation&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;noul&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;confidence&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;NextStep&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
  &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"security_review"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"mandatory_security_policy"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"human_review"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"auto_route"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;team&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;Department&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;departments&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"billing"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"technical"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"security"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"other"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;isDepartment&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;unknown&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="n"&gt;is&lt;/span&gt; &lt;span class="nc"&gt;Department&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="k"&gt;typeof&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;departments&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="k"&gt;readonly&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;inUnitInterval&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;unknown&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="n"&gt;is&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
  &lt;span class="k"&gt;typeof&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"number"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;isFinite&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;inImpactRange&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;unknown&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="n"&gt;is&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
  &lt;span class="k"&gt;typeof&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"number"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;isFinite&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;chooseNextStep&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;TicketState&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;TicketDecision&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;NextStep&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="c1"&gt;// Hard rule always wins, no matter what the model says.&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;suspectedAccountCompromise&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"security_review"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"mandatory_security_policy"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;department&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;immediateEscalationProbability&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;immediateEscalation&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;noul&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;impact&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;valid&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
    &lt;span class="n"&gt;department&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="nf"&gt;isDepartment&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choice&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="nf"&gt;inUnitInterval&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;confidence&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="nf"&gt;inUnitInterval&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;immediateEscalationProbability&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="n"&gt;impact&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="nf"&gt;inImpactRange&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt;
    &lt;span class="nf"&gt;inUnitInterval&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;confidence&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;valid&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"human_review"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"invalid_or_missing_model_output"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;sensitiveRoute&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choice&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"security"&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;score&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mf"&gt;2.5&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;uncertain&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;confidence&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mf"&gt;0.85&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;impact&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;confidence&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mf"&gt;0.8&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sensitiveRoute&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;uncertain&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;immediateEscalationProbability&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mf"&gt;0.75&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"human_review"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"risk_or_uncertainty_threshold"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"auto_route"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;team&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;department&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choice&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Understanding the impact scale
&lt;/h3&gt;

&lt;p&gt;The example uses the following impact levels:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;0:&lt;/strong&gt; Nobody notices.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;1:&lt;/strong&gt; Minor issue, with a workaround available.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;2:&lt;/strong&gt; Something important is broken for one or more users.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;3:&lt;/strong&gt; A major outage, security exposure, or similar issue.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The thresholds in the example, 2.5, 0.85, 0.80, and 0.75, are illustrative values, not recommended defaults.&lt;/p&gt;

&lt;p&gt;Choose your own thresholds using real labeled data. Consider the cost of an incorrect decision, your team’s review capacity, and how easily an action can be reversed.&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;&lt;code&gt;Noul&lt;/code&gt;&lt;/strong&gt; question in this example is: “Does this ticket need a human right away?”&lt;/p&gt;

&lt;p&gt;Define exactly what that question means before allowing its probability to influence an application action.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where can you use these approaches?
&lt;/h2&gt;

&lt;p&gt;Here are three practical scenarios where Jev AI and structured-output LLMs can work together.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Support and incident triage
&lt;/h3&gt;

&lt;p&gt;Jev AI is useful when you repeatedly need to route support tickets to teams, score their impact, or identify possible escalations.&lt;/p&gt;

&lt;p&gt;A structured-output LLM is a better fit when you also need to summarize a ticket, extract reproduction steps, or draft a response.&lt;/p&gt;

&lt;p&gt;Known account-compromise signals should always follow the mandatory security path. Jev AI can help assess less obvious cases, but it should never override that rule.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. AI-Agent guardrails
&lt;/h3&gt;

&lt;p&gt;Before an AI agent issues a refund, changes permissions, or deploys an application, a typed decision model can provide a risk signal.&lt;/p&gt;

&lt;p&gt;However, authentication, permission checks, limits, and audit logging remain the responsibility of your application.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Document processing
&lt;/h3&gt;

&lt;p&gt;Structured-output LLMs are generally better suited to extracting names, dates, clauses, and line items from documents. This can happen after a Syncfusion&lt;sup&gt;®&lt;/sup&gt; &lt;a href="https://www.syncfusion.com/document-sdk" rel="noopener noreferrer"&gt;Document SDK&lt;/a&gt; has already converted the source file into clean text.&lt;/p&gt;

&lt;p&gt;Jev AI can then evaluate the extracted information and make bounded decisions. For example, it can assign a review queue, score the seriousness of a mismatch, or assess whether enough evidence exists to automate a step.&lt;/p&gt;

&lt;p&gt;In this workflow, one model turns content into structured data, while the other makes bounded decisions about that data.&lt;/p&gt;

&lt;p&gt;Both approaches still need validation against your actual records.&lt;/p&gt;

&lt;h2&gt;
  
  
  How to test it properly (don’t skip this)
&lt;/h2&gt;

&lt;p&gt;Before using either approach in a real workflow, you need to understand how reliably it performs.&lt;/p&gt;

&lt;p&gt;First, let’s clarify one important term: &lt;strong&gt;calibration&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Calibration measures whether a model’s confidence matches reality. For example, if a model says it is 90% confident across a group of predictions, it should be correct about 90% of the time for that group to be well calibrated.&lt;/p&gt;

&lt;p&gt;If the confidence doesn’t match actual results, you shouldn’t rely on that number to make decisions.&lt;/p&gt;

&lt;h3&gt;
  
  
  Start with a labeled test set
&lt;/h3&gt;

&lt;p&gt;Choose one workflow that is easy to reverse. Before connecting the model to a real action, build a labeled test set.&lt;/p&gt;

&lt;p&gt;Include:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Normal, straightforward cases.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Ambiguous cases.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Cases with missing information.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Unusually worded or misleading cases.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Rare but high-impact scenarios.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Also, keep the following points in mind:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;For Choice:&lt;/strong&gt; Add an other or needs_review option unless your list of choices is genuinely complete.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;For Score:&lt;/strong&gt; Define each level using observable criteria.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;For Noul:&lt;/strong&gt; Ask one question at a time so the response remains clear.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  A practical testing checklist
&lt;/h3&gt;

&lt;p&gt;Once your test set is ready, follow these steps:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Ask domain experts to define the correct answers and resolve disagreements.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Build a confusion matrix to identify which categories are being mixed up.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Measure precision and recall for each category instead of relying only on overall accuracy.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Test calibration by grouping predictions and comparing their confidence with actual outcomes.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Set thresholds based on risk, review capacity, and the cost of mistakes.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Run the new approach in shadow mode, where it observes cases without taking action.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Track speed (P50, P95, and P99), cost per decision, escalation frequency, and changes in the input data over time.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  A quick example: Measuring security recall
&lt;/h3&gt;

&lt;p&gt;Suppose you test 100 confirmed security incidents.&lt;/p&gt;

&lt;p&gt;The system correctly routes 92 incidents to security and misses eight. That gives you 92% recall for security on this test set.&lt;/p&gt;

&lt;p&gt;That’s useful information, but it doesn’t tell you how often the system incorrectly routes non-security tickets to the security team.&lt;/p&gt;

&lt;p&gt;To measure that, calculate precision using the false positives across your full test set. Then validate both precision and recall using fresh holdout data before moving to production.&lt;/p&gt;

&lt;h3&gt;
  
  
  Roll out gradually and monitor results
&lt;/h3&gt;

&lt;p&gt;Once shadow testing produces acceptable results, roll out the workflow gradually. Define your rollback conditions before enabling live actions.&lt;/p&gt;

&lt;p&gt;Consider rolling back if:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Security recall drops.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Confidence calibration changes significantly.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Human review volume increases unexpectedly.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Response times become too slow.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;The cost of correcting mistakes becomes too high.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;One more recommendation: pin the model version whenever possible.&lt;/p&gt;

&lt;p&gt;If the provider uses a moving model label, record the label, date, questions, evaluation criteria, and test results. Repeat your tests whenever the provider changes the model or its behavior.&lt;/p&gt;

&lt;p&gt;Finally, treat any speed or cost figures published by TypeSafe as provider-reported results until you reproduce them using your own data, traffic, and review process.&lt;/p&gt;

&lt;h2&gt;
  
  
  Still not sure? Follow this decision flow
&lt;/h2&gt;

&lt;p&gt;Use these questions to choose the right approach:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Need generated text, data extraction, or variable-length output? Use a &lt;strong&gt;structured-output LLM&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Can the task be expressed as a choice, score, or yes/no question? Try a &lt;strong&gt;typed decision model like Jev AI&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Does the task fit neither approach? Rework it or handle it in plain application code.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Need to generate data and make decisions about it? Use &lt;strong&gt;both approaches together&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Is the requirement a non-negotiable rule involving security, authentication, or compliance? Enforce it in &lt;strong&gt;application code&lt;/strong&gt;, never in a model.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Quick glossary
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;System One model:&lt;/strong&gt; A model designed for fast, bounded decisions rather than deep reasoning.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Noul:&lt;/strong&gt; A Jev AI building block that returns the probability that a yes/no statement is true.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Calibration:&lt;/strong&gt; A measure of whether a model’s confidence matches how often it is correct.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Constrained decoding:&lt;/strong&gt; A technique that constrains a model’s output to a defined structure.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Semantic correctness:&lt;/strong&gt; Whether an answer is actually correct, rather than simply well-formatted.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: What can I feed Jev AI?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;According to TypeSafe’s documentation, Jev AI accepts text in the form of a string, JSON object, or array of text values. It doesn’t directly accept audio or video.&lt;/p&gt;

&lt;p&gt;Convert those inputs into text first. A document SDK can help process supported files, but you should still validate the converted content before relying on the resulting decision.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Can I use Jev AI for regulated decisions?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Jev AI can assist with regulated workflows, but a probability alone may not satisfy requirements involving explanations, fairness, or auditing.&lt;/p&gt;

&lt;p&gt;Keep records of the input, questions, model version, probabilities, final outcome, and any human overrides. Obtain legal and compliance approval before automating high-impact decisions.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: What if Jev AI needs information that isn’t in the data I sent?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;A well-structured answer doesn’t prove that the input data is complete.&lt;/p&gt;

&lt;p&gt;Retrieve authoritative information before making the decision, identify missing values clearly, and provide an unknown or human-review path wherever missing information could affect the outcome.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: If I use Jev AI, do I still need structured-output LLMs?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Usually, yes.&lt;/p&gt;

&lt;p&gt;Many real-world implementations use a structured-output LLM, together with a document SDK, to prepare the data. A typed decision model can then evaluate that data.&lt;/p&gt;

&lt;p&gt;They work better as complementary tools than as competing alternatives.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrapping up
&lt;/h2&gt;

&lt;p&gt;Think of Jev AI as a specialist for small, clearly defined decisions such as sorting, scoring, and routing. Structured-output LLMs are generalists that handle tasks such as extracting information, explaining results, planning, and generating text.&lt;/p&gt;

&lt;p&gt;Many applications can benefit from using both. Keep non-negotiable rules in your application code, and use a reliable document-processing layer to provide clean input data.&lt;/p&gt;

&lt;p&gt;Start with one workflow that you can easily reverse. Evaluate accuracy, precision and recall for each category, calibration, speed, escalation rate, and cost using real data.&lt;/p&gt;

&lt;p&gt;Only after those results meet your requirements should you allow a model to influence a live action.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where to go next
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Review the current Jev AI building blocks and supported formats in the official TypeSafe Quick Start and API Reference.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Explore the Syncfusion &lt;a href="https://help.syncfusion.com/document-processing/introduction" rel="noopener noreferrer"&gt;Document SDK documentation&lt;/a&gt; to learn how to convert PDFs, Word documents, Excel spreadsheets, and scanned files into usable data for your AI workflows.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Try an extract-then-decide pipeline using one of your own documents.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Start a &lt;a href="https://www.syncfusion.com/downloads/document-sdk?tag=es-seo-document-sdk-download-trial" rel="noopener noreferrer"&gt;free Syncfusion trial&lt;/a&gt; and evaluate the Document SDKs in your application.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/multi-agent-ai-systems-code-governance" rel="noopener noreferrer"&gt;Multi-Agent AI Systems: A Smarter Way to Detect and Manage Technical Debt&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-coding-assistant-agent-skills-mcp" rel="noopener noreferrer"&gt;Build Faster with Syncfusion AI Coding Assistant Tools: Agent Skills and MCP Servers&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-guardrails-coding-agents" rel="noopener noreferrer"&gt;Why AI Coding Agents Go Off Scope and How Guardrails Fix It&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-ide-evaluation-guide" rel="noopener noreferrer"&gt;How to Evaluate an AI IDE in 2026: Features That Matter for Development Teams&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>agenticide</category>
      <category>ai</category>
      <category>developer</category>
      <category>productivity</category>
    </item>
    <item>
      <title>How to Compare PDF Documents in JavaScript Using Syncfusion PDF Viewer</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Fri, 30 Oct 2026 21:30:00 +0000</pubDate>
      <link>https://dev.to/syncfusion/how-to-compare-pdf-documents-in-javascript-using-syncfusion-pdf-viewer-22d8</link>
      <guid>https://dev.to/syncfusion/how-to-compare-pdf-documents-in-javascript-using-syncfusion-pdf-viewer-22d8</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Manually comparing PDF versions can be slow and error-prone. This blog shows how to use the JavaScript PDF Viewer to automatically detect content added, deleted, or modified between PDF revisions. Learn how to implement side-by-side comparison with the built-in PDF Comparer and build custom comparison experiences using semantic comparison APIs. These capabilities help reduce review effort, improve accuracy, and simplify document review processes.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;When a PDF document is updated, how do you quickly find what has changed from the previous version?&lt;/p&gt;

&lt;p&gt;Reviewing both versions page by page can be time-consuming, especially when working with lengthy documents. Important changes can easily go unnoticed, making the review process more difficult.&lt;/p&gt;

&lt;p&gt;The Syncfusion &lt;a href="https://www.syncfusion.com/pdf-viewer-sdk/javascript-pdf-viewer" rel="noopener noreferrer"&gt;JavaScript PDF Viewer&lt;/a&gt; in the &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;2026 Volume 3 release&lt;/a&gt; simplifies &lt;a href="https://www.syncfusion.com/pdf-viewer-sdk/compare-documents" rel="noopener noreferrer"&gt;PDF document comparison&lt;/a&gt;. Developers can use the built-in &lt;strong&gt;&lt;code&gt;PdfComparer&lt;/code&gt;&lt;/strong&gt; component to compare documents side by side or use the &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; API to build custom comparison experiences within their applications.&lt;/p&gt;

&lt;p&gt;Let’s explore both approaches and see how to implement them.&lt;/p&gt;

&lt;h2&gt;
  
  
  What does PDF document comparison do?
&lt;/h2&gt;

&lt;p&gt;PDF document comparison identifies text differences between two versions of a document. It helps reviewers find:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Added text:&lt;/strong&gt; Content introduced in the modified document.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deleted text:&lt;/strong&gt; Content present in the original document but removed from the updated version.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Modified text:&lt;/strong&gt; Existing content that has changed.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For example, a contract review application can compare two revisions and direct reviewers to updated clauses instead of asking them to reread the entire document.&lt;/p&gt;

&lt;p&gt;Semantic comparison focuses on text changes rather than every visual difference in a PDF’s layout, images, or formatting.&lt;/p&gt;

&lt;h2&gt;
  
  
  Compare PDF versions using the built-in PDF Comparer
&lt;/h2&gt;

&lt;p&gt;If your application needs a ready-made comparison interface, use the &lt;strong&gt;&lt;code&gt;PdfComparer&lt;/code&gt;&lt;/strong&gt; component. It displays the original and modified documents side by side, with a differences panel for navigating detected changes.&lt;/p&gt;

&lt;p&gt;The interface includes three areas:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
    &lt;colgroup&gt;
        &lt;col&gt;
        &lt;col&gt;
    &lt;/colgroup&gt;
    &lt;thead&gt;
        &lt;tr&gt;
            &lt;th&gt;Area&lt;/th&gt;
            &lt;th&gt;Purpose&lt;/th&gt;
        &lt;/tr&gt;
    &lt;/thead&gt;
    &lt;tbody&gt;
        &lt;tr&gt;
            &lt;td&gt;Original document&lt;/td&gt;
            &lt;td&gt;Displays the baseline PDF.&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Modified document&lt;/td&gt;
            &lt;td&gt;Displays the updated PDF.&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Differences panel&lt;/td&gt;
            &lt;td&gt;Lists detected differences and helps users navigate to them.&lt;/td&gt;
        &lt;/tr&gt;
    &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Users can select a difference in the panel to jump to the corresponding content in both documents. This makes the built-in comparer a practical choice when you want to add PDF comparison without building the entire interface yourself.&lt;/p&gt;

&lt;h2&gt;
  
  
  Get started with PDF comparison
&lt;/h2&gt;

&lt;p&gt;The following example initializes the PDF Comparer with two sample documents.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Step 1: Add the Syncfusion resources&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Create an HTML file and include the Syncfusion Essential JS 2 stylesheet and JavaScript bundle.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Step 2: Initialize the comparer&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Create a container for the comparer, provide the paths to the original and modified PDFs, and specify the PDF Viewer resource URL.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="cp"&gt;&amp;lt;!DOCTYPE html&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="na"&gt;lang&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"en"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;head&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;meta&lt;/span&gt; &lt;span class="na"&gt;charset&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"utf-8"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;title&amp;gt;&lt;/span&gt;PDF Document Comparison&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt;
    &lt;span class="na"&gt;href&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/fluent2.css"&lt;/span&gt;
    &lt;span class="na"&gt;rel&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"stylesheet"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;script&lt;/span&gt;
    &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2.min.js"&lt;/span&gt;
    &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text/javascript"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/script&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;style&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;html&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nt"&gt;body&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;margin&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;padding&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nn"&gt;#comparer-container&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/style&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/head&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;body&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"comparer-container"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/div&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;script&amp;gt;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;comparer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfComparer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;originalDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/original-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;modifiedDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/modified-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="s2"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2-pdfviewer-lib"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="n"&gt;comparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#comparer-container"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/script&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/body&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/html&amp;gt;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Replace the sample PDF URLs with the documents your application needs to compare. Make sure the documents are accessible to the browser and that the resource URL matches the Syncfusion version used by your project.&lt;/p&gt;

&lt;p&gt;Once the documents load, the comparer analyzes their text and displays the detected differences.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fuy3g15v1fv9gnjhf7dor.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fuy3g15v1fv9gnjhf7dor.png" alt="Built-in PDF Comparer interface showing the original and modified documents"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Built-in PDF Comparer&lt;/em&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  Customize the comparison highlights
&lt;/h3&gt;

&lt;p&gt;Different applications may need different visual indicators for document changes. For example, a contract review tool might use one color for deleted text and another for added text.&lt;/p&gt;

&lt;p&gt;Use the &lt;a href="https://ej2.syncfusion.com/javascript/documentation/api/pdfcomparer/index-default#comparisonoptions" rel="noopener noreferrer"&gt;comparisonOptions&lt;/a&gt; property to configure highlight colors, opacity, and visibility.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;comparisonOptions&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;beforeColor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"#F17720"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;afterColor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"#0474BA"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;beforeColorOpacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;afterColorOpacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;enableHighlights&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;comparer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfComparer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;originalDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/original-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;modifiedDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/modified-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2-pdfviewer-lib"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;comparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#comparer-container"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In this example, deleted content in the original document is highlighted in orange, while added content in the modified document is highlighted in blue. The opacity settings control how strongly the highlights appear.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flag777o2akn2288fh3mk.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flag777o2akn2288fh3mk.gif" alt="Custom text comparison with different highlight colors"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Custom text comparison&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;You can also hide the differences panel when users need more space to read the documents. Set &lt;a href="https://ej2.syncfusion.com/javascript/documentation/api/pdfcomparer/index-default#enabledifferencepanel" rel="noopener noreferrer"&gt;enableDifferencePanel&lt;/a&gt; to &lt;strong&gt;&lt;code&gt;false&lt;/code&gt;&lt;/strong&gt; :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight jsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;comparer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfComparer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;originalDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/original-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;modifiedDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/modified-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2-pdfviewer-lib"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;enableDifferencePanel&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;comparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#comparer-container"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The inline highlights remain available, while the side panel is hidden.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fgltuf9kfui35k3o2zdt2.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fgltuf9kfui35k3o2zdt2.png" alt="PDF comparison with the differences panel hidden"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Hide the differences panel&lt;/em&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  Keep both documents synchronized
&lt;/h3&gt;

&lt;p&gt;When reviewers scroll through one document, they often need to find the same section in the other. Synchronized navigation reduces this extra work by keeping scrolling and zooming aligned.&lt;/p&gt;

&lt;p&gt;Enable it with the &lt;strong&gt;&lt;code&gt;enableSyncScrolling&lt;/code&gt;&lt;/strong&gt; property:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;comparer&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfComparer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;originalDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/original-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;modifiedDocumentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/modified-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s2"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2-pdfviewer-lib"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;comparisonOptions&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;enableSyncScrolling&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;comparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#comparer-container"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This setting is useful when reviewers need to move between corresponding sections in long documents.&lt;/p&gt;

&lt;p&gt;For additional configuration options, see the &lt;a href="https://help.syncfusion.com/document-processing/pdf/pdf-viewer/javascript-es6/semantic-text-comparison/overview" rel="noopener noreferrer"&gt;PDF Comparer documentation&lt;/a&gt; and explore the &lt;a href="https://document.syncfusion.com/demos/pdf-viewer/javascript/#/bootstrap5/pdfviewer/semantic-text-comparison.html" rel="noopener noreferrer"&gt;live demo&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build a custom PDF comparison interface
&lt;/h2&gt;

&lt;p&gt;The built-in comparer is a good fit for applications that need a ready-made review experience. However, some applications require a different layout or need to integrate comparison results into an existing workflow.&lt;/p&gt;

&lt;p&gt;For example, you might want to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Display the documents inside a custom dashboard or modal.&lt;/li&gt;
&lt;li&gt;Keep the PDF Viewer’s existing tools and custom toolbar.&lt;/li&gt;
&lt;li&gt;Build your own differences panel or change log.&lt;/li&gt;
&lt;li&gt;Use detected differences in an approval workflow.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In these cases, initialize two &lt;strong&gt;&lt;code&gt;PdfViewer&lt;/code&gt;&lt;/strong&gt; instances and compare them using the &lt;a href="https://ej2.syncfusion.com/javascript/documentation/api/pdfviewer/index-default#semantictextcompare" rel="noopener noreferrer"&gt;semanticTextCompare()&lt;/a&gt; API.&lt;/p&gt;

&lt;h3&gt;
  
  
  How custom comparison works
&lt;/h3&gt;

&lt;p&gt;The implementation follows four steps:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Load the original PDF into the first viewer.&lt;/li&gt;
&lt;li&gt;Load the modified PDF into the second viewer.&lt;/li&gt;
&lt;li&gt;Call &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; to compare their text.&lt;/li&gt;
&lt;li&gt;Use the returned results to display differences in your own interface.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;This approach gives you more control over the layout and how comparison results are presented. In return, your application must manage the viewer layout, loading state, navigation, and comparison controls.&lt;/p&gt;

&lt;h3&gt;
  
  
  Implement semantic comparison
&lt;/h3&gt;

&lt;p&gt;The following example creates two PDF Viewer instances, synchronizes their navigation, and adds controls to compare documents and clear comparison results.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="cp"&gt;&amp;lt;!DOCTYPE html&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="na"&gt;lang&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"en"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;head&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;meta&lt;/span&gt; &lt;span class="na"&gt;charset&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"utf-8"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;title&amp;gt;&lt;/span&gt;Custom PDF Comparison&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt;
    &lt;span class="na"&gt;href&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/fluent2.css"&lt;/span&gt;
    &lt;span class="na"&gt;rel&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"stylesheet"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;script&lt;/span&gt;
    &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2.min.js"&lt;/span&gt;
    &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text/javascript"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/script&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;style&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;html&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nt"&gt;body&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;margin&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nn"&gt;#controls&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;display&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;flex&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;gap&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;8px&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;padding&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;8px&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nn"&gt;#container&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;display&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;flex&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;calc&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;100vh&lt;/span&gt; &lt;span class="n"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;50px&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nn"&gt;#pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nn"&gt;#pdfViewer2&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;50&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="nl"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="kt"&gt;%&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/style&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/head&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;body&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"controls"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;button&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"compareButton"&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt; &lt;span class="na"&gt;disabled&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
      Compare documents
    &lt;span class="nt"&gt;&amp;lt;/button&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;button&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"syncButton"&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
      Disable sync
    &lt;span class="nt"&gt;&amp;lt;/button&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;button&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"clearButton"&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt; &lt;span class="na"&gt;disabled&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
      Clear comparison
    &lt;span class="nt"&gt;&amp;lt;/button&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/div&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"container"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"pdfViewer1"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/div&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"pdfViewer2"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/div&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/div&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;script&amp;gt;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;resourceUrl&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
      &lt;span class="s2"&gt;"https://cdn.syncfusion.com/ej2/34.2.4/dist/ej2-pdfviewer-lib"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;pdfViewer1&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfViewer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;documentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/original-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;resourceUrl&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;pdfViewer2&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="n"&gt;ej&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pdfviewer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;PdfViewer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;documentPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="s2"&gt;"https://cdn.syncfusion.com/content/pdf/modified-document.pdf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;resourceUrl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;resourceUrl&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;loadedCount&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;comparisonCreated&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;onDocumentLoaded&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;loadedCount&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

      &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;loadedCount&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;syncViewers&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getElementById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"compareButton"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;disabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;documentLoad&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;onDocumentLoaded&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;documentLoad&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;onDocumentLoaded&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getElementById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"compareButton"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"click"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;loadedCount&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;

        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;options&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="n"&gt;beforeColor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"#F17720"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;afterColor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"#0474BA"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;beforeColorOpacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;afterColorOpacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;enableHighlights&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;semanticTextCompare&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;options&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Comparison results:"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="n"&gt;comparisonCreated&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getElementById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"clearButton"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;disabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getElementById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"syncButton"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"click"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;syncViewers&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="kc"&gt;this&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;textContent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;synchronizationEnabled&lt;/span&gt;
          &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="s2"&gt;"Disable sync"&lt;/span&gt;
          &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Enable sync"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getElementById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"clearButton"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"click"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;comparisonCreated&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;

        &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;removeSemanticTextCompare&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="n"&gt;comparisonCreated&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="kc"&gt;this&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;disabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="n"&gt;pdfViewer1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#pdfViewer1"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;pdfViewer2&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;appendTo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"#pdfViewer2"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/script&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/body&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/html&amp;gt;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The example uses the same sample documents as the built-in comparer. Replace them with your own document URLs when integrating the code into an application.&lt;/p&gt;

&lt;p&gt;The Compare button calls &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; and logs the returned result to the browser console. The result contains structured information about detected differences, organized by document and page. You can use this data to build a custom differences panel, change log, or approval interface.&lt;/p&gt;

&lt;p&gt;The synchronization button enables or disables synchronized navigation. The Clear comparison button calls &lt;strong&gt;&lt;code&gt;removeSemanticTextCompare()&lt;/code&gt;&lt;/strong&gt; to remove the comparison results while preserving user-created annotations.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcmqn00aehz9drmgy4ywi.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcmqn00aehz9drmgy4ywi.gif" alt="Show or hide PDF difference highlights"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Show or hide difference highlights&lt;/em&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Use the comparison results in your application
&lt;/h3&gt;

&lt;p&gt;The &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; method returns a structured result that includes:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;originalDocumentAnnotations&lt;/code&gt;&lt;/strong&gt; : detected differences associated with the original document.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;modifiedDocumentAnnotations&lt;/code&gt;&lt;/strong&gt; : detected differences associated with the modified document.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;totalTextDiffCount&lt;/code&gt;&lt;/strong&gt; : the total number of unique text differences detected.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These results allow you to build a custom experience instead of relying on the built-in differences panel. For example, you could list changes by page, display a summary of the differences, or connect the results to an approval process.&lt;/p&gt;

&lt;p&gt;Note that annotation text may also appear as added content in comparison results. If your workflow needs to clear the comparison results while keeping user-created annotations, use &lt;a href="https://ej2.syncfusion.com/javascript/documentation/api/pdfviewer/index-default#removesemantictextcompare" rel="noopener noreferrer"&gt;removeSemanticTextCompare()&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;For a complete working reference, see the &lt;a href="https://github.com/SyncfusionExamples/javascript-pdf-viewer-examples/tree/master/Semantic%20Text%20Comparison/Programmatically%20get%20differences" rel="noopener noreferrer"&gt;GitHub example for custom semantic PDF comparison&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Which comparison approach should you use?
&lt;/h2&gt;

&lt;p&gt;Choose the built-in comparer when you want a ready-made side-by-side interface with a differences panel. Choose the custom approach when your application needs a different layout, custom navigation, or direct access to comparison results.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
    &lt;colgroup&gt;
        &lt;col&gt;
        &lt;col&gt;
    &lt;/colgroup&gt;
    &lt;thead&gt;
        &lt;tr&gt;
            &lt;th&gt;Requirement&lt;/th&gt;
            &lt;th&gt;Recommended approach&lt;/th&gt;
        &lt;/tr&gt;
    &lt;/thead&gt;
    &lt;tbody&gt;
        &lt;tr&gt;
            &lt;td&gt;Display two PDFs with a built-in differences panel&lt;/td&gt;
            &lt;td&gt;&lt;code&gt;PdfComparer&lt;/code&gt;&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Customize highlight colors and opacity&lt;/td&gt;
            &lt;td&gt;Either approach&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Synchronize document navigation&lt;/td&gt;
            &lt;td&gt;Either approach&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Build a custom differences panel&lt;/td&gt;
            &lt;td&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Integrate comparison results into an existing workflow&lt;/td&gt;
            &lt;td&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/td&gt;
        &lt;/tr&gt;
        &lt;tr&gt;
            &lt;td&gt;Control the complete viewer layout&lt;/td&gt;
            &lt;td&gt;Two &lt;code&gt;PdfViewer&lt;/code&gt; instances&lt;/td&gt;
        &lt;/tr&gt;
    &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: When should I use the built-in PDF Comparer instead of a custom implementation?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Use &lt;strong&gt;&lt;code&gt;PdfComparer&lt;/code&gt;&lt;/strong&gt; when you need a ready-made side-by-side interface with a differences panel. Choose the custom approach when you need full control over the layout, navigation, or presentation of comparison results.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2:Can I create my own differences panel?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. The &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; API returns structured comparison results that you can use to create a custom panel, change log, or review workflow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Can I customize comparison highlight colors?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Configure &lt;strong&gt;&lt;code&gt;beforeColor&lt;/code&gt;&lt;/strong&gt; , &lt;strong&gt;&lt;code&gt;afterColor&lt;/code&gt;&lt;/strong&gt; , &lt;strong&gt;&lt;code&gt;beforeColorOpacity&lt;/code&gt;&lt;/strong&gt; , and &lt;strong&gt;&lt;code&gt;afterColorOpacity&lt;/code&gt;&lt;/strong&gt; through the comparison options.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Will clearing comparison results remove user-created annotations?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;&lt;code&gt;removeSemanticTextCompare()&lt;/code&gt;&lt;/strong&gt; API is intended to remove semantic comparison results while preserving other user-created annotations. Test this behavior with your target Syncfusion version and annotation workflow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q6: Does PDF comparison detect every visual change?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;No. Semantic comparison focuses on text differences. Changes to layout, images, or other visual elements may not be represented as text differences.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Comparing PDF versions does not have to mean checking every page manually. Syncfusion &lt;a href="https://help.syncfusion.com/document-processing/pdf/pdf-viewer/javascript-es6/overview" rel="noopener noreferrer"&gt;JavaScript PDF Viewer&lt;/a&gt; provides two ways to build a better review experience: use &lt;strong&gt;&lt;code&gt;PdfComparer&lt;/code&gt;&lt;/strong&gt; for a ready-made interface or use &lt;strong&gt;&lt;code&gt;semanticTextCompare()&lt;/code&gt;&lt;/strong&gt; to create a custom workflow around the results.&lt;/p&gt;

&lt;p&gt;Explore the &lt;a href="https://help.syncfusion.com/document-processing/pdf/pdf-viewer/javascript-es6/semantic-text-comparison/overview" rel="noopener noreferrer"&gt;documentation&lt;/a&gt; and &lt;a href="https://document.syncfusion.com/demos/pdf-viewer/javascript/#/bootstrap5/pdfviewer/semantic-text-comparison.html" rel="noopener noreferrer"&gt;live demos&lt;/a&gt; to see the feature in action. Existing Syncfusion customers can download the latest release from the License &amp;amp; Downloads page, while new users can get started with a 30-day free trial.&lt;/p&gt;

&lt;p&gt;For questions or feedback, visit the Syncfusion &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/pdf-search-in-react-pdf-viewer" rel="noopener noreferrer"&gt;Why PDF Search Fails in React PDF Viewers and How to Fix It&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/loan-document-workflow-react-pdfviewer" rel="noopener noreferrer"&gt;How to Build a Loan Document Workflow Using an Embedded React PDF Viewer&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/role-based-lms-assignment-workflow-react-pdf-viewer" rel="noopener noreferrer"&gt;Build a Role-Based LMS with In-Document Learning Using a React PDF Viewer&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/custom-toolbar-in-react-pdf-viewer" rel="noopener noreferrer"&gt;How to Build a Custom Toolbar in a React PDF Viewer?&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>javascript</category>
      <category>web</category>
      <category>pdfviewer</category>
      <category>documentprocessing</category>
    </item>
    <item>
      <title>How to Build Interactive Blazor Sunburst Charts for Hierarchical Data</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Thu, 29 Oct 2026 11:00:00 +0000</pubDate>
      <link>https://dev.to/syncfusion/how-to-build-interactive-blazor-sunburst-charts-for-hierarchical-data-1857</link>
      <guid>https://dev.to/syncfusion/how-to-build-interactive-blazor-sunburst-charts-for-hierarchical-data-1857</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Want to make hierarchical data easier to explore and understand? Discover how the new Blazor Sunburst Chart in 2026 Volume 3 helps users navigate complex hierarchies, uncover insights faster, and explore data through intuitive drill-down interactions. This guide covers data modeling, validation, and production-ready implementation techniques.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Have you ever needed to visualize organizational structures, product catalogs, budget allocations, or geographical data and realized that traditional charts only tell part of the story?&lt;/p&gt;

&lt;p&gt;Bar, pie, and doughnut charts can help compare values, but they often struggle to show how those values relate within a hierarchy. As data grows more complex, understanding both the structure and the contribution of each level becomes increasingly difficult.&lt;/p&gt;

&lt;p&gt;To address this challenge, Syncfusion® introduced the &lt;a href="https://www.syncfusion.com/blazor-components/blazor-sunburst-chart" rel="noopener noreferrer"&gt;Blazor Sunburst Chart&lt;/a&gt; in the &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt; release. This powerful visualization represents hierarchical relationships as concentric rings, enabling users to understand both hierarchy and proportion in a single view. Users can also drill into specific branches to explore deeper levels without losing context.&lt;/p&gt;

&lt;p&gt;In this guide, you’ll learn how to build an interactive Sunburst chart in Blazor, structure hierarchical data correctly, enable drill-down interactions, validate hierarchy integrity, and prepare your implementation for production environments.&lt;/p&gt;

&lt;h2&gt;
  
  
  When should you use a sunburst chart?
&lt;/h2&gt;

&lt;p&gt;Sunburst charts are most effective when understanding hierarchy is just as important as comparing values. They use concentric rings to visualize parent-child relationships, with the center representing top-level categories and outer rings showing deeper levels. Segment size reflects the associated value, making it easy to identify major contributors while exploring hierarchical structures.&lt;/p&gt;

&lt;p&gt;This makes sunburst charts ideal for scenarios such as retail sales analysis (categories, subcategories, and products), organizational structures, geographical reporting, budget tracking, IT infrastructure monitoring, and website analytics.&lt;/p&gt;

&lt;p&gt;For example, in a retail dashboard, a sunburst chart can simultaneously reveal which product categories generate the most revenue, which subcategories contribute the most within each category, and which regions perform best within a market, providing both hierarchical context and proportional insights in a single visualization.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build your first Blazor Sunburst Chart
&lt;/h2&gt;

&lt;p&gt;Once your Syncfusion Blazor package is installed, creating a basic Sunburst chart requires only a few configuration properties.&lt;/p&gt;

&lt;p&gt;The chart uses a flat hierarchy model in which each data record references its parent through an identifier. This approach works particularly well because APIs, databases, and reporting services generally return data in this format already.&lt;/p&gt;

&lt;p&gt;The result is a structure that is easy to validate, easy to debug, and easy to bind directly to the chart component.&lt;/p&gt;

&lt;h3&gt;
  
  
  Prerequisites and environment
&lt;/h3&gt;

&lt;p&gt;This guide was validated using the following environment. Code and configuration patterns may vary if you are using different versions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://dotnet.microsoft.com/en-us/download/dotnet/10.0" rel="noopener noreferrer"&gt;.NET 10&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://visualstudio.microsoft.com/downloads/" rel="noopener noreferrer"&gt;Visual Studio 2026&lt;/a&gt; or &lt;a href="https://code.visualstudio.com/download" rel="noopener noreferrer"&gt;VS Code&lt;/a&gt; with &lt;a href="https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit" rel="noopener noreferrer"&gt;C# DevKit&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Blazor Web App (.NET 10) template.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://www.nuget.org/packages/Syncfusion.Blazor.Charts" rel="noopener noreferrer"&gt;Syncfusion.Blazor.Charts&lt;/a&gt; NuGet package &lt;strong&gt;v35.1.37&lt;/strong&gt; or later.&lt;/li&gt;
&lt;li&gt;Modern browser (Chrome, Firefox, Edge).&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Step 1: Install the package
&lt;/h3&gt;

&lt;p&gt;First, open the command line and run the following command:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;dotnet add package Syncfusion.Blazor.Charts
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This installs the Syncfusion Charts library, which includes the &lt;strong&gt;&lt;code&gt;SfSunburstChart&lt;/code&gt;&lt;/strong&gt; component and all dependencies. The command automatically updates your project file with the correct version constraint.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 2: Register Syncfusion services
&lt;/h3&gt;

&lt;p&gt;Open the &lt;strong&gt;&lt;code&gt;Program.cs&lt;/code&gt;&lt;/strong&gt; file and register the Syncfusion services:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Blazor&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// ...&lt;/span&gt;
&lt;span class="n"&gt;builder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Services&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddSyncfusionBlazor&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This single line registers the Syncfusion Blazor services with the dependency injection container. For Blazor Web App projects, register Syncfusion services in the &lt;strong&gt;&lt;code&gt;Program.cs&lt;/code&gt;&lt;/strong&gt; file of every project that hosts interactive components. If your application uses both Server and Client projects, ensure &lt;strong&gt;&lt;code&gt;AddSyncfusionBlazor()&lt;/code&gt;&lt;/strong&gt; is registered in each applicable &lt;strong&gt;&lt;code&gt;Program.cs&lt;/code&gt;&lt;/strong&gt; file.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 3: Import required namespaces
&lt;/h3&gt;

&lt;p&gt;In the &lt;strong&gt;&lt;code&gt;_Imports.razor&lt;/code&gt;&lt;/strong&gt; file, add the following namespaces:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nd"&gt;@using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Blazor&lt;/span&gt;
&lt;span class="nd"&gt;@using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Blazor&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Charts&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;These &lt;strong&gt;&lt;code&gt;using&lt;/code&gt;&lt;/strong&gt; statements expose the &lt;strong&gt;&lt;code&gt;SfSunburstChart&lt;/code&gt;&lt;/strong&gt; component and configuration types to all &lt;strong&gt;&lt;code&gt;.razor&lt;/code&gt;&lt;/strong&gt; files in your project.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 4: Add Syncfusion Script reference
&lt;/h3&gt;

&lt;p&gt;For Blazor Server and Blazor Web App projects, include the Syncfusion JavaScript library in your layout file (e.g., &lt;strong&gt;&lt;code&gt;App.razor&lt;/code&gt;&lt;/strong&gt; or a shared layout component). Add this line before the closing &lt;strong&gt;&lt;code&gt;&amp;lt;/body&amp;gt;&lt;/code&gt;&lt;/strong&gt; tag:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;script&lt;/span&gt; &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://cdn.syncfusion.com/blazor/35.1.37/sf-sunburst-chart.min.js"&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text/javascript"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/script&amp;gt;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For Blazor WebAssembly standalone projects, add this script reference to &lt;strong&gt;&lt;code&gt;index.html&lt;/code&gt;&lt;/strong&gt; instead. This script initializes JavaScript interop required for the component’s interactive features (drill-down, tooltips, etc.).&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 5: Visualize hierarchical data with interactive drill-down
&lt;/h3&gt;

&lt;p&gt;Create a new component (for example, &lt;strong&gt;&lt;code&gt;SunburstChart.razor&lt;/code&gt;&lt;/strong&gt; ) inside the &lt;strong&gt;&lt;code&gt;Components/Pages&lt;/code&gt;&lt;/strong&gt; folder of your Blazor project and add the following code to the component. This example demonstrates interactive drill-down using hierarchical population data, allowing users to navigate seamlessly from continents to countries and explore population distribution at each level within a Sunburst chart.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nd"&gt;@page&lt;/span&gt; &lt;span class="s2"&gt;"/sunburst-chart"&lt;/span&gt;
&lt;span class="nd"&gt;@using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Blazor&lt;/span&gt;
&lt;span class="nd"&gt;@using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Blazor&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Charts&lt;/span&gt;
&lt;span class="nd"&gt;@rendermode&lt;/span&gt; &lt;span class="nc"&gt;InteractiveServer&lt;/span&gt;

&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SfSunburstChart&lt;/span&gt; &lt;span class="nc"&gt;TItem&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"PopulationNode"&lt;/span&gt;
                 &lt;span class="nc"&gt;DataSource&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"@PopulationData"&lt;/span&gt;
                 &lt;span class="nc"&gt;IdMemberPath&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Id"&lt;/span&gt;
                 &lt;span class="nc"&gt;ParentIdMemberPath&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"ParentId"&lt;/span&gt;
                 &lt;span class="nc"&gt;LabelMemberPath&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Name"&lt;/span&gt;
                 &lt;span class="nc"&gt;ValueMemberPath&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Population"&lt;/span&gt;
                 &lt;span class="nc"&gt;Title&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"World Population Distribution (2025)"&lt;/span&gt;
                 &lt;span class="nc"&gt;Subtitle&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Population estimates in millions"&lt;/span&gt;
                 &lt;span class="nc"&gt;Width&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"100%"&lt;/span&gt; &lt;span class="nc"&gt;Height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"600px"&lt;/span&gt; &lt;span class="nc"&gt;Theme&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Theme.Fluent2"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;

    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstTitleSettings&lt;/span&gt; &lt;span class="nc"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"18px"&lt;/span&gt; &lt;span class="nc"&gt;FontWeight&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"600"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstSubtitleSettings&lt;/span&gt; &lt;span class="nc"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"13px"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstDataLabelSettings&lt;/span&gt; &lt;span class="nc"&gt;Visible&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="nc"&gt;RotationMode&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"SunburstLabelRotationMode.Angle"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstTooltipSettings&lt;/span&gt; &lt;span class="nc"&gt;Enable&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt;
                             &lt;span class="nc"&gt;HeaderText&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Population Details"&lt;/span&gt;
                             &lt;span class="nc"&gt;Format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;b&amp;gt;${point.label}&amp;lt;/b&amp;gt;&amp;lt;br/&amp;gt;Population: ${point.value} Million"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstLegendSettings&lt;/span&gt; &lt;span class="nc"&gt;Visible&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="nc"&gt;Position&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"SunburstLegendPosition.Bottom"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SunburstDrillSettings&lt;/span&gt; &lt;span class="nc"&gt;Enable&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;SfSunburstChart&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;

&lt;span class="nd"&gt;@code&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;PopulationNode&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Empty&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Empty&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Empty&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;double&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;private&lt;/span&gt; &lt;span class="kt"&gt;List&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PopulationNode&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;PopulationData&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="c1"&gt;// Root level (continents)&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Asia"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"northamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"North America"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"southamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"South America"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"africa"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Africa"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"europe"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Europe"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="c1"&gt;// Asia&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"india"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"India"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;1463.9&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"china"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"China"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;1406.6&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"indonesia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Indonesia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;285.7&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"japan"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Japan"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;123.4&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="c1"&gt;// North America&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"usa"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"northamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"United States"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;341.8&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"mexico"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"northamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Mexico"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;131.9&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="c1"&gt;// South America&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"brazil"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"southamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Brazil"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;212.8&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"argentina"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"southamerica"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Argentina"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;45.9&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="c1"&gt;// Africa&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"nigeria"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"africa"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Nigeria"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;237.5&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"egypt"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"africa"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Egypt"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;118.4&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="c1"&gt;// Europe&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"germany"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"europe"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Germany"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;83.5&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uk"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"europe"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"United Kingdom"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;69.5&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The sample uses approximate 2025 population estimates for a subset of countries. Values are set only on the country nodes, and the chart calculates continent totals.&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;&lt;code&gt;IdMemberPath&lt;/code&gt;&lt;/strong&gt; and &lt;strong&gt;&lt;code&gt;ParentIdMemberPath&lt;/code&gt;&lt;/strong&gt; properties define the relationships between records. &lt;strong&gt;&lt;code&gt;LabelMemberPath&lt;/code&gt;&lt;/strong&gt; identifies the category label, while &lt;strong&gt;&lt;code&gt;ValueMemberPath&lt;/code&gt;&lt;/strong&gt; identifies the numeric field.&lt;/p&gt;

&lt;p&gt;The data-label setting displays category labels on the chart. Once the component is configured, run the application and navigate to &lt;strong&gt;&lt;code&gt;/sunburst-chart&lt;/code&gt;&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F49ujojbo87vj581rqupd.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F49ujojbo87vj581rqupd.png" alt="World population distribution visualized using the Blazor Sunburst Chart"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Visualizing world population distribution data using Blazor Sunburst Chart&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The following image demonstrates the chart after drilling into a continent-level segment and shows the corresponding breadcrumb navigation.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fes9bt0d5nh0zpvf0hd2q.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fes9bt0d5nh0zpvf0hd2q.png" alt="Asia drill-down with breadcrumb navigation in the Blazor Sunburst Chart"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Hierarchical data exploration using drill-down feature in Blazor Sunburst Chart&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;For additional breadcrumb appearance and customization options, refer to the &lt;a href="https://help.syncfusion.com/chart-sdk/blazor/sunburst-chart/drill-down#sunburstbreadcrumbsettings-properties" rel="noopener noreferrer"&gt;documentation&lt;/a&gt;.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; &lt;em&gt;Population values are assigned only to country nodes. The Sunburst chart automatically aggregates these values to calculate and display totals for their parent continent nodes.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;
  
  
  Understanding hierarchical data structures
&lt;/h2&gt;

&lt;p&gt;The Blazor Sunburst Chart uses a flat (denormalized) data structure to represent hierarchies. Unlike nested JSON trees, this flat model uses explicit parent-child references, which simplifies data validation and integration with APIs and databases.&lt;/p&gt;
&lt;h3&gt;
  
  
  The flat hierarchy model
&lt;/h3&gt;

&lt;p&gt;Each node in a Sunburst hierarchy is represented as a single record (object) containing four required properties:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Id (string):&lt;/strong&gt; Unique identifier for the node. Must be unique across the entire dataset.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ParentId (string):&lt;/strong&gt; Identifier of this node’s parent. Empty string or null for root nodes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Name (string):&lt;/strong&gt; Display name rendered as the segment label.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Value (double):&lt;/strong&gt; Numeric value used to calculate segment size. For hierarchical datasets, values are typically assigned to leaf nodes. Parent segment values are automatically aggregated from their child nodes by the Sunburst Chart.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;For example:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"world"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Asia"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"china"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"China"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="k"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"china_east"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"china"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Eastern"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;385&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="c1"&gt;// Population represents the Value field&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This creates the following hierarchy:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;World

&lt;ul&gt;
&lt;li&gt;Asia

&lt;ul&gt;
&lt;li&gt;China&lt;/li&gt;
&lt;li&gt;Eastern — 385&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The china_east record references China, and China references Asia. These parent-child relationships determine how the nodes are organized in the chart.&lt;/p&gt;

&lt;h3&gt;
  
  
  Hierarchy levels and node types
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Root nodes (level 1):&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Root nodes represent the top of the hierarchy and have no parent. Set &lt;strong&gt;&lt;code&gt;ParentId&lt;/code&gt;&lt;/strong&gt; to an empty string ("") or &lt;strong&gt;&lt;code&gt;null&lt;/code&gt;&lt;/strong&gt;. The chart renders all root nodes as independent branches radiating from the center.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;PopulationNode&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"world"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"World"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Intermediate nodes (level 2+):&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Intermediate nodes bridge roots and leaves. They must have a &lt;strong&gt;&lt;code&gt;ParentId&lt;/code&gt;&lt;/strong&gt; that matches the &lt;strong&gt;&lt;code&gt;Id&lt;/code&gt;&lt;/strong&gt; of an existing parent node. Parent nodes do not require explicit aggregate values. The Sunburst Chart automatically calculates and renders parent segment sizes by aggregating the values of their child nodes.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;PopulationNode&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"world"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Asia"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Leaf nodes (lowest level):&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Leaf nodes are at the bottom of the hierarchy and contain the actual numeric data. These values drive segment size calculations and visual prominence in the chart.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;PopulationNode&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"china"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ParentId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"asia"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"China"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Population&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;1406.6&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Avoid these common hierarchy mistakes
&lt;/h3&gt;

&lt;p&gt;Before binding data to the chart, validate your hierarchy carefully.&lt;/p&gt;

&lt;h4&gt;
  
  
  1. Duplicate IDs
&lt;/h4&gt;

&lt;p&gt;Every node must have a unique identifier.&lt;/p&gt;

&lt;p&gt;Duplicate IDs can break parent-child mapping and may result in missing or incorrectly displayed segments. Always validate uniqueness before binding data.&lt;/p&gt;

&lt;h4&gt;
  
  
  2. Invalid parent references
&lt;/h4&gt;

&lt;p&gt;Each ParentId must point to an existing node.&lt;/p&gt;

&lt;p&gt;Missing parent references create orphaned nodes that are excluded from the visualization, often making the chart appear incomplete.&lt;/p&gt;

&lt;h4&gt;
  
  
  3. Circular relationships
&lt;/h4&gt;

&lt;p&gt;A node should never eventually reference itself through a parent chain (A→B→A or longer cycles such as A→B→C→A).&lt;/p&gt;

&lt;p&gt;Circular data indicates a data quality issue and should be fixed at the source.&lt;/p&gt;

&lt;h4&gt;
  
  
  4. Incorrect value assignment
&lt;/h4&gt;

&lt;p&gt;A common best practice is to assign values only to leaf nodes.&lt;/p&gt;

&lt;p&gt;The Sunburst Chart automatically aggregates parent segment sizes from child-node values, preventing double-counting and keeping the hierarchy easier to maintain.&lt;/p&gt;

&lt;h2&gt;
  
  
  Validate hierarchical data before it breaks your charts
&lt;/h2&gt;

&lt;p&gt;In development environments, hierarchy issues are often easy to spot. However, in production, missing nodes or broken relationships can be difficult to diagnose.&lt;/p&gt;

&lt;p&gt;Validating hierarchy data on the server helps catch problems before they reach the client and prevents rendering issues that can frustrate users.&lt;/p&gt;

&lt;p&gt;The validation approach below checks for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Duplicate identifiers&lt;/li&gt;
&lt;li&gt;Missing parent references&lt;/li&gt;
&lt;li&gt;Circular dependencies
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nd"&gt;@code&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
     &lt;span class="c1"&gt;// PopulationNode and PopulationData are defined in the Step 5 code above.&lt;/span&gt;
    &lt;span class="k"&gt;protected&lt;/span&gt; &lt;span class="k"&gt;override&lt;/span&gt; &lt;span class="kt"&gt;void&lt;/span&gt; &lt;span class="nc"&gt;OnInitialized&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="c1"&gt;// Validate PopulationData before binding it to the chart.&lt;/span&gt;
        &lt;span class="nc"&gt;HierarchyValidator&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Validate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;PopulationData&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;HierarchyValidator&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="kt"&gt;void&lt;/span&gt; &lt;span class="nc"&gt;Validate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;List&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PopulationNode&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nodes&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="k"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;ArgumentNullException&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;nameof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Count&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;lookup&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Dictionary&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;PopulationNode&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="nc"&gt;StringComparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Ordinal&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

            &lt;span class="c1"&gt;// Check identifiers and duplicate IDs.&lt;/span&gt;
            &lt;span class="k"&gt;foreach&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;node&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;IsNullOrWhiteSpace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;InvalidOperationException&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                        &lt;span class="s2"&gt;"Every node must have a non-empty ID."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;

                &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;lookup&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;TryAdd&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;InvalidOperationException&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                        $&lt;span class="s2"&gt;"Duplicate ID detected: '{node.Id}'."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="c1"&gt;// Check parent references.&lt;/span&gt;
            &lt;span class="k"&gt;foreach&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;node&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;IsNullOrEmpty&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ParentId&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;continue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;

                &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;lookup&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ContainsKey&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ParentId&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;InvalidOperationException&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                        $&lt;span class="s2"&gt;"Parent ID '{node.ParentId}' was not found "&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
                        $&lt;span class="s2"&gt;"for node '{node.Id}'."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="c1"&gt;// Detect cycles by following each node's parent chain.&lt;/span&gt;
            &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;completed&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;HashSet&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="nc"&gt;StringComparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Ordinal&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

            &lt;span class="k"&gt;foreach&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;node&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;nodes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;completed&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Contains&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;continue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;

                &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;currentPath&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;HashSet&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                    &lt;span class="nc"&gt;StringComparer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Ordinal&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

                &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;current&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;node&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

                &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;completed&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Contains&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                    &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;

                    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;currentPath&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Add&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                    &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;InvalidOperationException&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                            $&lt;span class="s2"&gt;"Circular relationship detected at "&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
                            $&lt;span class="s2"&gt;"node '{current.Id}'."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;

                    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;IsNullOrEmpty&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ParentId&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                    &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;

                    &lt;span class="n"&gt;current&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;lookup&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ParentId&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;

                &lt;span class="n"&gt;completed&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;UnionWith&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;currentPath&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This validator checks IDs, parent references, and cycles. It does not enforce every business rule. Depending on your application, you may also need to validate numeric values, allowed root counts, and the consistency of aggregate totals.&lt;/p&gt;

&lt;p&gt;For API-backed data, perform validation and authorization on the server as well as any client-side checks.&lt;/p&gt;

&lt;h2&gt;
  
  
  Prepare your sunburst charts for production
&lt;/h2&gt;

&lt;p&gt;A chart that works locally isn’t automatically production-ready. As data volume increases, rendering complexity increases as well.&lt;/p&gt;

&lt;p&gt;Consider the following practices:&lt;/p&gt;

&lt;h3&gt;
  
  
  Performance and readability
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Test with realistic data volumes and hierarchy depths.&lt;/li&gt;
&lt;li&gt;Review label visibility and overflow when the chart contains many categories.&lt;/li&gt;
&lt;li&gt;Consider filtering data before rendering when users need only a particular branch.&lt;/li&gt;
&lt;li&gt;Test the chart in the browsers and screen sizes your application supports.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Avoid relying on a fixed node count as a universal performance threshold. Rendering performance and label readability depend on the dataset and the environment.&lt;/p&gt;

&lt;h3&gt;
  
  
  Security and data quality
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Validate hierarchy data before rendering.&lt;/li&gt;
&lt;li&gt;Apply authorization and tenant filtering on the server.&lt;/li&gt;
&lt;li&gt;Avoid exposing internal identifiers unless the application needs them.&lt;/li&gt;
&lt;li&gt;Ensure that users can access only the data they are authorized to view.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Accessibility
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Use descriptive titles and labels.&lt;/li&gt;
&lt;li&gt;Choose colors with sufficient contrast.&lt;/li&gt;
&lt;li&gt;Provide a text summary or alternative representation of important information.&lt;/li&gt;
&lt;li&gt;Test keyboard interaction and screen-reader behavior against the component’s documented accessibility support.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Testing and deployment
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Verify package versions and script references in the deployed application.&lt;/li&gt;
&lt;li&gt;Test the actual Blazor render mode and hosting environment.&lt;/li&gt;
&lt;li&gt;Monitor browser console and server logs for errors.&lt;/li&gt;
&lt;li&gt;Provide loading and error states when fetching data from APIs.&lt;/li&gt;
&lt;li&gt;Handle component or data-loading failures gracefully.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: Can I bind data from a REST API?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Use &lt;strong&gt;&lt;code&gt;HttpClient&lt;/code&gt;&lt;/strong&gt; to fetch data, validate it with &lt;strong&gt;&lt;code&gt;HierarchyValidator&lt;/code&gt;&lt;/strong&gt;, then bind to the &lt;strong&gt;&lt;code&gt;DataSource&lt;/code&gt;&lt;/strong&gt; property. Add loading and error states during async operations.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: How do I enable drill-down navigation?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Add &lt;strong&gt;&lt;code&gt;&amp;lt;SunburstDrillSettings Enable="true"/&amp;gt;&lt;/code&gt;&lt;/strong&gt; to your component. Users can double-click segments to drill into the hierarchy. After drilling in, breadcrumb navigation is displayed, allowing users to return to any previously visited level.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Can I have multiple root nodes?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Any node with an empty or null ParentId is a root. The chart renders all roots as independent branches radiating from the center.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: When should I use Treemap instead of Sunburst?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Use Treemap when you have hundreds of categories, limited screen space, or when precise size comparison is more important than hierarchy relationships.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: What is the maximum hierarchy depth supported?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The Sunburst chart supports multi-level hierarchies. For complex or deeply nested data, drill-down can help improve readability and navigation.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q6: Does Syncfusion offer API reference documentation?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Visit the official Syncfusion Blazor Charts &lt;a href="https://help.syncfusion.com/chart-sdk/blazor/sunburst-chart/getting-started-with-web-app" rel="noopener noreferrer"&gt;documentation&lt;/a&gt; site for complete &lt;a href="https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfSunburstChart-1.html" rel="noopener noreferrer"&gt;API reference&lt;/a&gt; and &lt;a href="https://blazor.syncfusion.com/demos/sunburst-chart/default-functionalities?theme=material3" rel="noopener noreferrer"&gt;demos&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  From complex hierarchies to interactive insights
&lt;/h2&gt;

&lt;p&gt;The Syncfusion &lt;a href="https://www.syncfusion.com/blazor-components/blazor-sunburst-chart" rel="noopener noreferrer"&gt;Blazor Sunburst Chart&lt;/a&gt; provides an effective way to visualize hierarchical data while preserving both structure and proportional relationships. By combining a clean hierarchy model, drill-down interactivity, and proper validation techniques, developers can build dashboards that make complex data significantly easier to explore and understand.&lt;/p&gt;

&lt;p&gt;Whether you’re visualizing organizational structures, product catalogs, financial breakdowns, or geographical data, the techniques covered in this guide provide a solid foundation for building production-ready hierarchical visualizations in Blazor.&lt;/p&gt;

&lt;p&gt;To continue exploring advanced customization options, review the online &lt;a href="https://blazor.syncfusion.com/demos/sunburst-chart/default-functionalities?theme=fluent2" rel="noopener noreferrer"&gt;demos&lt;/a&gt; and &lt;a href="https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfSunburstChart-1.html" rel="noopener noreferrer"&gt;API documentation&lt;/a&gt;, and experiment with your own hierarchical datasets to see how Sunburst charts can improve data exploration experiences.&lt;/p&gt;

&lt;p&gt;This feature is available in our &lt;a href="https://www.syncfusion.com/forums/198591/essential-studio-2026-volume-3-main-release-v35-1-37-is-available-for-download" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt; release. You can also explore the &lt;a href="https://www.syncfusion.com/products/release-history" rel="noopener noreferrer"&gt;Release Notes&lt;/a&gt; and &lt;a href="https://www.syncfusion.com/products/whatsnew" rel="noopener noreferrer"&gt;What’s New&lt;/a&gt; pages for additional details.&lt;/p&gt;

&lt;p&gt;If you’re a Syncfusion user, you can download the setup from the &lt;a href="https://www.syncfusion.com/sales/pricing" rel="noopener noreferrer"&gt;license and downloads&lt;/a&gt; page. Otherwise, you can download a free &lt;a href="https://www.syncfusion.com/downloads" rel="noopener noreferrer"&gt;30-day trial&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;You can also contact us via our &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt; for queries. We are always happy to assist you!&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/blazor-chart-wizard" rel="noopener noreferrer"&gt;Still Building Custom Chart Builders? Build Runtime Charts with Blazor Chart Wizard&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/syncfusion-essential-studio-2026-vol-2" rel="noopener noreferrer"&gt;What’s New in Syncfusion Essential Studio 2026 Volume 2: AI Features, New SDKs, and Faster Components&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/document-editors-sdk-2026-volume-2" rel="noopener noreferrer"&gt;From Faster PDFs to AI-Powered Spreadsheets: See What’s New in Syncfusion 2026 Volume 2&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-powered-blazor-chatbot" rel="noopener noreferrer"&gt;How to Build an AI-Powered Blazor Chatbot That Turns Conversations into Charts&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>blazor</category>
      <category>charts</category>
      <category>web</category>
      <category>productivity</category>
    </item>
    <item>
      <title>7 MCP Servers to Evaluate in 2026: Features and Use Cases</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Mon, 26 Oct 2026 14:17:01 +0000</pubDate>
      <link>https://dev.to/syncfusion/7-mcp-servers-to-evaluate-in-2026-features-and-use-cases-423g</link>
      <guid>https://dev.to/syncfusion/7-mcp-servers-to-evaluate-in-2026-features-and-use-cases-423g</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Looking to connect AI assistants with your favorite tools? MCP servers make it easier to access web content, explore code repositories, query databases, generate UI code, and automate browser tasks. Explore 7 MCP servers, compare their use cases, and learn how to choose, configure, and use them securely in your development workflow.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Introduction
&lt;/h2&gt;

&lt;p&gt;Your AI coding assistant is great at explaining a function or drafting some code. But it gets stuck the second it needs something it can’t see: a file in your repo, the latest version of a framework’s documentation, or your database schema.&lt;/p&gt;

&lt;p&gt;When that happens, you end up doing the boring part yourself, copying things over and jumping between tabs.&lt;/p&gt;

&lt;p&gt;That’s the gap &lt;a href="https://modelcontextprotocol.io/" rel="noopener noreferrer"&gt;Model Context Protocol&lt;/a&gt; (MCP) fills. It’s a standard way for AI apps to reach outside tools and data. Hook up the right MCP servers, and your assistant can pull web content, read your repo, query a database, drive a browser, and more.&lt;/p&gt;

&lt;p&gt;There are now far more MCP servers than any team could use, so the real challenge is picking the right ones. This guide covers seven across everyday developer work, what each one does, and how to decide if it’s worth your time, including setup, permissions, hosting, and security.&lt;/p&gt;

&lt;h2&gt;
  
  
  What is MCP?
&lt;/h2&gt;

&lt;p&gt;Ever asked your assistant about an API or a repo issue, and it just didn’t have the info? That’s exactly what MCP fixes.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://modelcontextprotocol.io/" rel="noopener noreferrer"&gt;MCP&lt;/a&gt; is an open protocol. It sets the rules for how AI apps talk to MCP servers. A server offers up tools, resources, and prompts, and a compatible assistant can find them and use them, but only within what the server allows and what you’ve given it permission to do.&lt;/p&gt;

&lt;p&gt;In plain terms, an MCP server might let your assistant:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Pull content from websites.&lt;/li&gt;
&lt;li&gt;Read repo files and check pull requests.&lt;/li&gt;
&lt;li&gt;Query a database or look at its schema.&lt;/li&gt;
&lt;li&gt;Control a browser.&lt;/li&gt;
&lt;li&gt;Find UI component documentation and examples.&lt;/li&gt;
&lt;li&gt;View project tasks and workspace actions.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Without a shared standard, you’d build a separate integration for every AI app. MCP gives them one common language. You still handle the sign-in, setup, and permissions for each connection, though.&lt;/p&gt;

&lt;h2&gt;
  
  
  How does MCP work?
&lt;/h2&gt;

&lt;p&gt;An MCP setup has three parts:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;MCP host:&lt;/strong&gt; the AI app you actually use.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MCP client:&lt;/strong&gt; the piece inside the host that talks to a server.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MCP server:&lt;/strong&gt; the piece that offers up the tools, like repo access, web content, or database actions.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;So which apps are the hosts? In 2026, popular MCP-ready clients include &lt;strong&gt;Claude Desktop, VS Code with GitHub Copilot, and Cursor&lt;/strong&gt;. The examples below assume one of these. (Check your client’s documentation for current MCP support, since this space moves fast.)&lt;/p&gt;

&lt;p&gt;Here’s how it plays out. You ask your assistant to explain a function in a GitHub repo. If a GitHub MCP server is connected and has the right permissions, the assistant grabs the source and uses it to answer.&lt;/p&gt;

&lt;p&gt;What it can do comes down to three things: the server’s tools, the credentials you give it, and the permissions you grant. Connecting a server doesn’t hand your assistant the keys to everything, it only gets what you allow.&lt;/p&gt;

&lt;h2&gt;
  
  
  How we picked these servers
&lt;/h2&gt;

&lt;p&gt;MCP servers cover a lot of ground, from coding and research to browser automation and project management. We chose seven that solve different, everyday problems. For each, we looked at:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Purpose:&lt;/strong&gt; the problem it’s built for.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What it does:&lt;/strong&gt; the tools its maintainers describe.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Setup:&lt;/strong&gt; how you connect, sign in, and configure it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Where it helps:&lt;/strong&gt; the workflows it fits.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Watch-outs:&lt;/strong&gt; compatibility, permissions, and security.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;One thing to be clear about: this is a use-case guide, not a benchmark or a stamp of production approval. Official documentation tell you what a project supports. They don’t guarantee that every setup is reliable or secure. Check the linked repos for current details before you commit to a server.&lt;/p&gt;

&lt;h2&gt;
  
  
  7 MCP servers worth evaluating
&lt;/h2&gt;

&lt;h3&gt;
  
  
  1. Firecrawl MCP: Pull and extract web content
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Web research, documentation, and content extraction.&lt;/p&gt;

&lt;p&gt;Assistants answer better when they can reach fresh, relevant info. Firecrawl MCP adds web search and content extraction, so your assistant can pull in details from supported sites.&lt;/p&gt;

&lt;p&gt;Depending on the tools you turn on, you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Search web pages.&lt;/li&gt;
&lt;li&gt;Extract content from supported URLs.&lt;/li&gt;
&lt;li&gt;Analyze documentation.&lt;/li&gt;
&lt;li&gt;Gather information across multiple pages.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; You’re upgrading a framework and want to compare the new API with the old one. Firecrawl grabs the right documentation pages, and your assistant compares them, no manual hunting and copying.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; Not every URL works. Logins, site restrictions, formats, and service limits can all get in the way. Read what comes back, and double-check anything important against the source.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official source&lt;/strong&gt; : &lt;a href="https://github.com/firecrawl/firecrawl-mcp-server" rel="noopener noreferrer"&gt;Firecrawl MCP Server repository&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  2. GitHub MCP: Explore repos and dev activity
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Repos, issues, pull requests, and dev workflows.&lt;/p&gt;

&lt;p&gt;Learning a new codebase usually means hunting for files, following changes, and reading issues and PRs. GitHub MCP connects your assistant to supported GitHub actions and brings that context right into the chat.&lt;/p&gt;

&lt;p&gt;Depending on the toolsets and permissions you enable, you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Read repo files.&lt;/li&gt;
&lt;li&gt;Look at issues and pull requests.&lt;/li&gt;
&lt;li&gt;Review commits and code changes.&lt;/li&gt;
&lt;li&gt;See supported workflow info.&lt;/li&gt;
&lt;li&gt;Run selected repo actions.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; You join a project with hundreds of files. Instead of digging around, you ask the assistant to inspect a module, sum up a PR, or find the backstory on a bug. Just verify what it says against the actual code.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; GitHub MCP can both read and write. Start with the smallest toolset you need, and stick to read-only if you’re only looking at code or issues. Its reach is also limited by whatever the credentials allow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://github.com/github/github-mcp-server" rel="noopener noreferrer"&gt;GitHub MCP Server repository&lt;/a&gt; and &lt;a href="https://github.com/github/github-mcp-server/blob/main/docs/server-configuration.md" rel="noopener noreferrer"&gt;configuration guide&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Publora MCP: Handle social media workflows
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Social posting, scheduling, and account management.&lt;/p&gt;

&lt;p&gt;MCP isn’t just a developer thing. It can also connect assistants to the tools marketing and content teams use. Publora MCP links your assistant to Publora’s publishing platform. It can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;List connected social accounts.&lt;/li&gt;
&lt;li&gt;Create and schedule posts.&lt;/li&gt;
&lt;li&gt;Review scheduled content.&lt;/li&gt;
&lt;li&gt;Update or delete posts.&lt;/li&gt;
&lt;li&gt;Pull supported stats.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; Your team has a product announcement ready. A connected assistant can help draft the post and schedule it to the right account, as long as the tools and permissions allow it. Content preparation and publishing, all in one place.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; Posts can go public. Confirm which accounts are connected and what the server can do. Then review the text, media, account, and timing before you hit confirm.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://docs.publora.com/guides/mcp-server" rel="noopener noreferrer"&gt;Publora MCP Server guide&lt;/a&gt; and &lt;a href="https://docs.publora.com/mcp/client-setup" rel="noopener noreferrer"&gt;client setup documentation&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Syncfusion MCP Servers: Find component APIs and examples
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Developers building with Syncfusion UI components and document libraries.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9vf5qy4jqcjhrvqr35j4.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9vf5qy4jqcjhrvqr35j4.png" alt="Syncfusion MCP Servers" width="800" height="327"&gt;&lt;/a&gt;&lt;/p&gt;
Syncfusion MCP Servers



&lt;p&gt;AI assistants write UI code fast, but the suggestion often targets a different API or package version than the one you’re on. So you still have to check properties, imports, and settings against the documentation, and that’s where the time goes.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://www.syncfusion.com/explore/mcp-servers/" rel="noopener noreferrer"&gt;Syncfusion MCP Servers&lt;/a&gt; connect your AI dev tools to official Syncfusion documentation and framework details, so the assistant works from the right source instead of guessing. Syncfusion covers web (&lt;a href="https://www.syncfusion.com/javascript-ui-controls" rel="noopener noreferrer"&gt;JavaScript&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/angular-components" rel="noopener noreferrer"&gt;Angular&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/react-components" rel="noopener noreferrer"&gt;React&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/vue-components" rel="noopener noreferrer"&gt;Vue&lt;/a&gt;), &lt;a href="https://www.syncfusion.com/blazor-components" rel="noopener noreferrer"&gt;Blazor&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/maui-controls" rel="noopener noreferrer"&gt;.NET MAUI&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/wpf-controls" rel="noopener noreferrer"&gt;WPF&lt;/a&gt;, and &lt;a href="https://www.syncfusion.com/winforms-ui-controls" rel="noopener noreferrer"&gt;WinForms&lt;/a&gt;, plus document libraries for &lt;a href="https://www.syncfusion.com/pdf-viewer-sdk" rel="noopener noreferrer"&gt;PDF&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/document-sdk/net-word-library" rel="noopener noreferrer"&gt;Word&lt;/a&gt;, &lt;a href="https://www.syncfusion.com/document-sdk/net-excel-library" rel="noopener noreferrer"&gt;Excel&lt;/a&gt;, and &lt;a href="https://www.syncfusion.com/document-sdk/net-powerpoint-library" rel="noopener noreferrer"&gt;PowerPoint&lt;/a&gt;. The servers serve up documentation that match your stack.&lt;/p&gt;

&lt;p&gt;Depending on the server you pick, you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Find component APIs and settings.&lt;/li&gt;
&lt;li&gt;Pull relevant documentation and examples.&lt;/li&gt;
&lt;li&gt;Explore framework-specific patterns.&lt;/li&gt;
&lt;li&gt;Dig into questions about Syncfusion components and libraries.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Set up a DataGrid.&lt;/strong&gt; You’re building an enterprise dashboard and need a Syncfusion DataGrid with filtering, sorting, and Excel export. You ask:&lt;/p&gt;

&lt;p&gt;“Help me set up a Syncfusion DataGrid in Angular with filtering, sorting, and Excel export. Use the official docs to find the APIs and give me a working example.”&lt;/p&gt;

&lt;p&gt;With the server connected, the assistant pulls the right documentation and returns a setup based on them, for example, turning on &lt;code&gt;allowFiltering&lt;/code&gt;, &lt;code&gt;allowSorting&lt;/code&gt;, and &lt;code&gt;allowExcelExport&lt;/code&gt;, then wiring up the matching toolbar action.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; &lt;em&gt;Property names and APIs may vary by framework and Syncfusion version. Use the generated code as a starting point and verify it against the documentation for your installed version.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Before you ship it, make sure it matches your installed version and test it in your app. Pulling the documentation gives the assistant better context, but it does not guarantee that the generated code will be correct.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;How to judge it:&lt;/strong&gt; If your team already uses Syncfusion, point the right framework server at a real task and watch two things. Does it find the correct APIs for your version? And does it cut the time you’d spend searching documentation or fixing code? If you use a different UI library, try an MCP server built for that instead.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://www.syncfusion.com/explore/mcp-servers/" rel="noopener noreferrer"&gt;Syncfusion MCP Servers and setup instructions&lt;/a&gt; and &lt;a href="https://help.syncfusion.com/document-processing/mcp-server/documentsdk" rel="noopener noreferrer"&gt;Syncfusion Document SDK MCP guide&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. Supabase MCP: Explore databases and projects
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Database work, schema design, and Supabase projects.&lt;/p&gt;

&lt;p&gt;When you’re building, you bounce between a database console, schema documentation, and your assistant. Supabase MCP connects your assistant to Supabase projects and offers tools for supported database and project actions.&lt;/p&gt;

&lt;p&gt;Depending on your setup, you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Inspect schemas.&lt;/li&gt;
&lt;li&gt;Query data and dig into issues.&lt;/li&gt;
&lt;li&gt;Create or change database structures.&lt;/li&gt;
&lt;li&gt;Review project config.&lt;/li&gt;
&lt;li&gt;Help with debugging.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; You’re building a dashboard and need to understand the tables behind the reports. Ask the assistant to look at the schema and help write a query. Before you drop that query into your app, check the logic and confirm the results look right.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; Supabase MCP can run powerful actions, including ones that change data. Read the documentation on project scoping, read-only mode, and limiting features. Start on a dev or staging project. If you really need production access, keep permissions minimal and follow Supabase’s security advice.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://github.com/supabase/mcp" rel="noopener noreferrer"&gt;Supabase MCP repository&lt;/a&gt; and &lt;a href="https://supabase.com/docs/guides/ai-tools/mcp" rel="noopener noreferrer"&gt;documentation&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  6. Microsoft Playwright MCP: Automate the browser
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Browser automation, web testing, and working with web apps.&lt;/p&gt;

&lt;p&gt;Browser automation is handy for navigating sites, filling forms, testing flows, and reading pages. Microsoft Playwright MCP lets your assistant drive web pages through Playwright. It uses the page’s accessibility info to understand elements and interact with them.&lt;/p&gt;

&lt;p&gt;Typical tasks:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Open a page.&lt;/li&gt;
&lt;li&gt;Fill forms and use controls.&lt;/li&gt;
&lt;li&gt;Test user flows.&lt;/li&gt;
&lt;li&gt;Read page content.&lt;/li&gt;
&lt;li&gt;Run browser-based checks.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; You’re testing a registration form in a dev environment. You ask the assistant to open the test app, fill the fields, submit, and report back. It works through Playwright MCP and checks the results. Keep your real automated tests for critical flows, though, this doesn’t replace them.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; Browser automation can touch logged-in sessions and live sites. Use a test environment for anything risky, limit access, and don’t expose sensitive browser profiles or credentials. The project itself says the server &lt;strong&gt;is not a security boundary&lt;/strong&gt; , so treat its browser access as a capability to control, not a security feature.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://github.com/microsoft/playwright-mcp" rel="noopener noreferrer"&gt;Microsoft Playwright MCP repository&lt;/a&gt; and &lt;a href="https://playwright.dev/mcp/introduction" rel="noopener noreferrer"&gt;getting-started guide&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  7. Taskade MCP: Connect AI to projects and tasks
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Best for:&lt;/strong&gt; Project coordination, task management, and workspace automation.&lt;/p&gt;

&lt;p&gt;Teams spend real time organizing work, assigning tasks, and tracking progress alongside writing code. Taskade MCP connects your assistant to Taskade workspaces and the actions they support.&lt;/p&gt;

&lt;p&gt;Depending on the connection and permissions, you can work with:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Projects and tasks.&lt;/li&gt;
&lt;li&gt;Workspace info.&lt;/li&gt;
&lt;li&gt;Agents.&lt;/li&gt;
&lt;li&gt;Supported automations.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Example:&lt;/strong&gt; At the start of a sprint, you ask the assistant to review a project and sum up what’s still open. With the right permissions, it can also help create or update tasks. Review any changes before it touches the workspace, especially anything that affects assignments, deadlines, or shared info.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Check first:&lt;/strong&gt; Taskade has more than one connection option. The hosted server connects a remote client to Taskade, while the open-source workspace server runs locally. Sign-in, plan requirements, setup, and available actions differ between them, so check the documentation for the one you plan to use.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Official sources:&lt;/strong&gt; &lt;a href="https://www.taskade.com/docs/mcp" rel="noopener noreferrer"&gt;Taskade MCP documentation&lt;/a&gt;, &lt;a href="https://www.taskade.com/docs/mcp/hosted-mcp" rel="noopener noreferrer"&gt;hosted MCP setup&lt;/a&gt; and &lt;a href="https://www.taskade.com/docs/mcp/workspace-mcp" rel="noopener noreferrer"&gt;local Workspace MCP setup&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quick comparison
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
  &lt;colgroup&gt;
    &lt;col&gt;
    &lt;col&gt;
    &lt;col&gt;
  &lt;/colgroup&gt;
  &lt;thead&gt;
    &lt;tr&gt;
      &lt;th&gt;MCP server&lt;/th&gt;
      &lt;th&gt;Best for&lt;/th&gt;
      &lt;th&gt;What it helps you do&lt;/th&gt;
    &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
    &lt;tr&gt;
      &lt;td&gt;Firecrawl MCP&lt;/td&gt;
      &lt;td&gt;Web research&lt;/td&gt;
      &lt;td&gt;Search, pull, and extract web content&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;GitHub MCP&lt;/td&gt;
      &lt;td&gt;Repo workflows&lt;/td&gt;
      &lt;td&gt;Explore code, issues, and pull requests&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Publora MCP&lt;/td&gt;
      &lt;td&gt;Social posting&lt;/td&gt;
      &lt;td&gt;Manage posts and connected accounts&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Supabase MCP&lt;/td&gt;
      &lt;td&gt;Database work&lt;/td&gt;
      &lt;td&gt;Inspect schemas, query data, manage supported resources&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Syncfusion MCP Servers&lt;/td&gt;
      &lt;td&gt;UI development&lt;/td&gt;
      &lt;td&gt;Pull official component documentation and examples&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Microsoft Playwright MCP&lt;/td&gt;
      &lt;td&gt;Browser automation&lt;/td&gt;
      &lt;td&gt;Drive web pages and test user flows&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Taskade MCP&lt;/td&gt;
      &lt;td&gt;Project management&lt;/td&gt;
      &lt;td&gt;Access projects, tasks, and supported actions&lt;/td&gt;
    &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;These servers solve different problems, so there’s no fair way to rank them on one scale without a real test. The best pick depends on your workflow, your client, the capabilities you need, how access works, and where it runs.&lt;/p&gt;

&lt;h2&gt;
  
  
  Hosted vs. local (or self-hosted)
&lt;/h2&gt;

&lt;p&gt;Once you’ve picked a server, decide how it runs and connects.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A hosted server runs on a provider’s infrastructure. Your client connects to it remotely, usually over HTTPS. Setup is often easier because you don’t run or maintain anything.&lt;/li&gt;
&lt;li&gt;A local or self-hosted server runs on your own machine or infrastructure. Local ones usually talk to clients over standard input/output (stdio), while self-hosted remote ones may use an HTTP endpoint.&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
  &lt;colgroup&gt;
    &lt;col&gt;
    &lt;col&gt;
    &lt;col&gt;
  &lt;/colgroup&gt;
  &lt;thead&gt;
    &lt;tr&gt;
      &lt;th&gt;Consideration&lt;/th&gt;
      &lt;th&gt;Hosted&lt;/th&gt;
      &lt;th&gt;Local / self-hosted&lt;/th&gt;
    &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
    &lt;tr&gt;
      &lt;td&gt;Setup&lt;/td&gt;
      &lt;td&gt;Often easier; may need account sign-off&lt;/td&gt;
      &lt;td&gt;May need a runtime, config, or deployment&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Maintenance&lt;/td&gt;
      &lt;td&gt;Provider handles it&lt;/td&gt;
      &lt;td&gt;You handle updates and infrastructure&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Control&lt;/td&gt;
      &lt;td&gt;Limited to provider settings&lt;/td&gt;
      &lt;td&gt;More control over how it runs&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Data&lt;/td&gt;
      &lt;td&gt;Review the provider’s data and access policies&lt;/td&gt;
      &lt;td&gt;You control the environment, but you secure it&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Sign-in&lt;/td&gt;
      &lt;td&gt;Often OAuth or service credentials&lt;/td&gt;
      &lt;td&gt;API keys, tokens, env variables, or OAuth&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Best fit&lt;/td&gt;
      &lt;td&gt;Teams wanting a managed connection&lt;/td&gt;
      &lt;td&gt;Teams needing local tools or full control&lt;/td&gt;
    &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Neither one is automatically safer. Hosted means trusting a provider’s access and data practices. Self-hosted means you manage the config, credentials, network, and updates. Pick what fits your security needs and the time you have.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sign-in and permissions: what to check
&lt;/h2&gt;

&lt;p&gt;Before you connect a server, know how it signs in and what it can do with your account or data.&lt;/p&gt;

&lt;h3&gt;
  
  
  Common sign-in options:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;OAuth:&lt;/strong&gt; authorize an app through a sign-in and consent screen.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;API keys or tokens:&lt;/strong&gt; credentials a client uses to connect.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Environment variables or secret stores:&lt;/strong&gt; feed credentials to local processes without hardcoding them.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Servers don’t all support the same methods, so follow the official instructions for your specific server and client.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Read-only vs. write.&lt;/strong&gt; Read-only lets the assistant look without changing anything. Write lets it create, update, publish, or delete. For example:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Read-only GitHub is usually enough to inspect code and PRs.&lt;/li&gt;
&lt;li&gt;A posting integration needs write access to schedule or publish.&lt;/li&gt;
&lt;li&gt;A database workflow may need permission to create tables or run migrations.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Start with the least you need. Add write access only when you have to, and ask for confirmation on anything sensitive or destructive when the client and server support it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Compatibility checklist
&lt;/h2&gt;

&lt;p&gt;Before you install, confirm in the documentation:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Does your client support the server’s transport (how the two exchange messages, like stdio or HTTP) and its sign-in method?&lt;/li&gt;
&lt;li&gt;Does the server have the tools you need?&lt;/li&gt;
&lt;li&gt;Does it need Node.js, .NET, Docker, or another runtime?&lt;/li&gt;
&lt;li&gt;Does it need a paid account, API key, or license?&lt;/li&gt;
&lt;li&gt;Can you limit access to a specific project, repo, workspace, or tool set?&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  How to connect and test a server
&lt;/h2&gt;

&lt;p&gt;Setup differs by server and client. Here’s a basic local connection using Microsoft Playwright MCP.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 1: Check prerequisites
&lt;/h3&gt;

&lt;p&gt;The Playwright MCP getting-started guide lists Node.js (a recent LTS release) and an MCP-compatible client. Confirm the current requirements before you install, since they change.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 2: Add the config
&lt;/h3&gt;

&lt;p&gt;For clients that use the standard local-server format, the documentation show something like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"playwright"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"npx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nl"&gt;"args"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"@playwright/mcp@latest"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Use whatever format your client expects, some use different keys or a visual setup. For repeatable or production setups, pin a specific version instead of relying on @latest.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 3: Start it up
&lt;/h3&gt;

&lt;p&gt;Save the config and restart or reload the MCP connection as your client needs. Install any browser dependencies the guide mentions, then check for connection errors.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 4: Try something low-risk
&lt;/h3&gt;

&lt;p&gt;Start with a read-only task on a test page:&lt;/p&gt;

&lt;p&gt;“Open the Playwright TodoMVC demo, look at the page, and list the controls you see. Don’t submit or change anything.”&lt;/p&gt;

&lt;p&gt;Confirm the server connects, the assistant can read the page, and what it reports matches what you see.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 5: Review permissions before you expand
&lt;/h3&gt;

&lt;p&gt;Once the basics work, check the available tools and turn on only what you need. Test write or automation actions somewhere safe first.&lt;/p&gt;

&lt;h3&gt;
  
  
  Common setup issues:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Server doesn’t show up:&lt;/strong&gt; usually a config path or syntax error, or the client just needs a full restart.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;“Command not found”:&lt;/strong&gt; the runtime (like &lt;code&gt;Node.js&lt;/code&gt;) isn’t installed or isn’t on your PATH.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;401/403 errors:&lt;/strong&gt; the token is missing, expired, or lacks the right scope.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Drops or no tools listed:&lt;/strong&gt; a transport mismatch (stdio vs. &lt;code&gt;HTTP&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Production-readiness checklist
&lt;/h2&gt;

&lt;p&gt;A server that works in a demo isn’t automatically ready for production. Before you connect it to anything important:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Check the source:&lt;/strong&gt; Use the official repo or documentation. Look at release activity, maintenance, and known issues.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Confirm compatibility:&lt;/strong&gt; Test with the client, transport, runtime, and sign-in you’ll actually use.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Limit access:&lt;/strong&gt; Scope credentials to the one project, repo, workspace, or database you need, and enable only the tools you need.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Go read-only when you can:&lt;/strong&gt; Use it for anything that just looks and reports.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Protect credentials:&lt;/strong&gt; Store secrets safely, and never commit them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Guard risky actions:&lt;/strong&gt; Require approval before publishing, deleting, or touching production data.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Treat outside content as untrusted:&lt;/strong&gt; Web pages, repo comments, and database records can hide misleading instructions. Don’t let fetched content override your rules.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test in staging:&lt;/strong&gt; Use test data before you touch production.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Watch what it does:&lt;/strong&gt; Review tool calls, errors, and surprises where you can.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Plan for updates and recovery:&lt;/strong&gt; Pin versions, review changes before upgrading, and keep a fast way to revoke credentials or switch a server off.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;MCP standardizes how clients and servers talk. It doesn’t make the connected tools secure on its own. The safety of the whole thing comes down to the implementation, the credentials, the permissions, and the controls you put around it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: Can I use several MCP servers at once?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes, if your client supports multiple connections. You might run GitHub MCP for repo context and Firecrawl MCP for web research together. The client and model decide how to combine the tools.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Are MCP servers safe for production?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;They can be, with the right controls, but it depends on the specific server and setup. Check the source, limit permissions, test in staging, and watch its activity before you rely on it.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Do all AI assistants support MCP?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;No. Your client has to support the connection method and capabilities. Check the documentation for both your AI app and the server.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Do I need to know how to code?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Not always. Some hosted servers connect through a sign-in flow. Others need a config file, command-line tools, or a local runtime. Building your own server takes more technical know-how.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Can I self-host an MCP server?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Some projects offer local or self-hosted options, others are hosted only. Check the documentation for deployment options, runtime needs, sign-in, and who maintains it.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q6: How is MCP different from a normal API integration?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;A normal integration makes your app write all the API-specific logic. MCP gives clients one common way to find and call what a server offers. It cuts duplicated work, but you still handle API access, sign-in, config, and your own app logic.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;MCP gives AI apps a standard way to connect with outside tools, data, and services. Whatever your work looks like, web research, repos, databases, UI documentation, browser automation, or project tasks, the right server brings those abilities straight into your workflow.&lt;/p&gt;

&lt;p&gt;The best place to start is one server that solves one real problem for you. Check what it does, confirm it works with your client, keep permissions tight, and test the connection before you open things up.&lt;/p&gt;

&lt;p&gt;And if your team builds with Syncfusion components, try the &lt;a href="https://www.syncfusion.com/explore/mcp-servers/" rel="noopener noreferrer"&gt;Syncfusion MCP Servers&lt;/a&gt; and see whether quick access to framework-specific documentation speeds up your AI-assisted work.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/model-context-protocol-handbook" rel="noopener noreferrer"&gt;Tired of Fragile AI Integrations? Learn MCP Before Your Next Project&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/ai-coding-assistant-agent-skills-mcp" rel="noopener noreferrer"&gt;Build Faster with Syncfusion AI Coding Assistant Tools: Agent Skills and MCP Servers&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/model-context-protocol-csharp-sdk" rel="noopener noreferrer"&gt;Model Context Protocol (MCP): Building AI Integrations in .NET Using the C# SDK&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/enterprise-ui-with-mcp-servers" rel="noopener noreferrer"&gt;Introducing Agentic UI Builder: Build Complete Enterprise UIs with Syncfusion MCP Servers&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>syncfusion</category>
      <category>mcpserver</category>
      <category>aicodingassistants</category>
      <category>bestmcpservers</category>
    </item>
    <item>
      <title>How to Build Resizable Layouts with the .NET MAUI Grid Splitter</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Fri, 23 Oct 2026 14:15:17 +0000</pubDate>
      <link>https://dev.to/syncfusion/how-to-build-resizable-layouts-with-the-net-maui-grid-splitter-p91</link>
      <guid>https://dev.to/syncfusion/how-to-build-resizable-layouts-with-the-net-maui-grid-splitter-p91</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Learn how to build flexible, multi-pane interfaces in .NET MAUI applications using the Syncfusion Grid Splitter. Explore how to configure pane sizes, horizontal and vertical splitters, and collapsible sections to create adaptable multi-pane layouts.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Applications often need to display multiple views on the same screen, so efficient space management is key to the user experience. Navigation panels, data grids, and document previews may each require different amounts of space depending on the task. Fixed layouts can limit this flexibility, and implementing interactive resizing can require additional code.&lt;/p&gt;

&lt;p&gt;The Syncfusion &lt;a href="https://www.syncfusion.com/maui-controls/maui-gridsplitter" rel="noopener noreferrer"&gt;.NET MAUI Grid Splitter&lt;/a&gt;, introduced in &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;Essential Studio 2026 Volume 3&lt;/a&gt;, provides built-in support for resizing, collapsing, and expanding panes.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwdvp514zhs763cybz41y.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwdvp514zhs763cybz41y.png" alt=".NET MAUI Grid Splitter"&gt;&lt;/a&gt;&lt;/p&gt;
.NET MAUI Grid Splitter control



&lt;p&gt;Let’s explore its features and build a sample employee profile layout.&lt;/p&gt;

&lt;h2&gt;
  
  
  Key features of the .NET MAUI Grid Splitter
&lt;/h2&gt;

&lt;p&gt;The Syncfusion .NET MAUI Grid Splitter provides several capabilities for building multi-pane interfaces:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Resizable panes:&lt;/strong&gt; Let users adjust the space allocated to different content areas.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Collapsible panes:&lt;/strong&gt; Allow users to hide and restore panels when needed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Horizontal and vertical orientations:&lt;/strong&gt; Arrange panes side by side or vertically.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Flexible pane sizing:&lt;/strong&gt; Set initial sizes and define resizing limits.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Customizable separators:&lt;/strong&gt; Adjust the separator’s appearance.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Nested splitters:&lt;/strong&gt; Create layouts with multiple independently resizable sections.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Let’s look at how to use these features in an application.&lt;/p&gt;

&lt;h2&gt;
  
  
  Resize and collapse panes
&lt;/h2&gt;

&lt;p&gt;Some applications need users to control how much space different content areas occupy. For example, users might want to widen a navigation panel to read longer item names or expand a document preview to inspect its contents.&lt;/p&gt;

&lt;p&gt;The .NET MAUI Grid Splitter lets users drag a separator to resize adjacent panes at runtime. It handles the resizing logic automatically, reducing development effort and simplifying layout management.&lt;/p&gt;

&lt;p&gt;You can also set the &lt;strong&gt;MinimumSize&lt;/strong&gt; and &lt;strong&gt;MaximumSize&lt;/strong&gt; properties of &lt;strong&gt;SplitterPane&lt;/strong&gt; to define resizing limits. These limits keep each pane usable while still allowing users to adjust the layout.&lt;/p&gt;

&lt;p&gt;Sometimes, resizing isn’t enough. Users may want to hide a panel completely to focus on their primary task. The Grid Splitter supports collapsible panes, allowing users to quickly hide or restore content and focus on the information that matters most.&lt;/p&gt;

&lt;p&gt;This is useful for navigation panels, property windows, report filters, and contextual tool panels.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8ja78pvqu1ezsvie1914.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8ja78pvqu1ezsvie1914.gif" alt="Expand and collapse panels using the .NET MAUI Grid Splitter"&gt;&lt;/a&gt;&lt;/p&gt;
Expand and collapse panels using the .NET MAUI Grid Splitter



&lt;h2&gt;
  
  
  Customize the splitter separator
&lt;/h2&gt;

&lt;p&gt;The separator shows users where they can resize panels. You can customize its appearance to match your application’s design.&lt;/p&gt;

&lt;p&gt;The Grid Splitter provides properties such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://help.syncfusion.com/maui/grid-splitter/splitter-customization#separatorsize" rel="noopener noreferrer"&gt;SeparatorSize&lt;/a&gt;: Sets the separator’s thickness.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://help.syncfusion.com/maui/grid-splitter/splitter-customization#separatorbackground" rel="noopener noreferrer"&gt;SeparatorBackground&lt;/a&gt;: Sets the separator’s background color.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For example, the following XAML configures a horizontal splitter with a customized separator:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight xml"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;gridSplitter:SfGridSplitter&lt;/span&gt;
    &lt;span class="na"&gt;Orientation&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Horizontal"&lt;/span&gt;
    &lt;span class="na"&gt;SeparatorSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"8"&lt;/span&gt;
    &lt;span class="na"&gt;SeparatorBackground&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"#E0E0E0"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt; &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1*"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Navigation"&lt;/span&gt;
               &lt;span class="na"&gt;HorizontalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt;
               &lt;span class="na"&gt;VerticalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt; &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"2*"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Main Content"&lt;/span&gt;
               &lt;span class="na"&gt;HorizontalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt;
               &lt;span class="na"&gt;VerticalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

&lt;span class="nt"&gt;&amp;lt;/gridSplitter:SfGridSplitter&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Here, the separator is 8 units thick and uses a light-gray background. Adjust these values to suit your application’s visual style.&lt;/p&gt;

&lt;h2&gt;
  
  
  Configure pane sizes
&lt;/h2&gt;

&lt;p&gt;Different application regions often need different amounts of space. A navigation panel may need less room than a document editor, while a details panel needs enough space to display its content.&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;Size&lt;/strong&gt; property of &lt;strong&gt;SplitterPane&lt;/strong&gt; defines its initial size and how space is distributed among panes.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
  &lt;colgroup&gt;
    &lt;col&gt;
    &lt;col&gt;
  &lt;/colgroup&gt;
  &lt;thead&gt;
    &lt;tr&gt;
      &lt;th&gt;Value&lt;/th&gt;
      &lt;th&gt;Purpose&lt;/th&gt;
    &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
    &lt;tr&gt;
      &lt;td&gt;Size="200"&lt;/td&gt;
      &lt;td&gt;Specifies an initial size of 200 device-independent units.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Size="1*"&lt;/td&gt;
      &lt;td&gt;Allocates one proportional share of the available space.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Size="2*"&lt;/td&gt;
      &lt;td&gt;Allocates twice the proportional share of a 1* pane.&lt;/td&gt;
    &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;For example, panes with sizes 1*, 2*, and 1* start with a proportional size ratio of 1:2:1.&lt;/p&gt;

&lt;p&gt;You can combine &lt;strong&gt;Size&lt;/strong&gt; with &lt;strong&gt;MinimumSize&lt;/strong&gt; and &lt;strong&gt;MaximumSize&lt;/strong&gt; to control how far users can resize each pane:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight xml"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;gridSplitter:SfGridSplitter&lt;/span&gt; &lt;span class="na"&gt;Orientation&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Horizontal"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
        &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1*"&lt;/span&gt;
        &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"120"&lt;/span&gt;
        &lt;span class="na"&gt;MaximumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"250"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Navigation Pane"&lt;/span&gt;
               &lt;span class="na"&gt;HorizontalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt;
               &lt;span class="na"&gt;VerticalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
        &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"2*"&lt;/span&gt;
        &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"250"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Main Content"&lt;/span&gt;
               &lt;span class="na"&gt;HorizontalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt;
               &lt;span class="na"&gt;VerticalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
        &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1*"&lt;/span&gt;
        &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"150"&lt;/span&gt;
        &lt;span class="na"&gt;MaximumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"350"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Details Pane"&lt;/span&gt;
               &lt;span class="na"&gt;HorizontalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt;
               &lt;span class="na"&gt;VerticalTextAlignment&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Center"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

&lt;span class="nt"&gt;&amp;lt;/gridSplitter:SfGridSplitter&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In this example, the navigation pane has a minimum size of 120 units and a maximum of 250 units. The details pane can range from 150 to 350 units.&lt;/p&gt;

&lt;p&gt;These limits help prevent panels from becoming too small or taking up too much space. The final pane size depends on available space, pane constraints, and the sizes of neighboring panes.&lt;/p&gt;

&lt;h2&gt;
  
  
  Choose horizontal or vertical layouts
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://help.syncfusion.com/maui/grid-splitter/splitter-customization#orientation" rel="noopener noreferrer"&gt;Orientation&lt;/a&gt; property determines how panes are arranged and which dimension changes during resizing.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Horizontal:&lt;/strong&gt; Arranges panes side by side. Dragging the separator adjusts their width.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Vertical:&lt;/strong&gt; Arranges panes from top to bottom. Dragging the separator adjusts their height.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;You can combine both orientations to create layouts suited to your application. For example, a horizontal splitter can separate a navigation panel from an editor, while a vertical splitter can divide the editor from an output panel.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build nested layouts in .NET MAUI
&lt;/h2&gt;

&lt;p&gt;A simple two-pane layout may be enough for some applications. However, enterprise applications often need several independently resizable regions.&lt;/p&gt;

&lt;p&gt;Consider an employee management application with profile details, skills, contact information, and an employee summary. Nested Grid Splitters help organize multiple content regions while keeping the layout modular, maintainable, and easy to resize.&lt;/p&gt;

&lt;p&gt;Let’s build this interface with XAML.&lt;/p&gt;

&lt;h3&gt;
  
  
  Quick example: Building an employee profile layout
&lt;/h3&gt;

&lt;p&gt;This example creates three panes at the top of the screen and an employee summary at the bottom. Users can resize the top and bottom sections, as well as the panes within the top section.&lt;/p&gt;

&lt;h4&gt;
  
  
  Step 1: Create a project and install the package
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://learn.microsoft.com/en-us/dotnet/maui/get-started/first-app?view=net-maui-10.0" rel="noopener noreferrer"&gt;Create a .NET MAUI application in Visual Studio&lt;/a&gt;. Install the &lt;a href="https://www.nuget.org/packages/Syncfusion.Maui.GridSplitter" rel="noopener noreferrer"&gt;Syncfusion.Maui.GridSplitter&lt;/a&gt; NuGet package using the NuGet Package Manager or the .NET CLI:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;dotnet add package Syncfusion.Maui.GridSplitter
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Use a package version compatible with your .NET MAUI project.&lt;/p&gt;

&lt;h4&gt;
  
  
  Step 2: Register Syncfusion core
&lt;/h4&gt;

&lt;p&gt;In &lt;strong&gt;MauiProgram.cs&lt;/strong&gt; , register the Syncfusion Core handler:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Syncfusion&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Maui&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Core&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Hosting&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;MauiProgram&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="nc"&gt;MauiApp&lt;/span&gt; &lt;span class="nc"&gt;CreateMauiApp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;builder&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;MauiApp&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;CreateBuilder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="n"&gt;builder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ConfigureSyncfusionCore&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;builder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Build&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Keep any existing application configuration and service registrations in this method.&lt;/p&gt;

&lt;h4&gt;
  
  
  Step 3: Add the Grid Splitter to your XAML page
&lt;/h4&gt;

&lt;p&gt;Declare the Grid Splitter namespace in your page:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight xml"&gt;&lt;code&gt;xmlns:gridSplitter="clr-namespace:Syncfusion.Maui.GridSplitter;assembly=Syncfusion.Maui.GridSplitter"
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Add the following layout inside the page’s content:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight xml"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;gridSplitter:SfGridSplitter&lt;/span&gt;
    &lt;span class="na"&gt;Orientation&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Vertical"&lt;/span&gt;
    &lt;span class="na"&gt;HeightRequest&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"600"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

    &lt;span class="c"&gt;&amp;lt;!-- Top section --&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt; &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"2*"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;gridSplitter:SfGridSplitter&lt;/span&gt;
            &lt;span class="na"&gt;Orientation&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Horizontal"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

            &lt;span class="c"&gt;&amp;lt;!-- Profile pane --&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
                &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1*"&lt;/span&gt;
                &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"180"&lt;/span&gt;
                &lt;span class="na"&gt;IsCollapsible&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"True"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

                &lt;span class="nt"&gt;&amp;lt;VerticalStackLayout&lt;/span&gt; &lt;span class="na"&gt;Padding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"15"&lt;/span&gt; &lt;span class="na"&gt;Spacing&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"8"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Profile"&lt;/span&gt;
                           &lt;span class="na"&gt;FontSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"18"&lt;/span&gt;
                           &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Name"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Alex Johnson"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Role"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Senior Developer"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Experience"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"8 years"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                &lt;span class="nt"&gt;&amp;lt;/VerticalStackLayout&amp;gt;&lt;/span&gt;

            &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

            &lt;span class="c"&gt;&amp;lt;!-- Skills pane --&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
                &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"2*"&lt;/span&gt;
                &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"180"&lt;/span&gt;
                &lt;span class="na"&gt;IsCollapsible&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"True"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

                &lt;span class="nt"&gt;&amp;lt;VerticalStackLayout&lt;/span&gt; &lt;span class="na"&gt;Padding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"15"&lt;/span&gt; &lt;span class="na"&gt;Spacing&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"8"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Skills"&lt;/span&gt;
                           &lt;span class="na"&gt;FontSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"18"&lt;/span&gt;
                           &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;".NET MAUI"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"C#"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"XAML"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"MVVM"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Syncfusion Controls"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                &lt;span class="nt"&gt;&amp;lt;/VerticalStackLayout&amp;gt;&lt;/span&gt;

            &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

            &lt;span class="c"&gt;&amp;lt;!-- Contact pane --&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt;
                &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1.5*"&lt;/span&gt;
                &lt;span class="na"&gt;MinimumSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"180"&lt;/span&gt;
                &lt;span class="na"&gt;IsCollapsible&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"True"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

                &lt;span class="nt"&gt;&amp;lt;VerticalStackLayout&lt;/span&gt; &lt;span class="na"&gt;Padding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"15"&lt;/span&gt; &lt;span class="na"&gt;Spacing&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"8"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Contact"&lt;/span&gt;
                           &lt;span class="na"&gt;FontSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"18"&lt;/span&gt;
                           &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Email"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"alex@example.com"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Phone"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"+1 987 654 3210"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Location"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                    &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Seattle, WA"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
                &lt;span class="nt"&gt;&amp;lt;/VerticalStackLayout&amp;gt;&lt;/span&gt;

            &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SfGridSplitter&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

    &lt;span class="c"&gt;&amp;lt;!-- Bottom section --&amp;gt;&lt;/span&gt;
    &lt;span class="nt"&gt;&amp;lt;gridSplitter:SplitterPane&lt;/span&gt; &lt;span class="na"&gt;Size&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"1.5*"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;

        &lt;span class="nt"&gt;&amp;lt;VerticalStackLayout&lt;/span&gt; &lt;span class="na"&gt;Padding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"20"&lt;/span&gt; &lt;span class="na"&gt;Spacing&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"10"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Employee Summary"&lt;/span&gt;
                   &lt;span class="na"&gt;FontSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"18"&lt;/span&gt;
                   &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;

            &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Alex Johnson"&lt;/span&gt; &lt;span class="na"&gt;FontAttributes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Bold"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Senior Developer"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
            &lt;span class="nt"&gt;&amp;lt;Label&lt;/span&gt; &lt;span class="na"&gt;Text&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Skills: .NET MAUI, C#, XAML, MVVM"&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
        &lt;span class="nt"&gt;&amp;lt;/VerticalStackLayout&amp;gt;&lt;/span&gt;

    &lt;span class="nt"&gt;&amp;lt;/gridSplitter:SplitterPane&amp;gt;&lt;/span&gt;

&lt;span class="nt"&gt;&amp;lt;/gridSplitter:SfGridSplitter&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;How the example works&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The outer &lt;strong&gt;SfGridSplitter&lt;/strong&gt; uses vertical orientation to divide the layout into top and bottom sections. The top section contains a nested &lt;strong&gt;SfGridSplitter&lt;/strong&gt; that arranges the Profile, Skills, and Contact panes side by side.&lt;/p&gt;

&lt;p&gt;The following properties control the layout:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Orientation:&lt;/strong&gt; Determines how panes are arranged.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Size:&lt;/strong&gt; Defines the initial size and proportional distribution of panes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MinimumSize:&lt;/strong&gt; Sets the minimum size of a pane.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;IsCollapsible:&lt;/strong&gt; Allows users to hide and restore a pane.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Users can resize the sections and collapse individual panes to make more room for other content. You can also add data grids, charts, document previews, or other .NET MAUI views to these panes.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fga1pq0a14kfr917fzun8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fga1pq0a14kfr917fzun8.png" alt="Nested .NET MAUI Grid Splitter showing resizable employee profile panes"&gt;&lt;/a&gt;&lt;/p&gt;
Nested .NET MAUI Grid Splitter showing resizable employee profile panes



&lt;h2&gt;
  
  
  Common use cases
&lt;/h2&gt;

&lt;p&gt;The .NET MAUI Grid Splitter is useful for applications that display multiple content areas at once.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
  &lt;colgroup&gt;
    &lt;col&gt;
    &lt;col&gt;
  &lt;/colgroup&gt;
  &lt;thead&gt;
    &lt;tr&gt;
      &lt;th&gt;Application type&lt;/th&gt;
      &lt;th&gt;Example&lt;/th&gt;
    &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
    &lt;tr&gt;
      &lt;td&gt;Dashboards&lt;/td&gt;
      &lt;td&gt;Resize charts, reports, and filter panels.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Developer tools&lt;/td&gt;
      &lt;td&gt;Arrange navigation, editor, and output panels.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Document management&lt;/td&gt;
      &lt;td&gt;Adjust document lists, previews, and metadata panels.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Business applications&lt;/td&gt;
      &lt;td&gt;Organize navigation, forms, and summary views.&lt;/td&gt;
    &lt;/tr&gt;
    &lt;tr&gt;
      &lt;td&gt;Image editing tools&lt;/td&gt;
      &lt;td&gt;Allocate more space to image previews and editing controls.&lt;/td&gt;
    &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: What is the .NET MAUI GridSplitter control?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The .NET MAUI Grid Splitter is a layout control that lets users interactively resize rows and columns within a Grid at runtime. By simply dragging the splitter, users can adjust the space allocated to different sections of the interface, creating more flexible, customizable, and productivity-focused application layouts.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Can the GridSplitter resize both columns and rows?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. The Grid Splitter supports resizing both rows and columns. Set the &lt;strong&gt;Orientation&lt;/strong&gt; property to &lt;strong&gt;Horizontal&lt;/strong&gt; to resize columns or &lt;strong&gt;Vertical&lt;/strong&gt; to resize rows, allowing you to tailor the behavior to your application’s layout.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Does the .NET MAUI Grid Splitter support collapsible panes?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Using the &lt;strong&gt;IsCollapsible&lt;/strong&gt; property, the Grid Splitter can collapse and expand adjacent rows or columns. This allows users to hide secondary content and focus on their primary workspace quickly. Collapsible panes are particularly useful in scenarios such as navigation menus, property panels, tool windows, and master-detail interfaces.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: How can I customize the appearance of the Grid Splitter?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The Grid Splitter provides several styling options to match your application’s design. You can customize properties such as &lt;strong&gt;Background, SeparatorBackground, Size,&lt;/strong&gt; and &lt;strong&gt;SeparatorSize,&lt;/strong&gt; along with other visual settings, to create a splitter that seamlessly integrates with your app’s theme and user experience.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Which platforms are supported by the Syncfusion .NET MAUI Grid Splitter?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The Syncfusion .NET MAUI GridSplitter is supported across all major .NET MAUI platforms, including Android, iOS, macOS (Mac Catalyst), and Windows. This ensures a consistent, responsive resizing experience across mobile, desktop, and tablet devices.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;The Syncfusion &lt;a href="https://www.syncfusion.com/maui-controls/maui-gridsplitter" rel="noopener noreferrer"&gt;.NET MAUI Grid Splitter&lt;/a&gt; makes it easier to build layouts with resizable and collapsible panes. With support for different orientations, configurable pane sizes, customizable separators, and nested splitters, you can organize complex interfaces without implementing the core resizing behavior yourself.&lt;/p&gt;

&lt;p&gt;Explore the Grid Splitter in &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;Essential Studio 2026 Volume 3&lt;/a&gt; and try the available &lt;a href="https://github.com/syncfusion/maui-demos/tree/master/MAUI/GridSplitter" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt; samples. Existing customers can download the latest version from the &lt;a href="https://www.syncfusion.com/sales/pricing" rel="noopener noreferrer"&gt;License and Downloads&lt;/a&gt; page, while new users can start with a &lt;a href="https://www.syncfusion.com/downloads/" rel="noopener noreferrer"&gt;30-day free trial&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;For questions or assistance, visit the Syncfusion &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/import-excel-csv-in-maui-data-grid" rel="noopener noreferrer"&gt;How to Import Excel and CSV Data into a .NET MAUI DataGrid&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/syncfusion-dotnet-maui-2026-volume-3" rel="noopener noreferrer"&gt;What’s New in Syncfusion .NET MAUI 2026 Volume 3: New Controls and Features&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/maui-interactive-viewer-control" rel="noopener noreferrer"&gt;Introducing the .NET MAUI Interactive Viewer Control for Interactive Content&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/fifth-set-open-source-maui-controls" rel="noopener noreferrer"&gt;Introducing the Fifth Set of Open-Source Syncfusion .NET MAUI Controls&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>dotnetmaui</category>
      <category>crossplatform</category>
      <category>desktop</category>
      <category>maui</category>
    </item>
    <item>
      <title>From HTML to Structured Content: Why We Built the Modern Rich Text Editor</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Thu, 22 Oct 2026 15:08:44 +0000</pubDate>
      <link>https://dev.to/syncfusion/from-html-to-structured-content-why-we-built-the-modern-rich-text-editor-lnn</link>
      <guid>https://dev.to/syncfusion/from-html-to-structured-content-why-we-built-the-modern-rich-text-editor-lnn</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Traditional HTML editing can become challenging when applications need consistent, structured content. That’s why Syncfusion introduced its Modern Rich Text Editor in Essential Studio 2026 Volume 3 as a preview. Built on ProseMirror, it brings schema-driven editing and JSON-based document management. Explore why we built it, how HTML and JSON compare, and how to get started with React.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Most rich text editors still treat HTML as the document itself. That approach works well for basic text formatting, but modern applications increasingly need more: structured content, interactive components, reliable change tracking, workflow automation, AI-powered content experiences, and future collaboration capabilities.&lt;/p&gt;

&lt;p&gt;As we evolved our editing platform, we repeatedly encountered limitations that stemmed from a single architectural decision: HTML was acting as both the presentation layer and the source of truth.&lt;/p&gt;

&lt;p&gt;To address these challenges, we built the Syncfusion&lt;sup&gt;®&lt;/sup&gt; &lt;a href="https://www.syncfusion.com/rich-text-editor-sdk/react-modern-rich-text-editor" rel="noopener noreferrer"&gt;Modern Rich Text Editor&lt;/a&gt;, introduced in the Rich Text Editor SDK Volume 3 2026 release. Instead of storing content as HTML, it uses a schema-driven document model powered by the Syncfusion Headless Editor and built on &lt;code&gt;ProseMirror&lt;/code&gt;. Content is stored as structured JSON by default, while HTML remains available whenever applications need it.&lt;/p&gt;

&lt;p&gt;In this blog, we’ll explore the challenges of HTML-based editing, how structured editing addresses them, why we created a new editor instead of extending the existing Rich Text Editor, and how to get started with the Modern Rich Text Editor in React.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why we built the Modern Rich Text Editor
&lt;/h2&gt;

&lt;p&gt;Our existing Rich Text Editor is built around HTML editing. The HTML inside the editor is the document, and every edit modifies that markup directly.&lt;/p&gt;

&lt;p&gt;That model works well for formatting content. However, as customers requested structured content experiences, custom interactive blocks, reliable change information, workflow integration, and pathways toward collaboration and AI-assisted authoring, we repeatedly encountered limitations that could not be solved without rethinking the underlying document model.&lt;/p&gt;

&lt;h2&gt;
  
  
  The challenges of HTML-based editing
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Equivalent Content Can Have Different Markup
&lt;/h3&gt;

&lt;p&gt;The following examples all render identically:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;p&amp;gt;&amp;lt;b&amp;gt;&lt;/span&gt;Release notes&lt;span class="nt"&gt;&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;p&amp;gt;&amp;lt;strong&amp;gt;&lt;/span&gt;Release notes&lt;span class="nt"&gt;&amp;lt;/strong&amp;gt;&amp;lt;/p&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;p&amp;gt;&amp;lt;span&lt;/span&gt; &lt;span class="na"&gt;style&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"font-weight:bold"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;Release notes&lt;span class="nt"&gt;&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Although visually identical, they produce different HTML structures. Browser behavior, pasted content, and editing actions can generate multiple variants over time, making content harder to compare, search, transform, and sanitize consistently.&lt;/p&gt;

&lt;h3&gt;
  
  
  Interactive content can break during editing
&lt;/h3&gt;

&lt;p&gt;Components such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Callouts&lt;/li&gt;
&lt;li&gt;Checklists&lt;/li&gt;
&lt;li&gt;Collapsible sections&lt;/li&gt;
&lt;li&gt;Structured content blocks&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;often depend on HTML structure and CSS classes.&lt;/p&gt;

&lt;p&gt;When users paste content, delete across boundaries, or perform unexpected editing actions, these structures can become invalid or partially broken, leaving content that no longer behaves correctly.&lt;/p&gt;

&lt;h3&gt;
  
  
  HTML doesn’t describe user intent
&lt;/h3&gt;

&lt;p&gt;Features such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Autosave&lt;/li&gt;
&lt;li&gt;Audit history&lt;/li&gt;
&lt;li&gt;Comments&lt;/li&gt;
&lt;li&gt;Review workflows&lt;/li&gt;
&lt;li&gt;Track changes&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;need meaningful change information.&lt;/p&gt;

&lt;p&gt;Comparing HTML only indicates that markup changed. It doesn’t tell applications that:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A heading was added&lt;/li&gt;
&lt;li&gt;A paragraph became a list&lt;/li&gt;
&lt;li&gt;A checklist item was completed&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Extending the editor becomes increasingly complex
&lt;/h3&gt;

&lt;p&gt;As more features are added, each one must account for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Browser editing behavior&lt;/li&gt;
&lt;li&gt;Copy and paste&lt;/li&gt;
&lt;li&gt;Serialization&lt;/li&gt;
&lt;li&gt;Selection handling&lt;/li&gt;
&lt;li&gt;Edge cases&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Over time, new functionality becomes harder to maintain and evolve.&lt;/p&gt;

&lt;h2&gt;
  
  
  How structured editing solves these problems
&lt;/h2&gt;

&lt;p&gt;The Modern Rich Text Editor takes a different approach.&lt;/p&gt;

&lt;p&gt;Instead of treating HTML as the document, it treats content as a structured, typed document model governed by a schema.&lt;/p&gt;

&lt;p&gt;Every edit is validated against rules that define:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Which content is allowed&lt;/li&gt;
&lt;li&gt;Where content can exist&lt;/li&gt;
&lt;li&gt;How content behaves&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;HTML becomes an output format rather than the source of truth.&lt;/p&gt;

&lt;h3&gt;
  
  
  Consistent content representation
&lt;/h3&gt;

&lt;p&gt;Whether users:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Click &lt;strong&gt;Bold&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;Use keyboard shortcuts&lt;/li&gt;
&lt;li&gt;Paste HTML from another source&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;the content is normalized into a single representation within the document model.&lt;/p&gt;

&lt;p&gt;This prevents content drift and creates a canonical format for storage and processing.&lt;/p&gt;

&lt;h3&gt;
  
  
  Schema-protected content blocks
&lt;/h3&gt;

&lt;p&gt;Interactive content such as callouts, checklists, and collapsible sections are defined as document nodes with explicit rules.&lt;/p&gt;

&lt;p&gt;As users edit content, the schema helps maintain valid document structure instead of allowing partially broken markup.&lt;/p&gt;

&lt;h3&gt;
  
  
  Reliable information about changes
&lt;/h3&gt;

&lt;p&gt;Every modification is represented as a structured operation on the document model.&lt;/p&gt;

&lt;p&gt;Applications can understand:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;What changed&lt;/li&gt;
&lt;li&gt;Where it changed&lt;/li&gt;
&lt;li&gt;Which nodes were affected&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;without comparing large HTML strings.&lt;/p&gt;

&lt;h3&gt;
  
  
  Extensibility built into the architecture
&lt;/h3&gt;

&lt;p&gt;New functionality integrates with the document model rather than relying on browser editing behavior.&lt;/p&gt;

&lt;p&gt;Developers can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Execute commands through a typed API&lt;/li&gt;
&lt;li&gt;Customize keyboard shortcuts&lt;/li&gt;
&lt;li&gt;Intercept actions&lt;/li&gt;
&lt;li&gt;Extend behavior through the Headless Editor architecture&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Why we built a new editor instead of modifying the existing one
&lt;/h2&gt;

&lt;p&gt;The limitations discussed above trace back to a fundamental design decision: &lt;strong&gt;&lt;code&gt;HTML is the document&lt;/code&gt;.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Changing that assumption would affect:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Value handling&lt;/li&gt;
&lt;li&gt;Event contracts&lt;/li&gt;
&lt;li&gt;Editing behavior&lt;/li&gt;
&lt;li&gt;Storage strategies&lt;/li&gt;
&lt;li&gt;Existing integrations&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Structured editing isn’t simply a feature.&lt;/p&gt;

&lt;p&gt;It’s a different definition of what the document is.&lt;/p&gt;

&lt;p&gt;Creating a new editor allowed us to deliver a modern, structured foundation without introducing breaking changes for existing Rich Text Editor customers.&lt;/p&gt;

&lt;h2&gt;
  
  
  The architecture behind the Modern Rich Text Editor
&lt;/h2&gt;

&lt;p&gt;The editor was designed around five core principles:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One canonical document model&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Content exists in a structured document model.&lt;/li&gt;
&lt;li&gt;JSON is the default format because it preserves structure directly.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A UI-independent engine&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;The document model, schema, commands, and editing behavior live inside the Syncfusion Headless Editor.&lt;/li&gt;
&lt;li&gt;The user interface sits on top of that foundation.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A proven editing framework&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Rather than building a new editing engine from scratch, we chose &lt;code&gt;ProseMirror&lt;/code&gt; as the underlying document and editing framework.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Explicit change information&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Changes are reported as structured operations instead of requiring HTML diffing.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Programmatic editing&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Formatting and content manipulation are performed through typed commands rather than DOM manipulation.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Why ProseMirror
&lt;/h2&gt;

&lt;p&gt;We chose &lt;code&gt;ProseMirror&lt;/code&gt; because it offers four key capabilities that support our goals:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Schema validation:&lt;/strong&gt; Content must conform to defined document structures.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Transactions:&lt;/strong&gt; Every edit becomes a discrete and describable operation.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Extension architecture:&lt;/strong&gt; New capabilities can be added without rewriting editing behavior.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Future collaboration readiness:&lt;/strong&gt; Its document model was designed to support collaborative editing scenarios and advanced content workflows.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;We built the Syncfusion schema, commands, extensions, and UI experiences on top of that foundation.&lt;/p&gt;

&lt;h2&gt;
  
  
  Understanding the Document Model
&lt;/h2&gt;

&lt;p&gt;With &lt;code&gt;valueFormat="json"&lt;/code&gt;, content is represented as an &lt;code&gt;EditorDocument&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"document"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"schemaVersion"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"children"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"heading"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="nl"&gt;"attrs"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="nl"&gt;"level"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="nl"&gt;"children"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="nl"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nl"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Release checklist"&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;]&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;When HTML is loaded or pasted into the editor, it is parsed into this document model and normalized according to the schema.&lt;/p&gt;

&lt;h2&gt;
  
  
  Choosing between JSON and HTML storage
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Choose JSON when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;You need to query or analyze content.&lt;/li&gt;
&lt;li&gt;AI applications need access to structured content.&lt;/li&gt;
&lt;li&gt;You need to version documents.&lt;/li&gt;
&lt;li&gt;You plan to add review or collaboration features in the future.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Choose HTML when:&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Existing systems consume HTML directly.&lt;/li&gt;
&lt;li&gt;Your primary requirement is to render content immediately.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Recommended approach&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;For many applications, storing content as JSON and generating HTML when needed offers a practical balance. JSON preserves the document structure, while HTML can be used for rendering and indexing.&lt;/p&gt;

&lt;h2&gt;
  
  
  Structured editing: A quick example
&lt;/h2&gt;

&lt;p&gt;Theory is useful, but the best way to understand a structured document model is to see it in action.&lt;/p&gt;

&lt;p&gt;In this example, we’ll build a React application that:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Loads content as a JSON document&lt;/li&gt;
&lt;li&gt;Persists content to storage&lt;/li&gt;
&lt;li&gt;Tracks editing activity&lt;/li&gt;
&lt;li&gt;Adds custom keyboard shortcuts&lt;/li&gt;
&lt;li&gt;Inserts structured content programmatically&lt;/li&gt;
&lt;li&gt;Generates HTML whenever it’s needed&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;This walkthrough uses &lt;a href="https://help.syncfusion.com/rich-text-editor-sdk/react/richtexteditor-ui/getting-started" rel="noopener noreferrer"&gt;React&lt;/a&gt;, Vite, and TypeScript. Equivalent packages are also available for &lt;a href="https://help.syncfusion.com/rich-text-editor-sdk/javascript/richtexteditor-ui/getting-started" rel="noopener noreferrer"&gt;JavaScript&lt;/a&gt;, &lt;a href="https://help.syncfusion.com/rich-text-editor-sdk/angular/richtexteditor-ui/getting-started" rel="noopener noreferrer"&gt;Angular&lt;/a&gt;, and &lt;a href="https://help.syncfusion.com/rich-text-editor-sdk/vue/richtexteditor-ui/getting-started" rel="noopener noreferrer"&gt;Vue&lt;/a&gt; applications.&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;strong&gt;Prerequisites&lt;/strong&gt;
&lt;/h3&gt;

&lt;p&gt;Before you begin, make sure that &lt;code&gt;Node.js&lt;/code&gt; and &lt;code&gt;npm&lt;/code&gt; are installed on your machine. You’ll also need a Syncfusion license key or evaluation trial for development beyond the evaluation period.&lt;/p&gt;

&lt;h3&gt;
  
  
  Create the project and install the packages
&lt;/h3&gt;

&lt;p&gt;Create a new React application with Vite and install the Modern Rich Text Editor packages:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm create vite@latest my-app -- --template react-ts
&lt;span class="nb"&gt;cd&lt;/span&gt; my-app
npm install
npm install @syncfusion/ej2-react-richtexteditor-ui@35.1.37 --save
npm install @syncfusion/ej2-tailwind3-theme@35.1.37 --save
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Add the theme
&lt;/h3&gt;

&lt;p&gt;Import the Tailwind 3 theme into your application stylesheet:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="k"&gt;@import&lt;/span&gt; &lt;span class="s1"&gt;'../node_modules/@syncfusion/ej2-tailwind3-theme/styles/richtexteditor-ui/index.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Create an editor that loads, saves, and audits content
&lt;/h3&gt;

&lt;p&gt;The following example demonstrates several capabilities of the Modern Rich Text Editor:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Loading an &lt;code&gt;EditorDocument&lt;/code&gt; from storage&lt;/li&gt;
&lt;li&gt;Storing content as structured JSON&lt;/li&gt;
&lt;li&gt;Auditing user interactions through events&lt;/li&gt;
&lt;li&gt;Creating custom keyboard shortcuts&lt;/li&gt;
&lt;li&gt;Inserting a callout programmatically using the commands API&lt;/li&gt;
&lt;li&gt;Generating HTML on demand from the document model&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Replace &lt;code&gt;src/App.tsx&lt;/code&gt; with the following code:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;useRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;useState&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'react'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nc"&gt;RichTextEditorUIComponent&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Inject&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;SlashCommand&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nc"&gt;ChangeEventArgs&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ActionCompleteEventArgs&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;EditorDocument&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;EditorKeyBindingMap&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@syncfusion/ej2-react-richtexteditor-ui'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="s1"&gt;'./App.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="no"&gt;STORAGE_KEY&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'release-notes-doc'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;defaultDocument&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;EditorDocument&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'document'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;attrs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;marks&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;schemaVersion&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'heading'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;attrs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;level&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'text'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Release checklist'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'paragraph'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'text'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Ship the '&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'text'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'beta'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;marks&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'bold'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'text'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;' on Friday.'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// Restore saved content, falling back to the default if it's missing or malformed.&lt;/span&gt;
&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;loadDocument&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;EditorDocument&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;saved&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;localStorage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getItem&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;STORAGE_KEY&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;saved&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;defaultDocument&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;parsed&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;saved&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;parsed&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'document'&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;Array&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;isArray&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;parsed&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="n"&gt;parsed&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;defaultDocument&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;defaultDocument&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;// Custom shortcuts. Ctrl maps to Cmd on macOS automatically.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;keyBindings&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;EditorKeyBindingMap&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="s1"&gt;'code-block'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'ctrl+alt+c'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;checklist&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'ctrl+alt+l'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;editorRef&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;useRef&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;RichTextEditorUIComponent&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;initialDocument&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;loadDocument&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setStatus&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'No changes yet'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;persist&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;EditorDocument&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;localStorage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;setItem&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;STORAGE_KEY&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// Replace with your API call.&lt;/span&gt;
      &lt;span class="nf"&gt;setStatus&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`Saved at ${new Date().toLocaleTimeString()}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;catch&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nf"&gt;setStatus&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'Save failed. Your changes are still in the editor.'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="c1"&gt;// Fires when content is committed: on blur, after the autosave interval, or after save().&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;onChange&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;ChangeEventArgs&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;persist&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="c1"&gt;// Log user-initiated edits that changed the document, for example for an audit trail.&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;onActionComplete&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;ActionCompleteEventArgs&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;isInteracted&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;documentChanged&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;info&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`[audit] ${args.action} (${args.actionId})`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;saveNow&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;persist&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;editorRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getDocument&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;insertCallout&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;editorRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;commands&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;callout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;callout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'info'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;apply&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;logHtml&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;editorRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getHtml&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"App"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;RichTextEditorUIComponent&lt;/span&gt;
        &lt;span class="n"&gt;ref&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;editorRef&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"400px"&lt;/span&gt;
        &lt;span class="n"&gt;valueFormat&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"json"&lt;/span&gt;
        &lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;initialDocument&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;placeholder&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Type / for commands"&lt;/span&gt;
        &lt;span class="n"&gt;slashCommandSettings&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;enable&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;keyBindings&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;keyBindings&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;change&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;onChange&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;actionComplete&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;onActionComplete&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Inject&lt;/span&gt; &lt;span class="n"&gt;services&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;SlashCommand&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;RichTextEditorUIComponent&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;saveNow&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Save&lt;/span&gt; &lt;span class="n"&gt;now&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;insertCallout&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Insert&lt;/span&gt; &lt;span class="n"&gt;info&lt;/span&gt; &lt;span class="n"&gt;callout&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;logHtml&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Log&lt;/span&gt; &lt;span class="no"&gt;HTML&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Run the application
&lt;/h3&gt;

&lt;p&gt;Start the development server:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Once the editor loads, try the following:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Type &lt;code&gt;/&lt;/code&gt; and insert a heading, checklist, or another supported block. Click outside the editor to commit the change and trigger persistence.&lt;/li&gt;
&lt;li&gt;Refresh the page. The editor restores the previously saved JSON document from local storage.&lt;/li&gt;
&lt;li&gt;Press &lt;code&gt;Ctrl + Alt + L&lt;/code&gt; to create a checklist using the custom keyboard shortcut.&lt;/li&gt;
&lt;li&gt;Click &lt;code&gt;Log HTML&lt;/code&gt; and inspect the browser console to see the HTML generated from the structured document model.&lt;/li&gt;
&lt;li&gt;Open the console and perform formatting actions. User-initiated edits that modify the document appear as audit entries.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;This example highlights one of the key differences between the Modern Rich Text Editor and traditional HTML-based editors: content is stored as a structured document and HTML is generated only when you need it. That gives applications a consistent content model for storage, processing, and future workflow integration while preserving HTML compatibility for rendering and publishing.&lt;/p&gt;

&lt;h2&gt;
  
  
  Extending the editor
&lt;/h2&gt;

&lt;p&gt;The Modern Rich Text Editor supports multiple customization layers.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Extension Point&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&amp;nbsp;&lt;strong&gt;Use Case&lt;/strong&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&lt;strong&gt;keyBindings&lt;/strong&gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Customize keyboard shortcuts&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&lt;strong&gt;commands()&lt;/strong&gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Execute actions from custom UI&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;&lt;strong&gt;actionBegin&lt;/strong&gt;&lt;/code&gt; / &lt;code&gt;&lt;strong&gt;actionComplete&lt;/strong&gt;&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Intercept, cancel, or audit actions&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Toolbar and Slash Commands&lt;/td&gt;
&lt;td&gt;Customize authoring experiences&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;For deeper customization, developers can leverage the Headless Editor’s schema system, extension architecture, migration support, and custom &lt;code&gt;NodeViews&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Migrating existing HTML content
&lt;/h2&gt;

&lt;p&gt;Migration doesn’t have to be all-or-nothing.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Continue loading existing HTML.&lt;/li&gt;
&lt;li&gt;Evaluate real-world content inside the editor.&lt;/li&gt;
&lt;li&gt;Convert content into structured JSON.&lt;/li&gt;
&lt;li&gt;Store both representations.&lt;/li&gt;
&lt;li&gt;Transition applications to JSON when ready.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;This approach minimizes migration risk while allowing teams to adopt structured editing incrementally.&lt;/p&gt;

&lt;h2&gt;
  
  
  Production considerations
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Stored JSON compatibility:&lt;/strong&gt; Keep &lt;code&gt;schemaVersion&lt;/code&gt; with every stored document so you can detect and migrate older content.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sanitization:&lt;/strong&gt; Treat HTML produced from user content as untrusted wherever you render it outside the editor. Sanitize it on output, and validate link URLs and image sources in your back end.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Persistence:&lt;/strong&gt; The change event fires on commit, not on every keystroke. Pair it with an explicit save action for forms, and save before navigation in single-page apps.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Server-side rendering:&lt;/strong&gt; The editor needs a browser DOM. In SSR frameworks such as Next.js, render it only on the client.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Accessibility:&lt;/strong&gt; The product page lists &lt;a href="https://www.syncfusion.com/rich-text-editor-sdk/react-modern-rich-text-editor" rel="noopener noreferrer"&gt;WAI-ARIA and keyboard support&lt;/a&gt;. Still, test the blocks your users actually create (tables, callouts, collapsible sections) with your screen readers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Bundle size:&lt;/strong&gt; Features such as slash commands are separate modules that you inject only when needed. Measure your build to confirm the effect in your app.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Areas we’re exploring
&lt;/h2&gt;

&lt;p&gt;The structured document model creates a foundation for future capabilities such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;AI-assisted authoring&lt;/li&gt;
&lt;li&gt;Comments&lt;/li&gt;
&lt;li&gt;Review workflows&lt;/li&gt;
&lt;li&gt;Track changes&lt;/li&gt;
&lt;li&gt;Real-time collaboration&lt;/li&gt;
&lt;li&gt;Advanced paste cleanup&lt;/li&gt;
&lt;li&gt;Additional import/export formats&lt;/li&gt;
&lt;/ul&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; &lt;em&gt;These capabilities are not included in version Essential Studio 35.1.37 and should not be interpreted as release commitments.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Evaluation checklist
&lt;/h2&gt;

&lt;p&gt;Before adopting the Modern Rich Text Editor:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Validate real content against the editor schema&lt;/li&gt;
&lt;li&gt;Decide on JSON, HTML, or hybrid storage&lt;/li&gt;
&lt;li&gt;Design save behavior around commit timing&lt;/li&gt;
&lt;li&gt;Sanitize generated HTML where required&lt;/li&gt;
&lt;li&gt;Test keyboard and accessibility workflows&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: What is the Modern Rich Text Editor?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;It’s a &lt;strong&gt;WYSIWYG&lt;/strong&gt; editor in the Syncfusion Rich Text Editor SDK that stores content as a structured document instead of as HTML. You format text with the toolbar or slash commands as usual, but behind the scenes every paragraph, heading, list, and piece of formatting is saved as a typed node in a JSON document. It’s built on the Syncfusion Headless Editor, which uses &lt;strong&gt;&lt;code&gt;ProseMirror&lt;/code&gt;&lt;/strong&gt; as its editing engine.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: What does structured editing mean in simple terms?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;In HTML editing, the editor saves whatever markup is on screen, so the same bold word can be stored as &lt;strong&gt;&lt;code&gt;&amp;lt;b&amp;gt;&lt;/code&gt;&lt;/strong&gt; , &lt;strong&gt;&lt;code&gt;&amp;lt;strong&amp;gt;&lt;/code&gt;&lt;/strong&gt; , or a styled &lt;strong&gt;&lt;code&gt;&amp;lt;span&amp;gt;&lt;/code&gt;&lt;/strong&gt;. In structured editing, the editor keeps a clean data model of the content, such as “a level 2 heading” or “the word beta with a bold mark,” and checks every edit against a set of rules called a schema. The screen is only a view of that model, so content is stored the same way every time, no matter how it was typed or pasted.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Can I still get HTML from the editor?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Call &lt;code&gt;getHtml()&lt;/code&gt; at any time to get the current content as an HTML string, for example, to display it on a page, send it in an email, or index it for search. To make the value property itself an HTML string, set &lt;code&gt;valueFormat&lt;/code&gt; to &lt;code&gt;html&lt;/code&gt;. For plain text, call &lt;code&gt;getText()&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Can I load the HTML content I already have?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Set &lt;code&gt;valueFormat&lt;/code&gt; to &lt;code&gt;html&lt;/code&gt; and pass your existing HTML as value. The editor converts it into its document model, so different markup for the same formatting is cleaned up into one form. Markup the editor doesn’t support may be simplified or removed, so test with a sample of your real content first. The “Migrating existing HTML content” section walks through a step-by-step approach.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Can I customize or extend the editor?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes, at two levels. In the Modern Rich Text Editor, you can change keyboard shortcuts (&lt;code&gt;keyBindings&lt;/code&gt;), apply formatting from your own buttons (&lt;code&gt;commands()&lt;/code&gt;), intercept, cancel, or log user actions (&lt;code&gt;actionBegin&lt;/code&gt; and &lt;code&gt;actionComplete&lt;/code&gt;), and choose which toolbar and slash command items appear. For bigger changes, such as defining your own content types with custom schemas and &lt;code&gt;NodeViews&lt;/code&gt;, use the extension architecture of the Headless Editor.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://www.syncfusion.com/rich-text-editor-sdk/react-modern-rich-text-editor" rel="noopener noreferrer"&gt;Modern Rich Text Editor&lt;/a&gt; represents a fundamental shift from HTML-centric editing to structured document editing.&lt;/p&gt;

&lt;p&gt;By treating content as a schema-driven document model rather than raw HTML, it provides consistent content representation, richer change information, stronger extensibility, and a foundation for modern content workflows.&lt;/p&gt;

&lt;p&gt;If you’re evaluating editor architectures for your next application, the Modern Rich Text Editor provides a path to structured content while preserving compatibility with existing HTML workflows.&lt;/p&gt;

&lt;p&gt;Start with the &lt;a href="https://help.syncfusion.com/rich-text-editor-sdk/react/richtexteditor-ui/getting-started" rel="noopener noreferrer"&gt;React Getting started guide&lt;/a&gt;, explore the &lt;a href="https://ej2.syncfusion.com/react/demos/#/tailwind3/rich-text-editor-ui/basic-editing" rel="noopener noreferrer"&gt;live demo&lt;/a&gt;, and tell us what you’d like to build next. You can explore the complete &lt;a href="https://www.syncfusion.com/products/whatsnew" rel="noopener noreferrer"&gt;What’s New&lt;/a&gt; and &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;release notes&lt;/a&gt; pages to discover the features most relevant to your project.&lt;/p&gt;

&lt;p&gt;For existing Syncfusion customers, the latest version of Essential Studio is available from the &lt;a href="https://www.syncfusion.com/sales/pricing" rel="noopener noreferrer"&gt;license and downloads&lt;/a&gt; page. New users can explore the capabilities through the &lt;a href="https://www.syncfusion.com/downloads" rel="noopener noreferrer"&gt;30-day free trial&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;If you have questions or feedback, reach out through our &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/react-rich-text-editor-mentions" rel="noopener noreferrer"&gt;How to Add Mentions and Slash Commands in a React Rich Text Editor&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/react-rich-text-editor-xss-prevention" rel="noopener noreferrer"&gt;How to Prevent XSS Attacks in React Rich Text Editor&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/merge-fields-in-react-rich-text-editor" rel="noopener noreferrer"&gt;How to Use Merge Fields in React Rich Text Editor for Dynamic Content&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/emojis-in-react-rich-text-editor" rel="noopener noreferrer"&gt;Introducing Emoji Icons Support in the React Rich Text Editor&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>react</category>
      <category>reactdevelopment</category>
      <category>richtexteditor</category>
      <category>contentmanagement</category>
    </item>
    <item>
      <title>C# 15 Union Types for API Results: Examples, Trade-Offs, and Migration</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Wed, 21 Oct 2026 14:17:46 +0000</pubDate>
      <link>https://dev.to/syncfusion/c-15-union-types-for-api-results-examples-trade-offs-and-migration-42h2</link>
      <guid>https://dev.to/syncfusion/c-15-union-types-for-api-results-examples-trade-offs-and-migration-42h2</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;C# 15 union types let you represent a fixed set of possible outcomes, making API results clearer and helping the compiler identify unhandled cases. Learn how to use them in ASP.NET Core, compare them with Result, interfaces, and exceptions, and understand the trade-offs, serialization limits, and migration considerations before adopting them.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Imagine building an e-commerce API that creates orders. An order might be created successfully, rejected because the quantity is invalid, or failed because the requested product cannot be found.&lt;/p&gt;

&lt;p&gt;Your code needs to handle each outcome correctly. A return type that does not clearly represent these possibilities can leave callers checking flags, interpreting ambiguous values, or using exceptions for expected business outcomes.&lt;/p&gt;

&lt;p&gt;C# 15 introduces union types, which let you define a fixed set of possible types for a value. The compiler can then help identify cases that a switch expression does not handle.&lt;/p&gt;

&lt;p&gt;Union types are a preview feature in the .NET 11 development cycle. Their syntax and supporting behavior may change before the final release, so verify the latest &lt;a href="https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-15" rel="noopener noreferrer"&gt;C# 15 documentation&lt;/a&gt; before adopting them.&lt;/p&gt;

&lt;h2&gt;
  
  
  What is C# 15 union types?
&lt;/h2&gt;

&lt;p&gt;A union type represents a value that can be one of several predefined types. Unlike an interface or base class, its case types do not need to share an inheritance hierarchy.&lt;/p&gt;

&lt;p&gt;For example, an order-processing operation can produce three outcomes:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The order is created successfully.&lt;/li&gt;
&lt;li&gt;The request is invalid.&lt;/li&gt;
&lt;li&gt;The requested product cannot be found.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;You can represent these outcomes using records and a union:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;record&lt;/span&gt; &lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Guid&lt;/span&gt; &lt;span class="nc"&gt;OrderId&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;record&lt;/span&gt; &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;Message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;record&lt;/span&gt; &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;ProductCode&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="n"&gt;union&lt;/span&gt; &lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;CreateOrderResult&lt;/code&gt; union can contain an &lt;code&gt;OrderCreated&lt;/code&gt;, &lt;code&gt;InvalidOrder&lt;/code&gt;, or &lt;code&gt;ProductNotFound&lt;/code&gt; value.&lt;/p&gt;

&lt;p&gt;You can assign a case directly to the union because the compiler provides implicit conversions from its declared case types:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Guid&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;NewGuid&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If more than one case type is equally applicable to a source value, the conversion is ambiguous and the compiler reports an error. Use distinct case types or explicitly create the intended case to avoid ambiguity.&lt;/p&gt;

&lt;h2&gt;
  
  
  Handle every case with pattern matching
&lt;/h2&gt;

&lt;p&gt;One of the most useful features of union types is exhaustive pattern matching.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;DescribeResult&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
    &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="k"&gt;switch&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nc"&gt;OrderCreated&lt;/span&gt; &lt;span class="n"&gt;created&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
            $&lt;span class="s2"&gt;"Order {created.OrderId} was created."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt; &lt;span class="n"&gt;invalid&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
            $&lt;span class="s2"&gt;"Invalid order: {invalid.Message}"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

        &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt; &lt;span class="n"&gt;notFound&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
            $&lt;span class="s2"&gt;"Product {notFound.ProductCode} was not found."&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The switch expression handles every declared case. If you add another case to &lt;code&gt;CreateOrderResult&lt;/code&gt;, the compiler can report an incomplete switch expression with warning &lt;code&gt;CS8509&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;You can make this warning fail the build by adding the following configuration to your project file:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight xml"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;PropertyGroup&amp;gt;&lt;/span&gt;
   &lt;span class="nt"&gt;&amp;lt;WarningsAsErrors&amp;gt;&lt;/span&gt;$(WarningsAsErrors);CS8509&lt;span class="nt"&gt;&amp;lt;/WarningsAsErrors&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/PropertyGroup&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This is useful when an operation has a known set of outcomes and every caller must consider each possibility. For details, see Microsoft’s &lt;a href="https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/union" rel="noopener noreferrer"&gt;C# union types reference&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Using C# 15 union types in ASP.NET Core APIs
&lt;/h2&gt;

&lt;p&gt;Union types can separate business outcomes from HTTP response handling. The application service determines what happened, while the controller maps that outcome to an appropriate HTTP response.&lt;/p&gt;

&lt;p&gt;Let’s implement a simplified order-creation API.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 1: Define the request and service
&lt;/h3&gt;

&lt;p&gt;Use the &lt;code&gt;CreateOrderResult&lt;/code&gt; union from the previous section.&lt;/p&gt;

&lt;p&gt;First, define the request and service interface:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;record&lt;/span&gt; &lt;span class="nc"&gt;CreateOrderRequest&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;ProductCode&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="nc"&gt;Quantity&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="nc"&gt;IOrderService&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;CreateAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="nc"&gt;CreateOrderRequest&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;CancellationToken&lt;/span&gt; &lt;span class="n"&gt;cancellationToken&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The service returns one of the declared result types:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;OrderService&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;IOrderService&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;CreateAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="nc"&gt;CreateOrderRequest&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;CancellationToken&lt;/span&gt; &lt;span class="n"&gt;cancellationToken&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Quantity&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;FromResult&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                    &lt;span class="s2"&gt;"Quantity must be greater than zero."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;

        &lt;span class="c1"&gt;// A real application would query its product catalog here.&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nc"&gt;ProductExists&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ProductCode&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;FromResult&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ProductCode&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;

        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;FromResult&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
            &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Guid&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;NewGuid&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;private&lt;/span&gt; &lt;span class="k"&gt;static&lt;/span&gt; &lt;span class="kt"&gt;bool&lt;/span&gt; &lt;span class="nc"&gt;ProductExists&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="n"&gt;productCode&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
        &lt;span class="n"&gt;productCode&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Equals&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
            &lt;span class="s2"&gt;"P100"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="nc"&gt;StringComparison&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;OrdinalIgnoreCase&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This simplified service validates the quantity, checks product availability, and returns the corresponding result. In a production application, replace the example product check and generated order ID with actual catalog and order-creation logic.&lt;/p&gt;

&lt;p&gt;Register the service with dependency injection:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="n"&gt;builder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Services&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddScoped&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;IOrderService&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;OrderService&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Step 2: Map the results to HTTP responses
&lt;/h3&gt;

&lt;p&gt;The controller handles each result and returns the appropriate HTTP status code.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="nc"&gt;Microsoft&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AspNetCore&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Mvc&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;ApiController&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;Route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"api/orders"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;sealed&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;OrdersController&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;ControllerBase&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;private&lt;/span&gt; &lt;span class="k"&gt;readonly&lt;/span&gt; &lt;span class="nc"&gt;IOrderService&lt;/span&gt; &lt;span class="n"&gt;_orderService&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="nc"&gt;OrdersController&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;IOrderService&lt;/span&gt; &lt;span class="n"&gt;orderService&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;_orderService&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;orderService&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;HttpPost&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;ProducesResponseType&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="k"&gt;typeof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status201Created&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;ProducesResponseType&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="k"&gt;typeof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;ProblemDetails&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status400BadRequest&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;ProducesResponseType&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="k"&gt;typeof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;ProblemDetails&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status404NotFound&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;IActionResult&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;Create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="nc"&gt;CreateOrderRequest&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nc"&gt;CancellationToken&lt;/span&gt; &lt;span class="n"&gt;cancellationToken&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
            &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;_orderService&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;CreateAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="n"&gt;cancellationToken&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="k"&gt;switch&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="nc"&gt;OrderCreated&lt;/span&gt; &lt;span class="n"&gt;created&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
                &lt;span class="nc"&gt;CreatedAtAction&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                    &lt;span class="nf"&gt;nameof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;GetById&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;created&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;OrderId&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="n"&gt;created&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

            &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt; &lt;span class="n"&gt;invalid&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
                &lt;span class="nc"&gt;BadRequest&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;ProblemDetails&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="nc"&gt;Title&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Invalid order"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Detail&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;invalid&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Message&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Status&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status400BadRequest&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Extensions&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
                    &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"code"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"invalid_order"&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;

            &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt; &lt;span class="n"&gt;notFound&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
                &lt;span class="nc"&gt;NotFound&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;ProblemDetails&lt;/span&gt;
                &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="nc"&gt;Title&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Product not found"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Detail&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
                        $&lt;span class="s2"&gt;"Product {notFound.ProductCode} was not found."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Status&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status404NotFound&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="nc"&gt;Extensions&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
                    &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"code"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"product_not_found"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                        &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"productCode"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;notFound&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ProductCode&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;HttpGet&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"{id:guid}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;ProducesResponseType&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;StatusCodes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Status200OK&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="nc"&gt;IActionResult&lt;/span&gt; &lt;span class="nc"&gt;GetById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Guid&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Ok&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;OrderId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The example maps each business outcome to an HTTP response:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Business outcome&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;HTTP response&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Order created&lt;/td&gt;
&lt;td&gt;201 Created&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Invalid order&lt;/td&gt;
&lt;td&gt;400 Bad Request&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Product not found&lt;/td&gt;
&lt;td&gt;404 Not Found&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The service does not need to know about HTTP status codes. The controller handles that responsibility and returns &lt;code&gt;ProblemDetails&lt;/code&gt; for the error responses.&lt;/p&gt;

&lt;p&gt;The example’s status codes and response bodies are illustrative. An actual API should follow its documented contract and established error-handling conventions.&lt;/p&gt;

&lt;p&gt;The key benefit is that the controller handles each declared result explicitly. If you add a case such as &lt;code&gt;InsufficientInventory&lt;/code&gt;, the compiler can help identify switch expressions that need updating.&lt;/p&gt;

&lt;h2&gt;
  
  
  Union types vs. existing C# approaches
&lt;/h2&gt;

&lt;p&gt;Union types are not a replacement for every result-handling pattern. The right choice depends on the problem your application needs to solve.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Approach&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Best suited for&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Main consideration&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nullable return value&lt;/td&gt;
&lt;td&gt;A value may be absent, and that is the only alternative&lt;/td&gt;
&lt;td&gt;Does not describe several distinct outcomes&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Exceptions&lt;/td&gt;
&lt;td&gt;Unexpected failures that cannot be handled locally&lt;/td&gt;
&lt;td&gt;Can obscure expected business outcomes if overused&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&lt;strong&gt;Result&amp;lt;T&amp;gt;&lt;/strong&gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;A consistent success-or-failure pattern across operations&lt;/td&gt;
&lt;td&gt;May need additional modeling for multiple distinct outcomes&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;&lt;strong&gt;OneOf&lt;/strong&gt;&lt;/code&gt; or a similar library&lt;/td&gt;
&lt;td&gt;Union-like behavior before native unions are available&lt;/td&gt;
&lt;td&gt;Adds a dependency and library-specific conventions&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Interfaces or abstract records&lt;/td&gt;
&lt;td&gt;Types that share behavior or an extensible contract&lt;/td&gt;
&lt;td&gt;Do not inherently provide the same closed-case checking&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;C# 15 union types&lt;/td&gt;
&lt;td&gt;A value must be one of a fixed set of alternatives&lt;/td&gt;
&lt;td&gt;Requires preview-feature adoption and compatibility evaluation&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Union types vs. Result
&lt;/h2&gt;

&lt;p&gt;A &lt;code&gt;Result&amp;lt;T&amp;gt;&lt;/code&gt; abstraction can be a good choice when an application needs consistent error handling, validation details, or helper methods for chaining operations.&lt;/p&gt;

&lt;p&gt;Union types are especially useful when an operation has several distinct outcomes that callers should handle separately.&lt;/p&gt;

&lt;p&gt;For example, an inventory operation might return &lt;code&gt;InventoryReserved&lt;/code&gt;, &lt;code&gt;ProductNotFound&lt;/code&gt;, or &lt;code&gt;InsufficientInventory&lt;/code&gt;. Each case communicates a specific outcome.&lt;/p&gt;

&lt;p&gt;If your existing &lt;code&gt;Result&amp;lt;T&amp;gt;&lt;/code&gt; implementation already handles the problem well, switching to union types simply because they are newer may not justify the migration cost.&lt;/p&gt;

&lt;h2&gt;
  
  
  Union types vs. interfaces
&lt;/h2&gt;

&lt;p&gt;Interfaces are appropriate when different implementations must share a contract and new implementations may be introduced by other parts of the application.&lt;/p&gt;

&lt;p&gt;Union types are better suited to a deliberately closed set of alternatives. The compiler knows which cases belong to the union and can help verify that all cases are handled.&lt;/p&gt;

&lt;p&gt;A closed class hierarchy may also be suitable when the cases are related classes that naturally share a base type. Consider a union when the alternatives are unrelated types or should not be forced into a common inheritance hierarchy.&lt;/p&gt;

&lt;h2&gt;
  
  
  When should you use union types?
&lt;/h2&gt;

&lt;p&gt;Union types are worth evaluating when an application has a known set of outcomes, and every caller should consider them deliberately.&lt;/p&gt;

&lt;p&gt;Consider them when:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;An API operation returns several expected business outcomes.&lt;/li&gt;
&lt;li&gt;A domain model has a fixed set of result types.&lt;/li&gt;
&lt;li&gt;Existing result objects permit confusing or contradictory combinations.&lt;/li&gt;
&lt;li&gt;You want compiler feedback when new cases are added.&lt;/li&gt;
&lt;li&gt;Your team controls the relevant consumers and can manage compatibility changes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;An existing approach may be more suitable when:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Your production environment cannot use preview features.&lt;/li&gt;
&lt;li&gt;External consumers need to introduce their own implementations.&lt;/li&gt;
&lt;li&gt;An established result abstraction already meets your needs.&lt;/li&gt;
&lt;li&gt;A public library cannot easily manage source-compatibility changes.&lt;/li&gt;
&lt;li&gt;A nullable value or simpler result type is sufficient.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Consider performance for value types
&lt;/h2&gt;

&lt;p&gt;Compiler-generated union declarations use an &lt;code&gt;object?&lt;/code&gt; reference to hold the active value. As a result, value-type cases are boxed in the standard generated representation.&lt;/p&gt;

&lt;p&gt;This does not automatically make union types too slow. However, if your union contains value types and is used in a performance-sensitive area, measure the actual workload. The C# union model also supports custom implementations that can avoid boxing by providing an appropriate access pattern.&lt;/p&gt;

&lt;p&gt;See Microsoft’s &lt;a href="https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/union" rel="noopener noreferrer"&gt;union types reference&lt;/a&gt; for implementation details.&lt;/p&gt;

&lt;h2&gt;
  
  
  What should you consider before migrating?
&lt;/h2&gt;

&lt;p&gt;Changing a method’s return type is only one part of adopting union types. Callers, public contracts, and serialized data may also be affected.&lt;/p&gt;

&lt;p&gt;Follow these steps to plan the migration.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Review the existing result model.&lt;/strong&gt; Identify methods that return custom result classes, callers that inspect success flags, and code that depends on existing error properties.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Define meaningful cases.&lt;/strong&gt; Create a separate type for each outcome that carries distinct information. Avoid cases that represent the same business meaning under different names.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Migrate internal consumers first.&lt;/strong&gt; Introduce the union in a controlled area and update the relevant switch expressions. Keep existing HTTP response formats unchanged if clients are not intended to see a contract change.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test compatibility before removing the old model.&lt;/strong&gt; Check response status codes, response bodies, OpenAPI descriptions, generated clients, and any persisted or transmitted data that depends on the old result type.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Adding a union case can require existing consumers to change their code. For public APIs and libraries, review this impact before releasing the new case.&lt;/p&gt;

&lt;h2&gt;
  
  
  A note on JSON serialization
&lt;/h2&gt;

&lt;p&gt;Starting with .NET 11, &lt;code&gt;System.Text.Json&lt;/code&gt; supports serialization and deserialization of C# union types. The serializer writes the active case and must identify the correct case when reading JSON.&lt;/p&gt;

&lt;p&gt;For example:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nc"&gt;JsonUnion&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nc"&gt;TypeClassifier&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;typeof&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;JsonUnionTypeStructuralClassifier&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="n"&gt;union&lt;/span&gt; &lt;span class="nc"&gt;CreateOrderResult&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nc"&gt;OrderCreated&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;InvalidOrder&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nc"&gt;ProductNotFound&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The structural classifier can distinguish object cases using their root-level properties. For this to work, the case shapes must be sufficiently distinct.&lt;/p&gt;

&lt;p&gt;For example, two cases with overlapping property structures may be ambiguous. Likewise, &lt;code&gt;Guid&lt;/code&gt; and &lt;code&gt;string&lt;/code&gt; both use JSON strings, so the default classifier cannot distinguish them reliably. A custom classifier may be needed when the default rules cannot select one case.&lt;/p&gt;

&lt;p&gt;With &lt;code&gt;JsonSerializerOptions.Web&lt;/code&gt;, an int may also be read from a JSON string. This can make &lt;code&gt;int&lt;/code&gt; and &lt;code&gt;string&lt;/code&gt; union cases ambiguous during deserialization, requiring a custom classifier.&lt;/p&gt;

&lt;p&gt;Keep these points in mind:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;JSON serialization does not automatically guarantee that every union can be deserialized unambiguously.&lt;/li&gt;
&lt;li&gt;Changes to property names or required properties may affect how a structural classifier identifies a case.&lt;/li&gt;
&lt;li&gt;If you control the JSON contract and need a stable discriminator, a closed hierarchy with explicit polymorphic serialization may be more appropriate.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In the ASP.NET Core example above, the controller maps the result into an HTTP response rather than returning the union itself. Therefore, the union is an application-layer result and does not automatically become the API’s JSON contract.&lt;/p&gt;

&lt;p&gt;For the supported classifiers and limitations, see Microsoft’s &lt;a href="https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/union-types" rel="noopener noreferrer"&gt;System.Text.Json union serialization documentation&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: Can a C# 15 union contain null?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. A union can include a nullable case type, such as &lt;code&gt;string?&lt;/code&gt;. The default value of a generated union can also have no active case, so some switch expressions may need to account for &lt;code&gt;null&lt;/code&gt;. If &lt;code&gt;null&lt;/code&gt; represents a meaningful business outcome, a named case type usually communicates the intent more clearly.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: Can a union contain value types such as int or Guid?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. Value types can be union cases. The standard compiler-generated representation stores the value through an &lt;code&gt;object?&lt;/code&gt; reference, so value-type cases are boxed. Consider performance testing if the union is used in an allocation-sensitive part of the application.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Do C# 15 union types require a NuGet package?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Native union declarations do not require a third-party union package. They do require a compatible C# compiler and .NET SDK. Check the current preview requirements before creating a project.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Can union types replace enums?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Not in every situation. Enums work well for simple named states. Union types are more useful when each alternative has a different type, carries different data, or requires different handling.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q5: Are C# 15 union types ready for production?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Union types remain a preview feature in the C# 15 and .NET 11 development cycle. Their syntax and supporting behavior may change before the final release.&lt;/p&gt;

&lt;p&gt;Try them in a controlled project first. Verify the SDK and compiler versions, and test serialization, API contracts, tooling, and performance before considering production adoption.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;C# 15 union types provide a way to represent a fixed set of possible outcomes and help developers identify unhandled cases during compilation.&lt;/p&gt;

&lt;p&gt;For ASP.NET Core APIs, they can make business results explicit while allowing controllers to map those results to HTTP responses. They can also represent closed sets of domain states without forcing unrelated types into a shared inheritance hierarchy.&lt;/p&gt;

&lt;p&gt;Union types are not automatically better than &lt;code&gt;Result&amp;lt;T&amp;gt;&lt;/code&gt;, interfaces, exceptions, or existing libraries. Their value depends on whether the application benefits from a closed set of alternatives and compiler-checked handling.&lt;/p&gt;

&lt;p&gt;Before adopting them, evaluate the feature in a controlled project, verify the current preview behavior, and test compatibility with your API contracts. Choose union types when they solve a real modeling problem, not simply because they are a new C# feature.&lt;/p&gt;

</description>
      <category>aspnetcore</category>
      <category>dotnetdevelopment</category>
      <category>csharp</category>
      <category>architecture</category>
    </item>
    <item>
      <title>What’s New in Syncfusion Document SDKs 2026 Volume 3: AI Chunking, PDF Security, and Data Extraction</title>
      <dc:creator>Jollen Moyani</dc:creator>
      <pubDate>Fri, 16 Oct 2026 14:52:27 +0000</pubDate>
      <link>https://dev.to/syncfusion/whats-new-in-syncfusion-document-sdks-2026-volume-3-ai-chunking-pdf-security-and-data-extraction-3c8b</link>
      <guid>https://dev.to/syncfusion/whats-new-in-syncfusion-document-sdks-2026-volume-3-ai-chunking-pdf-security-and-data-extraction-3c8b</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR:&lt;/strong&gt; &lt;em&gt;Syncfusion Document SDKs 2026 Volume 3 brings updates across its document-processing libraries, including a .NET Document Chunking Library (Preview) for AI-powered retrieval, a production-ready JavaScript PDF Library, PDF security and digital signature validation, SVG-to-PDF conversion, and expanded data extraction with barcode and QR code recognition.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Document processing involves more than creating and converting files. You may need to prepare content for AI retrieval, verify whether a signed contract has been modified, or extract data from existing documents.&lt;/p&gt;

&lt;p&gt;The Syncfusion&lt;sup&gt;®&lt;/sup&gt; Document SDKs &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt; release introduces updates across several libraries. To make these updates easier to explore, we’re covering them in two blogs. In this blog, we’ll focus on the PDF, Document Chunking, and Data Extraction libraries, exploring their new capabilities and how they can help developers solve real-world challenges.&lt;/p&gt;

&lt;p&gt;In our upcoming blog, we’ll cover the updates to the Word, Excel, and PowerPoint libraries.&lt;/p&gt;

&lt;p&gt;Let’s look at what’s new in each library.&lt;/p&gt;

&lt;h2&gt;
  
  
  &lt;strong&gt;Introducing .NET Document Chunking&lt;/strong&gt;
&lt;/h2&gt;

&lt;p&gt;The new &lt;a href="https://www.syncfusion.com/document-sdk/net-document-chunking-library" rel="noopener noreferrer"&gt;.NET Document Chunking Library&lt;/a&gt; (Preview) helps developers prepare documents for AI-powered retrieval by dividing content into meaningful chunks while preserving structure, hierarchy, and metadata.&lt;/p&gt;

&lt;p&gt;This is useful when building an AI assistant that retrieves information from company policies, technical manuals, and product documentation. Unlike fixed-length splitting, which can separate related information, document chunking helps retain meaningful sections for retrieval.&lt;/p&gt;

&lt;p&gt;The library supports PDF, Word, Excel, PowerPoint, and Markdown formats. Developers can use it to prepare content for retrieval-augmented generation (RAG) and semantic-search applications without implementing separate chunking logic for each format.&lt;/p&gt;

&lt;p&gt;For instance, an assistant answering a question about company policy can retrieve relevant sections from the prepared document chunks.&lt;/p&gt;

&lt;h2&gt;
  
  
  JavaScript PDF Library is now production-ready
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://www.syncfusion.com/document-sdk/javascript-pdf-library" rel="noopener noreferrer"&gt;JavaScript PDF Library&lt;/a&gt; moves from preview to production-ready status in this release.&lt;/p&gt;

&lt;p&gt;Along with existing PDF creation, editing, page manipulation, form, and annotation capabilities, Volume 3 introduces updates to PDF security, digital signature validation, and document manipulation.&lt;/p&gt;

&lt;p&gt;These capabilities are useful for applications that handle contracts, financial records, approval documents, and other sensitive information.&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;strong&gt;Strengthen PDF Security&lt;/strong&gt;
&lt;/h3&gt;

&lt;p&gt;Applications that generate confidential financial statements or customer agreements may need to control who can open a document, modify its contents, or perform specific actions.&lt;/p&gt;

&lt;p&gt;The JavaScript PDF Library supports security capabilities such as:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;RC4 and AES &lt;a href="https://www.syncfusion.com/document-sdk/javascript-pdf-library/encryption" rel="noopener noreferrer"&gt;encryption&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;User and owner passwords&lt;/li&gt;
&lt;li&gt;Document permission restrictions&lt;/li&gt;
&lt;li&gt;Digital signatures&lt;/li&gt;
&lt;li&gt;Signature validation&lt;/li&gt;
&lt;li&gt;Long-Term Validation (LTV) signatures&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fce7r6wm18me5xq69ljs1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fce7r6wm18me5xq69ljs1.png" alt="Secure PDF documents with encryption, passwords, permissions, and digital signatures."&gt;&lt;/a&gt;&lt;/p&gt;
Secure PDF documents



&lt;p&gt;Encryption, passwords, and permission settings help control document access and operations. Digital signatures help verify document integrity and signing information, while LTV support embeds relevant validation information to support future signature verification.&lt;/p&gt;

&lt;p&gt;These capabilities are useful when applications need to protect sensitive PDFs or manage signed documents for long-term storage.&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;strong&gt;Validate Digital Signatures&lt;/strong&gt;
&lt;/h3&gt;

&lt;p&gt;Consider an application that receives digitally signed contracts from customers or business partners. Before sending these documents into an approval workflow, the application may need to check whether the documents have changed after signing and whether the signatures meet its validation requirements.&lt;/p&gt;

&lt;p&gt;The JavaScript PDF Library provides capabilities to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Check document integrity.&lt;/li&gt;
&lt;li&gt;Inspect signing certificate chains.&lt;/li&gt;
&lt;li&gt;Evaluate timestamp information.&lt;/li&gt;
&lt;li&gt;Check certificate revocation status.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm75o0vgcl2xjmz9hywq8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm75o0vgcl2xjmz9hywq8.png" alt="Validate PDF signatures"&gt;&lt;/a&gt;&lt;/p&gt;
Validate PDF signatures



&lt;p&gt;These checks can help applications identify potential signature-validation issues before documents move into downstream business processes.&lt;/p&gt;

&lt;p&gt;For example, a contract-management system could validate incoming signed PDFs and flag documents that require additional review.&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;strong&gt;Generate&lt;/strong&gt;  &lt;strong&gt;Multi-Page PDF Reports with Tables&lt;/strong&gt;
&lt;/h3&gt;

&lt;p&gt;Beyond security, the JavaScript PDF Library includes enhancements for generating structured PDF reports.&lt;/p&gt;

&lt;p&gt;Applications that generate invoices, statements, and reports often need to display large tables across multiple pages. The PDF grid supports structured tables with customizable layouts, formatting, and automatic pagination.&lt;/p&gt;

&lt;p&gt;Developers can use these capabilities to generate multi-page business documents without manually managing every page break.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fy76pq2yerexccr5x9lhd.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fy76pq2yerexccr5x9lhd.png" alt="Generate multi-page PDF reports"&gt;&lt;/a&gt;&lt;/p&gt;
Generate multi-page PDF reports



&lt;h3&gt;
  
  
  Search text and customize PDF content
&lt;/h3&gt;

&lt;p&gt;Volume 3 also introduces improvements to PDF document manipulation, including:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Text search within PDFs&lt;/li&gt;
&lt;li&gt;Image-based list markers&lt;/li&gt;
&lt;li&gt;Enhanced annotation border effects&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Text search helps applications locate specific information within PDF documents, while image-based list markers and annotation border effects provide additional formatting options.&lt;/p&gt;

&lt;p&gt;These enhancements support applications that need to search, customize, and manage PDF content.&lt;/p&gt;

&lt;h2&gt;
  
  
  Convert SVG graphics and HTML content into PDFs
&lt;/h2&gt;

&lt;p&gt;PDF generation becomes more challenging when documents contain graphics or content originally designed for the web. A report might include vector logos, diagrams, and charts, while an invoice might be generated from an HTML template.&lt;/p&gt;

&lt;p&gt;Volume 3 includes updates for both scenarios.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The &lt;a href="https://www.syncfusion.com/document-sdk/net-pdf-library" rel="noopener noreferrer"&gt;.NET PDF Library&lt;/a&gt; now supports &lt;strong&gt;SVG-to-PDF conversion&lt;/strong&gt; , allowing developers to preserve the quality and scalability of vector graphics such as logos, diagrams, illustrations, and charts when generating PDF documents.&lt;/li&gt;
&lt;li&gt;The HTML-to-PDF engine has also been updated with newer Blink binaries, providing improved security and continued compatibility with modern web standards for accurate PDF generation.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzdmmdaf6q4xc6tm2xb1w.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzdmmdaf6q4xc6tm2xb1w.png" alt="Convert SVG graphics to PDFs"&gt;&lt;/a&gt;&lt;/p&gt;
Convert SVG graphics to PDFs



&lt;p&gt;For organizations generating reports, dashboards, proposals, and customer-facing documents, these enhancements help ensure visual consistency across digital and printed outputs.&lt;/p&gt;

&lt;h2&gt;
  
  
  Extracting more value from business documents
&lt;/h2&gt;

&lt;p&gt;Beyond document creation and conversion, organizations increasingly need to extract information automatically.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://www.syncfusion.com/document-sdk/net-smart-data-extraction-library" rel="noopener noreferrer"&gt;.NET Data Extraction Library&lt;/a&gt; expands those capabilities with new conversion and recognition features designed for content reuse and automation.&lt;/p&gt;

&lt;h3&gt;
  
  
  PDF-to-Word and PDF-to-HTML conversion
&lt;/h3&gt;

&lt;p&gt;Developers can transform PDF documents into editable formats while preserving layouts, images, tables, and formatting. This simplifies document modernization, content migration, and workflow automation.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftwmjt8dqpc9zzqxty765.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftwmjt8dqpc9zzqxty765.png" alt="Convert PDFs to editable Word documents"&gt;&lt;/a&gt;&lt;/p&gt;
Convert PDFs to editable Word documents



&lt;p&gt;For example, a legal team can convert archived PDF contracts into editable Word documents instead of recreating the content manually.&lt;/p&gt;

&lt;h3&gt;
  
  
  Barcode and QR code recognition
&lt;/h3&gt;

&lt;p&gt;The .NET Data Extraction Library supports barcode and QR code recognition in supported PDF and image documents. The extracted data can be returned as JSON for use in other applications.&lt;/p&gt;

&lt;p&gt;This capability can help automate identifier capture in workflows such as logistics, inventory management, manufacturing, and document intake.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Q1: What is the .NET Document Chunking Library used for?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The .NET Document Chunking Library helps developers prepare documents for AI-powered applications such as retrieval-augmented generation (RAG), semantic search, knowledge retrieval, and intelligent chat experiences. It automatically segments large documents into context-aware chunks while preserving document structure and metadata.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q2: What PDF security features are available in the JavaScript PDF Library?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The JavaScript PDF Library supports RC4 and AES encryption, user and owner passwords, permission controls, digital signatures, and Long-Term Validation (LTV) signatures for building secure PDF workflows.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q3: Does the JavaScript PDF Library support digital signature validation?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. It supports checking document integrity, certificate chains, timestamp information, and certificate revocation status through OCSP and CRL verification.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Q4: Does the .NET Data Extraction Library support barcode and QR code extraction?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Yes. The library can recognize barcodes and QR codes in supported PDF and image documents and return the extracted data as JSON for downstream processing.&lt;/p&gt;

&lt;h2&gt;
  
  
  Explore Syncfusion Document SDKs 2026 Volume 3
&lt;/h2&gt;

&lt;p&gt;Whether you’re preparing documents for AI retrieval, validating signed PDFs, generating reports, or extracting business data, Syncfusion Document SDKs &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;2026 Volume 3&lt;/a&gt; introduces capabilities worth exploring.&lt;/p&gt;

&lt;p&gt;To learn more, visit the &lt;a href="https://www.syncfusion.com/products/whatsnew" rel="noopener noreferrer"&gt;What’s New&lt;/a&gt; page and &lt;a href="https://help.syncfusion.com/common/essential-studio/release-notes/v35.1.37" rel="noopener noreferrer"&gt;release notes&lt;/a&gt; for the complete list of updates. You can also explore the relevant documentation and examples to see how these features fit into your applications.&lt;/p&gt;

&lt;p&gt;Existing Syncfusion customers can download the latest version of Essential Studio from the &lt;a href="https://www.syncfusion.com/sales/pricing" rel="noopener noreferrer"&gt;License and Downloads&lt;/a&gt; page. New users can explore the features with a free 30-day &lt;a href="https://www.syncfusion.com/downloads" rel="noopener noreferrer"&gt;trial&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Have questions or feedback? Connect with us through our &lt;a href="https://www.syncfusion.com/forums" rel="noopener noreferrer"&gt;support forums&lt;/a&gt;, &lt;a href="https://support.syncfusion.com/" rel="noopener noreferrer"&gt;support portal&lt;/a&gt;, or &lt;a href="https://www.syncfusion.com/feedback" rel="noopener noreferrer"&gt;feedback portal&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related Blogs
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/sneak-peek-2026-vol-3-document-sdk" rel="noopener noreferrer"&gt;Sneak Peek: 3 New Libraries Coming to Syncfusion Document SDK 2026 Volume 3&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/syncfusion-essential-studio-2026-vol-3" rel="noopener noreferrer"&gt;What’s New in Syncfusion Essential Studio 2026 Volume 3: A2UI, New JavaScript Document Libraries, and More&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/syncfusion-dotnet-maui-2026-volume-3" rel="noopener noreferrer"&gt;What’s New in Syncfusion .NET MAUI 2026 Volume 3: New Controls and Features&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.syncfusion.com/blogs/post/a2ui-composer-ai-interface" rel="noopener noreferrer"&gt;Build Agent-Driven UI Designs Faster Using Syncfusion A2UI Composer&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>syncfusion</category>
      <category>documentsdks</category>
      <category>releasehighlights</category>
      <category>digitalsignature</category>
    </item>
  </channel>
</rss>
