Skip to main content
Skip table of contents

Template Settings

Managing the Settings of a Template

You can manage a number of settings that will apply to all documents generated from the current template. You can edit those settings by clicking the gear icon in the Template Panel which will open up your template settings.

The template settings menu will appear, allowing you to set the following parameters for your template's settings.

PDF Standard

Set the PDF standard that your output documents will comply with. iText DITO supports these standards:

  • PDF: the regular PDF specification
  • PDF/UA: the Universal Accessibility specification for PDF documents. Documents that comply with this standard are "accessible" as defined by the PDF/UA standard. That means that they are set up to support assistive technology like screen readers. iText DITO has a PDF/UA Compliance Assistant that helps you comply with the standard. 

Title

The title will be written in the title tag of your output documents. Many PDF readers and browsers will display this title, typically at the top of the window. The title can be set as a static or a dynamic value:

  • Static Title - If you select this option the tile will be a constant value that is identical for all documents produced.
  • Title from data - If you select this option the title is based on a field value from your data set, for instance the name of the customer. Click the ellipsis button to bind the title to a field from your data set.  

If the template is set up to comply with the PDF/UA standard, title is a required field.

Language

In the language field you can select the main language of the document. This setting is helpful for assistive technology like screen readers. The language can be set statically or dynamically:

  • Predefined language - select the main language of the resulting PDF documents from a list of languages.
  • Language from data - you can bind the selection of the document language to the value of a field in the data set. A typical use case would be a template that contains conditional content in more than one language, the language that is displayed depends on a field that indicates the language of the intended recipient. Dynamic values should be formatted as a two-digit locale code or a locale code and a country code joined together with a hyphen (e.g. 'en' or 'en-US'). 

If the template is set up to comply with the PDF/UA standard, language is a required field.

Page Size and Orientation

The page size setting defines the dimensions of each pages in the resulting PDF documents.

Page sizes can be defined by selecting a common page format from the drop-down, or by setting custom values for width and height (supported units). The page size can also be reset to the default.

You can also define page orientation to be portrait or landscape.

Using custom CSS, you can set different page sizes for the first page, the left pages or the right pages of your template. The below example will set the height of the first page to 600 points and the width of the first page to 400 points.
@page:first {
size: 600pt 400pt;
}

Margin

Set the margins for the documents that will be created using the current template (supported units). Margins can be edited individually or collectively and can be reset to the default values.

You can then go back to designing your template by clicking on the pencil icon in the template panel. 


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.