Limitations in Word-to-Image Conversion
24 Jul 20261 minute to read
The following tables show the limitations of Word-to-Image conversion.
| Document Element | Limitation |
|---|---|
| Predefined shapes | Only DOCX and WordML format documents are supported. |
| Chart | Only DOCX and WordML format documents are supported from .NET Framework 4.0 onwards. The following chart types are not supported: Line-Stacked Line, Line-Stacked line with markers, Pie-Pie of Pie, Pie-Bar of Pie, Map-Filled Map, Stock-Volume high low close, Stock-Volume open high low close, Surface-3D Surface, Surface-Wireframe 3D Surface, Surface-Contour, Surface-Wireframe Contour, Treemap-Treemap, Sunburst-Sunburst, Histogram-Histogram, Histogram-Pareto chart, Box & Whisker, Waterfall and Funnel. |
| Grouped Shapes | Only DOCX and WordML format documents are supported. |
| Custom Shapes | Only DrawingML custom shapes in DOCX and WordML format documents are supported. |
| Equation | Mathematical equations extending to multiple lines will be rendered in a single line and content exceeding the right margin will clip in the image. |
| SmartArt | Supported only in DOCX format document to image. Additional behavior explained . |
| WordArt | Not supported |
| Watermark | First watermark of the Word document should be applied to the entire converted image when the Word document has multiple watermarks. |
| Multi-Column Texts | Multi-Column text positions are calculated dynamically when layout the text. So, there may be some content position differences in the image. |
| Footnote and endnote | Number formats in Roman, Alphabets, and Arabic are only supported. |
| Textbox | Linked text boxes are not supported. |
| Ink elements | Supported only in DOCX format document to image. Additional behavior explained . |
| Formatting | Limitation |
|---|---|
| Table Styles | Only DOCX and WordML format documents are supported. |
| Pagination | The Essential® DocIO makes sensible decisions when layout the text and its supported elements while generating the image documents. However, there may not be guaranteed pagination with all the documents. |
| Fit Text - Table cell | Not supported |
| Vertical Alignment of the section | Not supported |
| Borders | Use of patterns and 3D borders are not retained in the output image. |
| Break - Page break, column break and Line break | Text wrapping break is not supported. |
| Font kerning | Partially supported. At present, the text in a line is scaled uniformly to match the width of kerned text, instead of adjusting the space between each pair of characters. |
| Transparency and Pattern fill in shapes | Supported only in DOCX format during Word to image conversion. |
| Recolor picture | Supported only in DOCX format during Word to image conversion. |
| Gradient fill in Shapes | Supported only in DOCX format. Rectangular and Path gradient types are not supported in image conversions in ASP.NET Core, Blazor, WinUI, .NET MAUI, and Xamarin platforms. These are currently rendered as Radial gradients. |