Skip to main content

How to add fields to a custom template

How to add data fields into your Katana template using the PDF Editor

Dayvid Lorbiecke avatar
Written by Dayvid Lorbiecke
Updated this week

Customize your sales order or quote templates by adding specific data fields in Katana using the PDF Editor.


What you’ll need

  • A Katana account on a Standard plan or higher

  • An existing custom template (or create one from a base)


Step 1: Open the template in the PDF Editor

Screenshot showing print template settings where you can edit or add new
  1. Choose a document type (e.g. Sales order templates).

  2. Click on the 3-dot menu next to an existing template and select Edit.
    (If you only have base templates, duplicate one first or create a new custom template.)


Step 2: Add a component to hold the data field

Screenshot showing the PDF editor, highlighting the Text component
  1. In the PDF Editor, choose the component you want to use — typically Text.

  2. Drag it into position on your template layout.


Step 3: Insert a data field

  1. With your component selected, go to the right-hand sidebar.

  2. Click Insert data field.

    Screenshot of PDF editor, indicating the Insert Data Field button

  3. Browse or search the list for the field you want (e.g., ship_from).

  4. Expand folders if needed and click to insert the field.

    Screenshot of the PDF editor showing data field options to insert

  5. You’ll see demo data appear, such as “Main warehouse” for the ship_from field.

    Example of a data field be inserted into the PDF editor

Notes on formatting and fields

  • To add extra static text (e.g., a label), double-click the text box and type directly.

  • Different data types (e.g., dates vs. text) should go in separate components.

  • Preview your layout under View > Preview, and Save your template from the File menu or with Ctrl/Cmd + S.

    Screenshot showing the preview section of the PDF editor

Understanding Expressions and HTML content

Screenshot of the PDF editor, indicating the HTML CONTENT and EXPRESSION areas
  • Fields like addresses often use [EXPRESSION] — this allows conditional display logic.

  • [HTML CONTENT] is used for fields like SKU, serial numbers, and batch tracking, and includes extra formatting.

  • To inspect the raw contents of a field:

    • Click the field

    • View the data under the Raw value section

      Screenshot of the PDF Editor, indicating the Raw value area

Want to add fields to tables?


Need help?


Your feedback is invaluable. Let us know your thoughts on this article or anything in Katana you'd like to see improved: [email protected]

Did this answer your question?