> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.carbone.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Template usage and quota on the Carbone Cloud API

# What is a Template ?

A template is a re-usable file with Carbone tags (placeholders), used to injects data and generate documents!
To generate documents, two elements are required: **a template** (created from your text editor) and a **JSON data-set** (the data injected to generate the report).

When you subscribe to a plan, it is possible to store templates through two Carbone services: [Cloud API](#4-carbone-cloud-api) or [Cloud Studio](#4-carbone-cloud-studio). A plan will give you storage quota for many templates. If additional templates are uploaded, they are charged at the billing period's end.

## How to store Templates

#### Store templates on Carbone Cloud Studio

Uploaded templates through Carbone Studio are stored for an unlimited time, and you will be able to
* Preview and Design report.
* Manage templates with versioning and labeling.
* Use template IDs to generate reports through the Carbone Cloud API.
* Access templates in Carbone Account (listing and download only).

#### Store templates on Carbone Cloud API

When you request the API with the:
* **Production Token**: Templates are **stored for an unlimited time** by default. It is possible to upload a **non-persistent** template that will be deleted automatically by adding the header `carbone-template-delete-after` with days in seconds (86400s = 1 day, max 30 days).
* **Test Token**: Templates are **non-persistent** and will be deleted automatically within 30 days. The duration can be reduced by passing the header `carbone-template-delete-after` with days in seconds (86400s = 1 day, max 30 days). Non-persistent are counted on the total number of stored templates given by your subscription. Once a template is automatically deleted, a template storage slot becomes free.

Note: uploaded templates through the API are:
* accessible in Carbone Account (listing and download only).
* not accessible in Carbone Cloud Studio.

## How to delete templates

* Manually on your Account > `Manage template` > delete one or all of your templates.
* Manually on [Carbone Cloud Studio](https://studio.carbone.io).
* Programmatically through the [Carbone Cloud API](https://carbone.io/api-reference.html#delete-templates)
* If you cancel your subscription: All of your templates will be deleted within 30 days.
* if you delete your account: All of your templates are deleted instantaneously.

## Supported template types

Carbone accepts only XML-based templates:
`DOCX`, `XLSX`, `PPTX`, `ODT`, `ODS`, `ODG`, `ODP`, `XHTML`, `IDML`, `HTML` or `XML` files.

Note: Carbone can generate many reports formats, [learn about the supported files and features list.](https://carbone.io/documentation.html#supported-files-and-features-list)

| If you need to store templates and render reports on your own infrastructure, reach us on the chat to access **Carbone On-premise** 🚀