# Render Document Pages As Images Using the ReportingCloud REST Web API

> The ReportingCloud /v1/templates/thumbnails endpoint renders document pages as PNG, JPG, BMP, or GIF images. Query parameters control zoom factor from 1-400, page range, and output format. Documents from the merge or convert endpoints can be uploaded to generate thumbnails.

- **Author:** Bjoern Meyer
- **Published:** 2016-08-04
- **Modified:** 2026-07-17
- **Description:** The ReportingCloud /v1/templates/thumbnails endpoint renders document pages as PNG, JPG, BMP, or GIF images. Query parameters control zoom factor from 1-400, page range, and output format. Documents from the merge or convert endpoints can be uploaded to generate thumbnails.
- **2 min read** (368 words)
- **Tags:**
  - Cloud
  - Reporting
  - ReportingCloud
  - Web API
- **Web URL:** https://www.textcontrol.com/blog/2016/08/04/render-document-pages-as-images-using-the-reportingcloud-rest-web-api/
- **LLMs URL:** https://www.textcontrol.com/blog/2016/08/04/render-document-pages-as-images-using-the-reportingcloud-rest-web-api/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2016/08/04/render-document-pages-as-images-using-the-reportingcloud-rest-web-api/llms-full.txt

---

ReportingCloud is a Web API powered reporting platform to create MS Word compatible reports in the cloud using a REST web service.

The Web API also supports rendering document pages to a variety of image formats such as PNG, JPG, BMP and GIF with the highest available accuracy and quality.

