# Using JsonFormatProvider

The `JsonFormatProvider` (introduced in **Q4 2025**) makes it easy to export [Workbook](https://www.telerik.com/document-processing-libraries/documentation/libraries/radspreadprocessing/working-with-workbooks/working-with-workbooks-what-is-workbook) data to a structured JSON representation. Unlike the other text-based providers (CSV / TXT), the JSON export can include richer metadata such as number formats, named ranges, chart data, and workbook level flags. The provider is **export-only**.

The provider also exposes an [ExportSettings](https://www.telerik.com/document-processing-libraries/documentation/libraries/radspreadprocessing/formats-and-conversion/json/jsonexportsettings) property that allows you to control the export behavior.

## Prerequisites

To use the `JsonFormatProvider` class, you need to reference the following NuGet package:

* Telerik.Windows.Documents.Spreadsheet.FormatProviders.Json

## Export

The following example demonstrates how to import an existing [Workbook](https://www.telerik.com/document-processing-libraries/documentation/libraries/radspreadprocessing/working-with-workbooks/working-with-workbooks-what-is-workbook) and export it to a JSON file using the default settings.

**Import an XLSX workbook and export it to JSON with the default provider settings**

```C#
Workbook workbook;
XlsxFormatProvider xlsxFormatProvider = new XlsxFormatProvider();

using (Stream input = new FileStream("inputFile.xlsx", FileMode.Open))
{
    workbook = xlsxFormatProvider.Import(input, TimeSpan.FromSeconds(10));
}

string jsonOutputPath = "outputFile.json";
JsonFormatProvider jsonFormatProvider = new JsonFormatProvider();

using (Stream output = new FileStream(jsonOutputPath, FileMode.Create))
{
    jsonFormatProvider.Export(workbook, output, TimeSpan.FromSeconds(10));
}
```

## See Also

* [JsonFormatProvider Settings](https://www.telerik.com/document-processing-libraries/documentation/libraries/radspreadprocessing/formats-and-conversion/json/jsonexportsettings)
* [Timeout Mechanism](https://www.telerik.com/document-processing-libraries/documentation/knowledge-base/timeout-mechanism-in-dpl)