Available for: UI for ASP.NET MVC | UI for ASP.NET AJAX | UI for Blazor | UI for WPF | UI for WinForms | UI for Xamarin | UI for WinUI | UI for ASP.NET Core | UI for .NET MAUI

New to Telerik Document Processing? Download free 30-day trial


Shapes enable users to wrap text in a container and visualize it in a specific manner. There are different types of shapes determined by their visual appearance (shape, style, size, etc.). Their variation makes them very useful for drawing attention to specific text. They could also be helpful to manipulate the text appearance (e.g. inline with text or with text wrapping) according to the rest of the document content.

To use shapes in your application, you should add a reference to Telerik.Windows.Documents.DrawingML.dll for .NET Framework projects, or Telerik.Documents.DrawingML.dll for projects based on .NET Core.

Backward Compatibility

If you would like to, you can skip the import and export of shapes and avoid the need to refer the Telerik.[Windows].Documents.DrawingML assembly. To do so, you should set the SkipShapes property of DocxImportSettings and DocxExportSettings.


With the first release of the functionality in WordsProcessing (R3 2022), import and export of shapes from and to Office Open XML (DOCX) is supported.

  • When exporting to formats other than DOCX, the shapes will be lost.
  • Text in shapes is not supported

In next releases, the feature will be enhanced with support for text in shapes, inserting and editing shapes, as well as preserving them when exporting to PDF.

See Also

In this article