Freemarker Documents



Use FTL (Freemarker Template Language) to build an output file template to handle the data from submitted forms. Read more about Freemarker.

With Freemarker you can:

  • Generate your own HTML, XML or JSON structure, or any other text-format that suits your needs
  • Use loops and conditional sections
  • Create and change variables within a template
  • Use complex expressions:  string operations, calculations, arrays,  etc.

A number of other document types are available, and multiple documents can be sent with a single form submission.  Read more about documents here.

[ top ]




Create the document, select Freemarker as the document type,  then follow the instructions below.



Document Basics


Give the document a unique name. Optionally provide a description.


This is the name of the file that will be sent through data destinations.  

  • Use Data Record Expression Language to reference answers in your forms.
  • Static text can also be included.
  • For example, %r -- %a[Customer Name] would name the file like "20140812-180001002  -- John Smith."


  • Some data destinations will overwrite files with duplicate names.  Make sure file names are unique by including one or more of:
    • %r - the submission's reference number -- e.g. 20140920-1815562464
    • %r[id] - the submission's ID - e.g. 1815562464
    • %t - the time the form was submitted

[ top ]


Document Timezone Source

Choose a document time zone source. This is the time zone for all dates and times in your document.

  • Team Preference Setting: Will use the time zone chosen for the team
  • Data Record: Will use the time zone the form submission is made from (as chosen on the mobile device).
  • Custom: Choose a time zone.



Auto-Link new forms to this document

Selecting this option will add the document as an "Additional Document" to forms created or imported after this option is set.  Submissions made against these forms will be downloadable in this document format from the "Data" tab of the portal.


[ top ]



File Extension

The document can be any file type.  Most commonly-used file extensions are .txt and .xml. 

Content Type

Leave this blank for automatic resolution based on file extension.  Read here for a list of content types.

Freemarker Template

Upload your Freemarker Template in an FTL format.  Read here for details on building a template.

[ top ]


When set up is complete, press "Create."  Link the document to a form in order to use it. 


[ top ]


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request