Template Editor

You can create your first mobile form template by uploading your a form PDF or JPG to the GoFormz Template Editor.

GoFormz Support avatar
Written by GoFormz Support
Updated over a week ago

The form template is the master version of your form. Creating a template is the first thing that you must do before you can start using any other GoFormz functionality. The Template Editor is where you do this.

GENERAL INFORMATION

To open a template in the editor, navigate to the Templates Tab and click the name of the template that you want to edit. You will see a Template Fields panel on the left, a Properties panel on the right, and the Template Builder area in the middle.

The typical Template Editor usage flow is as follows:

  • Drag fields from the Template Fields panel into the Template Builder area.

  • Position your fields where you want them within the Form and/or List Views of the Template Builder (resizing as necessary in the Form View); you can also delete fields that you no longer want in the form.

  • Edit your field properties in the Properties panel on the right.

In addition to this core functionality, the Template Editor lets you associate various attributes with your template. This includes automated events, PDF Export configurations, and a default form name. Most of this functionality is found within the Template Editor’s Header.

HEADER

[From left to right]

Template Name & Saved Changes Status

On the left side of the Template Editor Header, you will see the name of your template. To edit your Template Name, click the pencil icon next to the template name.

Below the Template Name, you will see the status of your template's last saved actions. For example, if you have made changes to your template and have not yet saved those changes as a Draft or Published your changes, the status will show as:

You have unsaved changes

Similarly, if your last action when editing this template was to save your changes as Draft, the status will show as:

Draft saved at MM/DD/YYYY, TIME - Where the date and time reflect the last saved date and time.

Finally, if your last action when edition this template was to Publish your changes to create a new Template Version, the status will show as:

Published at MM/DD/YYYY, TIME - Where the date and time reflect the last Published date and time.

Gear Menu Options

  • PDF Export Settings: Create custom print/PDF configurations for forms created using this template.

  • Default Form Name: Change the default name given to forms created from this template. The name can be dynamically based on form fields.

  • New Form: Create a new form from this template.

  • Template Events: Manage Template Events for this template. This includes creating new automation, as well as editing/deleting existing ones

  • Template History: A record of each version created for this template. A new version is created when a Template is Published

  • Public Forms: Allow external users to create forms based on this template, or manage any existing Public Forms created from this template.

  • Workflows: View all workflows that are associated with this template

Preview Button

The Preview button allows you to open your most recently saved template changes in a preview version of the Web Form Editor. This Preview Form Editor will open in a new tab and show a view of a form made from this template.

In the Preview Form Editor, you will be able to test all calculations, database references, custom actions (except Workflow triggering action types), and field functionality set in the Template Editor. However, you will not be able to submit the form as it is just a quick preview to test your changes.

Note: Selecting the Preview button will automatically save your latest changes to your template as a draft.

Save Draft Button

The Save Draft button allows you to save your latest changes to your template as a draft. This can be used to save the changes that you are not quite ready to publish to your Form Users yet.

Note that saving your template as a draft does not make these changes available to Form Users and does not create a new version of your Template.

The text underneath the form name will read “You have unsaved changes” if there are any changes that need to be saved.

Publish Button

Finally, the Publish button allows you to deploy your changes to your Form Users. When selected, a new version of your Template will be made available to be downloaded and used by your end-users. The publish button will only be active if all recent changes have been saved as a draft.

Note: Once a template is published, you cannot revert to a previous version at this time. You must publish a new version to correct any changes.

TEMPLATE BUILDER

This is the main area of the Editor, where you build your form by dragging fields from the Template Fields panel into it. This really consists of two separate builders — the Form View Builder and List View Builder; you can toggle between these using the Form and List tabs at the top. See here for an explanation of Form View and List View.

Form View Builder

The Form View lays out your form fields just like a paper form would. To build it, just add form fields via drag-and-drop, and position them wherever you want in the Builder. You can resize your fields as needed, also using drag-and-drop. You will generally want to position your fields in a way that matches the paper form background that you uploaded. Use the Page Editor within the Builder to manage these background pages.

The Form View Builder is a WYSIWIG editor — it shows an exact representation of what your Form View for this form will look like to the user in the Web Form Editor and the Mobile App Editors (iOS, Android and Windows).

List View Builder

The List View lays out your form like as a sequential list of standardized fields grouped into sections and tabs. The List View Builder lets you set up this framework via intuitive drag-and-drop actions.

The List View Builder is not a WYSIWIG editor — it does not give an exact representation of what the form’s List View will look like in the mobile app. Instead, it is a logical representation of how the form fields will be ordered into sections and tabs in the List View.

TEMPLATE FIELDS PANEL

The Template Fields panel contains all the fields that you can add to your template. To add a new field to your template, simply drag the field name from the panel into the main Template Builder area. Each list contains a different set of fields, as follows.

  • List Layout (List View only): This area contains a single Create Section element. Drag it into the List View Preview to create a new section. You can drag the element to a position within an existing section to split that section into two. See here for more on configuring the List View.

  • Add New Fields: This area lists all available field types. Drag a field into the Builder area to create a new field of this type. See here for a detailed explanation of each field type.

  • Template Fields: This area lists all fields that already exist in your template. Dragging one of these into the Builder area will create another instance of the same field in your form. This new instance’s display properties can be edited separately from the original, but its field properties are tied to the original. You can also delete all instances of a field by clicking it here and pressing the [Delete] button on your keyboard

PROPERTIES PANEL

The Properties Panel is where you edit the properties of your form fields and see where in the form each field is located. This panel is divided into several sections:

  • Field: This section contains properties that govern a field’s behavior and functionality, as well as field metadata. These properties are specific to a field across all locations — so if you have multiple instances of the same field in your form, all instances will share these properties, including instances across different views (Form View and List View).

  • Display: This section contains properties that govern the field’s look-and-feel and layout in the Form View. These properties are specific to a field instance — each instance of a field will have its own Display properties. The List View has very limited Display properties because each field has a standard look-and-feel, while the Form View lets you do a lot more display customization.

  • Field appears on: This section lists wherein the Form View and/or List View the field is located. Click on a location to jump to it in the Builder.

  • Columns (Table field only): This section lets you manage your table columns, including adding, reordering, and deleting columns. Click a column name to view and edit its properties. See here for more on Table fields.

In the image below, we see the properties of the same field in the Form View and List View. Notice that the Fields that appear in sections are identical in the two views, while the Display section is different.

To edit a property, simply click on it. Different properties will have different editing mechanisms — some will let you type in a new value, some will have a dropdown, some will open a color picker, etc.

Notice the [. . .] next to a handful of properties. With one or two exceptions, this indicates that the property supports formulas or calculations. Click the [. . .], then click the Use a custom calculation option that appears — and the input control will turn into a formula text box, as seen below. Since formulas can sometimes get rather long, we provide a Formula Bar at the top of the Template Editor that lets you see the entire formula as you edit it. In this example, we change this field’s background color based on the value of the “Overtime Hours” field.

Did this answer your question?