# Sharing Documents with ReportingCloud

> ReportingCloud introduces a DocumentViewer widget that embeds shared documents into any website. The new document/share endpoint returns an encrypted hash pointing to a template in cloud storage. Adding the widget requires only a script tag and a data-document attribute in HTML.

- **Author:** Bjoern Meyer
- **Published:** 2017-10-05
- **Modified:** 2026-07-17
- **Description:** ReportingCloud introduces a DocumentViewer widget that embeds shared documents into any website. The new document/share endpoint returns an encrypted hash pointing to a template in cloud storage. Adding the widget requires only a script tag and a data-document attribute in HTML.
- **2 min read** (295 words)
- **Tags:**
  - Cloud
  - Microservices
  - ReportingCloud
  - Web API
- **Web URL:** https://www.textcontrol.com/blog/2017/10/05/sharing-documents-with-reportingcloud/
- **LLMs URL:** https://www.textcontrol.com/blog/2017/10/05/sharing-documents-with-reportingcloud/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2017/10/05/sharing-documents-with-reportingcloud/llms-full.txt

---

We just published a new beta feature of [ReportingCloud](https://www.reporting.cloud) that enables developers to embed the ReportingCloud DocumentViewer using a lightweight widget into any website.

This way, you can show your created documents on your website using a fully-featured, HTML/JavaScript-based and responsive DocumentViewer. The following sample document is delivered directly from ReportingCloud through the DocumentViewer widget:

Technically, all you need to do is to include the widget code into your website:

```
<div data-document="" id="reportingcloud-documentviewer"></div>
<script async src="https://portal.reporting.cloud/scripts/reportingcloud.js" charset="utf-8">
</script>
```

The new endpoint *document/share* returns the encrypted document share path that needs to be added to the *data-document* attribute.

[https://api.reporting.cloud/v1/document/share ](https://docs.reporting.cloud/docs/endpoint/document/share)

| Query Parameter | Value Type | Value |
|---|---|---|
| templateName | String | Specifies the template name in the template storage. |

Consider the following workflow: In an online store, a customer is buying products and receives an invoice for the purchased products. The invoice template is created in advance using the ReportingCloud template designer. After the transaction, the template is merged with the transaction data to create an invoice. This invoice can be delivered to the buyer via e-mail or it can be linked to be downloaded. Additionally, the ReportingCloud DocumentViewer widget can be used to share the document immediately on the website.

![Document workflow](https://s1-www.textcontrol.com/assets/dist/blog/2017/10/05/a/assets/diagram_share.webp "Document workflow")

The document is stored in the private ReportingCloud template storage and delivered directly through ReportingCloud. The document share location is encrypted in the hash value that is returned by the endpoint *document/share*.

Just another great idea to provide a fully-featured document workflow directly delivered through the cloud.

Test this on your own and [create a ReportingCloud trial account](https://portal.reporting.cloud/Account/Register/) today.

Happy coding!

---

## 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

- [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: Sample Template Gallery Launched](https://www.textcontrol.com/blog/2017/09/03/reportingcloud-sample-template-gallery-launched/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)
- [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)
- [Render Document Pages As Images Using the ReportingCloud REST Web API](https://www.textcontrol.com/blog/2016/08/04/render-document-pages-as-images-using-the-reportingcloud-rest-web-api/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)
- [ReportingCloud: Setting the Culture for Date and Currency Fields](https://www.textcontrol.com/blog/2017/10/13/reportingcloud-setting-the-culture-for-date-and-currency-fields/llms.txt)
- [Impressions from BASTA! 2017](https://www.textcontrol.com/blog/2017/09/27/impressions-from-basta-2017/llms.txt)
- [Visit Text Control at BASTA! 2017](https://www.textcontrol.com/blog/2017/09/22/visit-text-control-at-basta-2017/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)
- [Are We Moving to the Cloud? This Question is Changing from "if" to "when" and "how"](https://www.textcontrol.com/blog/2017/07/14/are-we-moving-to-the-cloud-this-question-is-changing-from-if-to-when-and-how/llms.txt)
- [More Impressions from DWX Developer Week 2017](https://www.textcontrol.com/blog/2017/06/29/more-impressions-from-dwx-developer-week-2017/llms.txt)
- [DWX Developer Week 2017: First Impressions](https://www.textcontrol.com/blog/2017/06/27/dwx-developer-week-2017-first-impressions/llms.txt)
- [NDC Oslo 2017 Impressions: Part II](https://www.textcontrol.com/blog/2017/06/19/ndc-oslo-2017-impressions-part-ii/llms.txt)
- [First Day at NDC Oslo 2017: Some Impressions](https://www.textcontrol.com/blog/2017/06/15/first-day-at-ndc-oslo-2017-some-impressions/llms.txt)
- [Meet Text Control at Developer Week 2017 (DWX) in Nuremberg](https://www.textcontrol.com/blog/2017/06/07/meet-text-control-at-developer-week-2017-dwx-in-nuremberg/llms.txt)
