# Publication template details

### Type

The type of template the publication template will render.

### Name

The display name for the publication template.

### External reference

A custom reference to the template. Relevant if you are using the API.

### Description

A custom description that describes the publication.

### Enabled

Determines whether the template is enabled or not.

### Allow multiple pages

Set to allow additional pages in the rendered publication.

### Combine as a single publication

Combines the publication to a single PDF.

### Enable header

Put a header on each individual page of the publication.

### Enable footer

Put a footer on each individual page of the publication.

### Enable table of content

Adds a table of content that you can style however you like.

### Enable category pages

Define a default style for all entities within a category.

### Page orientation

Defines the orientation of the publication.

### Page size

Defines the size of the pages (A0, A1, A2, A3, A4 etc).

### Use fallback language

Defines a language to fall back on if the selected language does not load properly.

### Item limit

Sets the hard limit of items that will be included in each export of the publication. If your publication contains a large dataset, we recommend that you split it up into multiple exports.

### Value properties

Sets what properties will be available for all the values in the dataset. Can improve overall performance.

### Rendering engine

Sets the engine that will render the publication. Choose between XSLT[^1],[^2] Razor[^3] or Liquid[^4].

### File format

Sets the file format of the generated file. Choose between XML[^5], CSV[^6], XLSX[^7], [JSON ](#user-content-fn-8)[^8]and PPTX[^9]. Defaults to XML.

{% hint style="info" %}
You can learn more about the individual file formats [here](https://docs.struct.com/reference/publication/publication-template/file-formats).
{% endhint %}

### File extension

Define a custom file extension. Defaults to the selected file format.

### Use real PDF size for rendering

Makes sure that elements do not scale improperly when converting from HTML to PDF.

### Disable base URL

If you have a base URL that you would like links to refer to (eg, using anchor tags), this should be disabled. If you would rather like to specify full the URL of a link, you should enable it.

### Culture mode

Defines how culture mode should react. This enforces some formatting rules depending on the selected language.

[^1]: XML stylesheet. Data available in template will be shown as XML.

[^2]:

[^3]: C# view rendering. Data available in template will be shown as Json but have a type specific representation in Razor.

[^4]: HTML template language. Shopify-like HTML template language. Data available in template will be shown as Json.

[^5]: XML (eXtensible Markup Language) is a markup language for defining rules to encode documents in a format that is both human-readable and machine-readable. It is primarily used for data transport and storage. It uses tags to define elements and attributes, creating a hierarchical, tree-like structure, similar to a folder system on your computer. It focuses on describing what the data is. Many configuration files and web services rely on XML for structured data exchange.

[^6]: CSV (Comma Separated Values) is the simplest, plain-text format for storing tabular data (rows and columns). It works by separating each data field with a delimiter, most commonly a comma, with each new line representing a new record. This format is highly versatile and is the standard method for simple data import and export between different databases and spreadsheet programs.

[^7]: XLSX is the current, default file format for Microsoft Excel. It is technically a compressed ZIP archive that contains a collection of XML files. These internal files define all the complex workbook components, including multiple sheets, charts, formulas, and formatting, making it ideal for advanced data analysis and financial modeling.

[^8]: JSON is a lightweight, text-based format for data interchange that is hugely popular on the web. It structures data using easily readable, fundamental structures: key-value pairs (objects) and ordered lists (arrays). Its simplicity and efficiency make it the preferred format for modern web application data transfer, particularly for API responses.

[^9]: PPTX is the standard file format for Microsoft PowerPoint presentations. Like XLSX, it is a compressed ZIP archive containing XML files and all the necessary media (images, audio, etc.). These files define the presentation's slides, layout, text, and dynamic features like animations and transitions for sharing professional and educational content.
