Overview
Field2Base Admins have the ability to edit E-Mail Templates for all automated e-mails sent from the Field2Base system, as well as create new E-Mail Templates that can be sent as part of
Custom Workflows.
Creating or Editing an E-mail Template
1. Log in to the Field2Base Portal.
2. Navigate to Admin > E-Mail Templates.
3. Click the Create button.
4. Choose your desired category. See the section below for details on each category.
5. Choose the name of an existing system template (for Import, User or Work Order templates) or enter a name for new template (for Sent Form or Workflow templates).
6. Edit or create the Subject and the Body of the email. For applicable templates, you can also edit the PDF attachment details.
7. Click
Submit.

Editing Company-Wide Default E-Mail Templates
There are several buttons that provide a shortcut to editing the most common company-wide default E-Mail Templates.
A. Edit Default Sent Form Template - Takes you directly to the Sent Form E-Mail Template to easily edit the E-Mail and PDF Attachment that is sent each time a Form is submitted.
B. Edit Default Workflow Template - Takes you directly to the Workflow E-Mail Template to easily edit the E-Mail and PDF Attachment that is sent to the Final Recipients each time a Form is approved in a Basic Workflow.
C. Edit Default Workflow Re-Assign Form Template - Takes you directly to the Workflow Re-Assign E-Mail Template to easily edit the notification E-Mail and PDF Attachment that is sent to the User(s) when a Form in Workflow is reassigned by a Workflow Administrator.
Template Components
Categories
Import - Emails that are sent after a bulk import has been completed.
Location - This category is currently in development.
Sent Form - Emails that are sent when a form is submitted.
User - Emails related to User activity, updates, etc.
Work Order - Emails that are sent when a Work Order is assigned or re-assigned.
Workflow - This category is used to create new templates that can be used in Custom Workflows.
Name
Select the Template name you would like to edit, or enter a new name if you are creating a Workflow E-Mail Template.
Subject
Enter the text you would like to appear in the subject line of the e-mail. You may use any of the available Keywords here. For a list of common Keywords and their descriptions, refer to the Keywords table at the bottom of this article.
Body
This section will contain the contents of the email, i.e. what the recipients sees (with keywords substituting for desired system data).
Toolbar options
a. Font Style Options
- Style - select from normal text, 6 header sizes, quote, or code snippet.
- Bold
- Underline
- Remove Font Style
- Font Family
- Recent Color
- More Color: Font Background and Foreground color
b. Format Options
- Unordered List - Bullet point list
- Ordered List - Numbered List
- Paragraph - Alignment options
c. Inserts
- Table
- Link
- Picture
- Video
d. Other Options
- Full Screen - expand Body section to full window
- Code View - Toggle between normal edit window and HTML code
- Help - List of keyboard shortcuts
- Key Words - list of available system Keywords
- Foundation Framework - In development, will eventually allow importing of templates
Import Templates
Import Email Templates are automatically sent when a bulk import process has finished. The email is sent to the User that initiated the bulk import process.
Types
- Bulk User Update
- Import Devices
- Import Groups
- Import Locations
- Import Users
- Import Work Orders
Keywords
- {{AutoGeneratePassword}} - (boolean) Setting selected during the Import process to determine if the Password is auto-generated or not
- {{BaseWebUrl}}- https://admin.field2base.com/
- {{ContactsCount}}-Number of possible Contacts included in the Import processed
- {{ContactType}}-Setting selected during the Import process to determine the Type of Contact (Recipient or User)
- {{DateTime}}-Time the Import was processed
- {{{DetailDevices}}}-List of Device details related to the Devices included in the Import processed
- {{{Errors}}}-List of any errors that occurred during the Import process
- {{ForcePasswordReset}}-(boolean) Setting selected during the Import process to determine if the User is forced to change their Password when they log in for the first time
- {{GroupCount}}-Number of Groups included in the Import processed
- {{Issues}}-Identifies if there are issues with the Import processed
- {{IsVisibleRecipient}}-(boolean) Setting selected during the Import process to determine if the Contact will be shown in the Optional Recipient List
- {{LocationsCount}}-Number of Locations included in the Import processed
- {{PasswordNeverExpires}}-(boolean) Setting selected during the Import process to determine if the User's Password in this Import will never expire
- {{PortalLoginUrl}}-https://admin.field2base.com/
- {{ProjectAssociations}}-List of Associated Folders selected during the Import process for the Contacts imported
- {{SuccessCount}}-The number of successful updates during a Bulk import, assignment, or update process
- {{WorkOrderCount}}-Number of Work Orders included in the Import processed
Sent Form Emails are sent whenever a form is submitted. These emails are sent automatically to Mandatory Recipients of a form, Folder level BCC Recipients, and to any email address the User selects when sending from the Mobile Forms App.
Types
- Companywide - Email template used for all Sent Forms ( excluding forms that have Form Specific templates )
- Form Specific - Email template used for a specific form
PDF Attachment Options
You can choose whether to include the Sent Form as a PDF attachment as part of a Sent Form E-Mail Template. The name of the PDF Attachment can be set as the REF#, the Form Title, or a custom file name. The PDF page visibility can also be customized.
Conditionals Based on Region Values
You have the ability to display certain portions of your email template based on whether a form region has a value by using If conditionals in the html for your email template.
- {{#if form.page1.Comments}}
- <p>Comments: {Page1@Comments}</p>
- {{/if}}
Keywords
- {{AnonymousLink}}-URL link to a PDF version of the Sent Form
- {{Attachments}}-Used in creating the Attachment Block of the Sent Form Template with the If statement to trigger their display
- {{BaseWebUrl}}-https://admin.field2base.com/
- {{company.id}}-Company ID of the form Sender
- {{company.name}}-Company Name of the form Sender
- {{CompanyId}}-Company ID of the form Sender
- {{DocumentId}}-Unique REF# used in the system for the Sent Form
- {{{form.friendlyDataName}}}-The Form Title for the Sent Form
- {{{form.name}}}-Name of the Sent Form triggering the email
- {{FormProcessTime}}-A timestamp of the current server local time at the time of e-mail processing for the Sent Form
- {{{name}}}-Depending on whether it's used in Recipients or Attachments, it lists the appropriate Name of each Recipient / Attachment
- {{OnlineDocsPDFURL}}-URL link to a PDF version of the Sent Form
- {{PortalLoginUrl}}-https://admin.field2base.com/
- {{project.key}}-Folder Key that the Sent Form is associated with. (Project = Folder)
- {{project.name}}-Folder Name that the Sent Form is associated with. (Project = Folder)
- {{ReferenceNumber}}-Unique REF# used in the system for the Sent Form
- {{sender.email}}-Form Sender's email address
- {{sender.key}}- Form Sender's User Key
- {{sender.realName}}-Form Sender's First and Last Name
- {{sender.userName}}-Form Sender's Username
- {{SenderUsername}}-Form Sender's Username
- {{ServerTimestamp}}-Local time (ET) timestamp when the Sent Form was received on the server
- {{ServerTimestampUtc}}-Deprecated
- {{{Subject}}}-Subject (or friendly name) of the Sent Form
- {{{SubjectLine}}}-The dispatch subject originally used in our system. There's already an existing 'subject' Keyword, but for DIM compatibility that actually takes the value of the dispatch friendly name, which is different from the subject for Sent Forms or RFIs. Most of the time, 'subject' should be preferred over 'subjectLine', and 'subjectLine' will likely be deprecated in the future
- {{TabletSerial}}-Activation ID of the Device that sent the Form
- {{TimestampDisplay}}-local time timestamp formatted with the .Net "Full date/time pattern (short time)" when the Sent Form was received on the server
- {{VisibleRecipients}}-List of the Mandatory Recipients and the selected Optional Recipients for the Sent Form
User Templates
User Email Templates are sent after various processes, updates, or edits involving a User have been completed. Usually, these emails are sent to the affected User, although sometimes the email is sent to the User that initiated the process.
User Emails can be disabled by unchecking the Enabled checkbox in the Create or Edit E-Mail Template dialog box.
Types
- Activation of New Device Alert - Sent to the User associated with a Device that has just been activated
- Added to New Company Alert - Sent to a User that has been to a new company
- Create User - Sent to a New User upon Creation
- Edit User Alert - Sent to a User anytime their info has been updated or edited
- Edit User with No Role Alert - Sent to a User with no Roles (App only User) anytime their info has been updated or edited
- Forgot Your Password - Sent to a User after they request a Password recovery
- Forgot Your Username - Sent to a User after they request a Username recovery
- New User with No Role Alert - Sent when a new User with no Roles has been created in a Company (sent to the User)
- Password Change Alert - Sent to a User when their Password has been changed
- Remove Roles Alert - Sent to a User when all of their Roles have been removed
- Role Change Alert - Sent to a User when a Role has been added or changed
- Updated to Multi-Company User Account Alert - Sent to a User when they have been registered with more than one Company
- User PIN Reset - Sent to User when a PIN number has been reset for their account (optional company feature)
- User PIN Set - Sent to User when a PIN number has been set for their account (optional company feature)
- Username Change Alert - Sent to a User when their Username has been changed
Keywords
- {{AssignedRoles}}-The Roles that have been assigned to the User receiving the email
- {{AssignedToUser}}-Assigned User for e-mail generated when Notification option is checked when creating Work Orders
- {{BaseWebUrl}}-https://admin.field2base.com/
- {{CompanyId}}-User's Company ID
- {{CompanyName}}-User's Company Name
- {{CustomerName}}-A concatenated string of the User's first and last name
- {{DateTime}}-Time when a Bulk User Update or Bulk Assign Roles request is processed
- {{EmailAddress}}-User's Email Address
- {{{Errors}}}-List of errors that occurred when a Bulk User Update or Bulk Assign Roles request is processed
- {{Issues}}-Identifies if there are issues with the Bulk User Update or Bulk Assign Roles request is processed
- {{Password}}-User's Password
- {{Platform}}-User's Device Platform
- {{PortalLoginUrl}}-https://admin.field2base.com/
- {{SuccessCount}}-The number of successful updates during a Bulk import, assignment, or update process
- {{UserName}}-User's Username
- {{UsersCount}}-Number of possible Users included when a Bulk User Update or Bulk Assign Roles request is processed
- {{WorkOrderName}}-Name of the Work Order being assigned to a User
Work Order Templates
Work Order Email Templates are used to notify a User when a Work Order is assigned or re-assigned to them and can be updated by any User with the Mobile Forms Admin Role.
Types
- Work Order Assigned
- Work Order Re-Assigned
Workflow Templates
Workflow Email Templates are used in Custom Workflows and can be updated by any User with the Mobile Forms Admin Role. Because these templates are used specifically in
Custom Workflows, you will need to contact the Field2Base Professional Services Department if you would like to use a new Workflow Email Template or change how/when an existing email is triggered. Custom Workflows can only be created or edited by Field2Base.
PDF Attachment Options
You can choose whether to include the Sent Form as a PDF attachment as part of a Workflow E-Mail Template. The name of the PDF Attachment can be set as the REF#, the Form Title, or a custom file name. The PDF page visibility can also be customized.
Conditionals Based on Region Values
You have the ability to display certain portions of your email template based on whether a form region has a value by using If conditionals in the html for your email template.
- {{#if form.page1.Comments}}
- <p>Comments: {Page1@Comments}</p>
- {{/if}}
Keywords
- {{AnonymousLink}}-URL link to a PDF version of the Sent Form
- {{BaseWebUrl}}-https://admin.field2base.com/
- {{company.name}}-Name of your company
- {{companyid}}-Your Company ID
- {{documentId}}-Unique REF# used in the system for the Sent Form
- {{{form.name}}}-Name of the Sent Form triggering the email
- {{formProcessTime}}-Timestamp of the current server local time at the time of e-mail processing for the Sent Form
- {{onlineDocsPDFURL}}-URL link to a PDF version of the Sent Form
- {{PortalLoginUrl}}-https://admin.field2base.com/
- {{project.key}}-Folder Key that the Sent Form is associated with. (Project = Folder)
- {{referenceNumber}}-Unique REF# used in the system for the Sent Form
- {{project.name}}-Folder Name that the Sent Form is associated with. (Project = Folder)
- {{sender.key}}-Form Sender's User Key
- {{sender.realName}}-Form Sender's first and last name
- {{senderUsername}}-Form Sender's username
- {{serverTimestamp}}-Local time (ET) timestamp when the Sent Form was received on the server
- {{serverTimestampUtc}}-Deprecated
- {{{Subject}}}-Subject (or friendly name) of the Sent Form
- {{{subjectLine}}}-The dispatch subject originally used in our system. There's already an existing 'subject' Keyword, but for DIM compatibility that actually takes the value of the dispatch friendly name, which is different from the subject for Sent Forms or RFIs. Most of the time, 'subject' should be preferred over 'subjectLine', and 'subjectLine' will likely be deprecated in the future
- {{tabletSerial}}- Activation ID of the Device that sent the Form
- {{timestampDisplay}}-Local time timestamp formatted with the .Net "Full date/time pattern (short time)" when the Sent Form was received on the server
- {{WorkflowDocumentURL}}-URL that links to the form in Workflow
- {{WorkflowName}}-Name of the Workflow Definition applied to the form