Besides powerful reporting and conversion processes, the API method [/v1/templates/thumbnails](https://docs.reporting.cloud/docs/endpoint/templates/thumbnails) creates and returns images of document pages. It can be used for templates and resulting documents. If a document has been created using [/v1/document/merge](https://docs.reporting.cloud/docs/endpoint/document/merge) or [/v1/document/convert](https://docs.reporting.cloud/docs/endpoint/document/convert), you can [upload](https://docs.reporting.cloud/docs/endpoint/templates/upload) the document to your template storage in order to create the images using [/v1/templates/thumbnails](https://docs.reporting.cloud/docs/endpoint/templates/thumbnails).

The following query parameters are available to specify the zoom factor, the format and to define the page range the images should be created for:

| Key | Value Type | Value Description |
|---|---|---|
| templateName | String | The filename of the template in the template storage. |
| zoomFactor | Integer | An Integer value between 1 and 400 to set the percentage zoom factor of the created thumbnail images. |
| fromPage | Integer | An Integer value that specifies the first page. |
| toPage | Integer | An Integer value that specifies the last page. |
| imageFormat | String | A string value that defines the image format of the returned thumbnails. Possible values are PNG, JPG, GIF and BMP. |

The following sample code shows how to create images using the [ReportingCloud .NET wrapper](https://portal.reporting.cloud/Wrappers/Dotnet/):

```
using System;
using System.Collections.Generic;
using System.Drawing;
using TXTextControl.ReportingCloud;

class RCSamples
{
    public static void GetTemplateThumbnails(string templateName)
    {
        ReportingCloud rc = new ReportingCloud(
            "username",
            "password",
            new Uri("https://api.reporting.cloud"));

        try
        {
            List<Image> lstThumbnails = rc.GetTemplateThumbnails(
                templateName, 20, 1, 0, ImageFormat.PNG);

            foreach (Image img in lstThumbnails)
            {
                string sImageFilename = Guid.NewGuid().ToString() + ".jpg";
                img.Save(sImageFilename, System.Drawing.Imaging.ImageFormat.Jpeg);

                Console.WriteLine("Image saved to: " + sImageFilename);
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("An error occurred: " + e.Message);
        }
    }
}
```

Start today with ReportingCloud and sign up for a [free trial account](https://portal.reporting.cloud/Account/Register/).

---

## About Bjoern Meyer

As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano.

- [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/)
- [X](https://x.com/txbjoern)
- [GitHub](https://github.com/bjoerntx)

---

## Related Posts

- [Proofing Tools Available As ReportingCloud Web API Endpoints](https://www.textcontrol.com/blog/2017/08/23/proofing-tools-available-as-reportingcloud-web-api-endpoints/llms.txt)
- [All Google Fonts Now Available in ReportingCloud](https://www.textcontrol.com/blog/2017/08/22/all-google-fonts-now-available-in-reportingcloud/llms.txt)
- [New ReportingCloud MergeSettings Option: Merge HTML Content into Merge Fields](https://www.textcontrol.com/blog/2017/08/21/new-reportingcloud-mergesettings-option-merge-html-content-into-merge-fields/llms.txt)
- [New ReportingCloud Endpoint: List Available Fonts](https://www.textcontrol.com/blog/2017/03/29/new-reportingcloud-endpoint-list-available-fonts/llms.txt)
- [What Can You Do with the ReportingCloud RESTful Service?](https://www.textcontrol.com/blog/2016/08/06/what-can-you-do-with-the-reportingcloud-restful-service/llms.txt)
- [Text Control as a Service: Outsource Your Document Processes](https://www.textcontrol.com/blog/2018/10/08/text-control-as-a-service-outsource-your-document-processes/llms.txt)
- [ReportingCloud Monthly Payment Available](https://www.textcontrol.com/blog/2018/09/18/reportingcloud-monthly-payment-available/llms.txt)
- [ReportingCloud: Introducing API Keys for Client Authentication](https://www.textcontrol.com/blog/2017/12/29/reportingcloud-introducing-api-keys/llms.txt)
- [Sharing Documents with ReportingCloud](https://www.textcontrol.com/blog/2017/10/05/sharing-documents-with-reportingcloud/llms.txt)
- [ReportingCloud: Sample Template Gallery Launched](https://www.textcontrol.com/blog/2017/09/03/reportingcloud-sample-template-gallery-launched/llms.txt)
- [The End of Monolithic Applications? Outsource Your Document Generation and Reporting Needs with ReportingCloud Microservices](https://www.textcontrol.com/blog/2017/09/01/the-end-of-monolithic-applications-outsource-your-document-generation-and-reporting-needs-with-reportingcloud-microservices/llms.txt)
- [ReportingCloud .NET Core Wrapper Released: Creating Documents on Windows, Linux, Mac and Docker](https://www.textcontrol.com/blog/2017/08/28/reportingcloud-net-core-wrapper-released-creating-documents-on-windows-linux-mac-and-docker/llms.txt)
- [Retrieving Template Information Using the ReportingCloud Web API](https://www.textcontrol.com/blog/2017/08/11/retrieving-template-information-using-the-reportingcloud-web-api/llms.txt)
- [Merging Nested Repeating Blocks in ReportingCloud](https://www.textcontrol.com/blog/2017/08/10/merging-nested-repeating-blocks-in-reportingcloud/llms.txt)
- [ReportingCloud: Uploading Templates Vs. Sending Templates Inside MergeBody](https://www.textcontrol.com/blog/2017/08/02/reportingcloud-uploading-templates-vs-sending-templates-inside-mergebody/llms.txt)
- [MailMerge: Table Headers and Repeating Blocks](https://www.textcontrol.com/blog/2017/08/01/mailmerge-table-headers-and-repeating-blocks/llms.txt)
- [New ASP.NET MVC DocumentViewer Rolled out to the ReportingCloud Portal](https://www.textcontrol.com/blog/2017/04/22/new-aspnet-mvc-documentviewer-rolled-out-to-the-reportingcloud-portal/llms.txt)
- [Introducing Groups for ReportingCloud Extreme Users](https://www.textcontrol.com/blog/2017/03/17/introducing-groups-for-reportingcloud-extreme-users/llms.txt)
- [Web.TextControl: Adaptive Merge Field Drop-down Lists](https://www.textcontrol.com/blog/2017/02/15/webtextcontrol-adaptive-merge-field-drop-down-lists/llms.txt)
- [TX Text Control X14 Service Pack 1 Deployed to ReportingCloud Portal and API](https://www.textcontrol.com/blog/2017/02/07/tx-text-control-x14-service-pack-1-deployed-to-reportingcloud-portal-and-api/llms.txt)
- [Printing Labels with MS Word Compatible Templates and Data Sources](https://www.textcontrol.com/blog/2016/12/16/printing-labels-with-ms-word-compatible-templates-and-data-sources/llms.txt)
- [ReportingCloud: Conditional Text Blocks Based on Merge Blocks](https://www.textcontrol.com/blog/2016/11/02/reportingcloud-conditional-text-blocks-based-on-merge-blocks/llms.txt)
- [Web API Test Sandbox Released on ReportingCloud Portal](https://www.textcontrol.com/blog/2016/10/07/web-api-test-sandbox-released-on-reportingcloud-portal/llms.txt)
- [ReportingCloud: New Test Parameter for Document Quota Related Endpoints](https://www.textcontrol.com/blog/2016/10/06/reportingcloud-new-test-parameter-for-document-quota-related-endpoints/llms.txt)
- [ReportingCloud: The MergeData JSON Object Format Explained](https://www.textcontrol.com/blog/2016/10/04/reportingcloud-the-mergedata-json-object-format-explained/llms.txt)
