Complete Guide to Field Service

Salesforce, Summer ’20

@salesforcedocs
Last updated: June 11, 2020
© Copyright 2000–2020 salesforce.com, inc. All rights reserved. Salesforce is a registered trademark of salesforce.com, inc.,

as are other names and marks. Other marks appearing herein may be trademarks of their respective owners.
CONTENTS

Field Service Lightning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Field Service Lightning Limits and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Set Up Field Service Lightning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Enable Field Service Lightning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Install the Field Service Lightning Managed Package . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Manage Field Service Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Set Up Territories, Operating Hours, and Shifts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Set Up Work Order Management for Field Service . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Set Up Your Field Service Workforce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Set Up Your Field Service Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Get Ready for Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Set Up Field Service in Communities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Run Health Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Report on Field Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Manage Data Integration Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Manage Work Orders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Create Work Orders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Create Maintenance Plans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Manage Shifts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Create Flexible Work Shifts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
View Your Shift Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Guidelines for Shift Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Manage Service Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Get Started with Time Sheets (Beta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Create Service Resource Absences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
View a Service Resource’s Daily Travel Route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
View a Service Resource’s Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Manage Service Crews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Manage Service Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Create Service Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Schedule Service Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Unschedule Service Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Reschedule Service Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Fix Scheduling Overlaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Group Nearby Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Fill Schedule Gaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Customize Appointment Chatter Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Dispatch Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Manage Your Field Service Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Contents

Common Inventory Management Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Track Required Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Request Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Transfer Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Track Inventory Consumption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Track Inventory Shipments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Track Customer Returns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Manage Service Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Create Service Report Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Create Service Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Optimize Your Field Service Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
What’s Schedule Optimization? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Create and Manage Scheduling Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Create and Manage Work Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Create and Manage Service Objectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Set Up and Run Optimization Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Optimize Today’s Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Optimize a Single Resource’s Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Create Scheduling Recipes for Common Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Monitor Optimization Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Create Relevance Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Work in the Dispatcher Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Customize the Dispatcher Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Work in the Dispatcher Console Appointment List . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Work in the Dispatcher Console Gantt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Work in the Dispatcher Console Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Field Service Lightning Object Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Standard and Custom Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Linked Article Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Location Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Maintenance Plan Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Operating Hours Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Product Request and Transfer Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Product Item and Inventory Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Return Order Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Service Appointment Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Service Crew Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Service Report Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Service Resource Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Service Territory Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Shift Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Skill Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Time Sheet Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Work Order Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Contents

Work Order Line Item Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Work Type Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Field Service Lightning Mobile App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Field Service Lightning Mobile App Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Field Service Lightning Mobile App Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Field Service Lightning Mobile Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Field Service Lightning Android and iOS Mobile App Comparison . . . . . . . . . . . . . . . . 295
Supported Data Types in the Field Service Lightning Mobile App . . . . . . . . . . . . . . . . . 296
Download the Connected App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Give Users Access to the Field Service Lightning Mobile App . . . . . . . . . . . . . . . . . . . 298
Let Users Manage Inventory from the Field Service Lightning Mobile App . . . . . . . . . . . 300
Customize the Field Service Lightning Mobile App . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Using the Field Service Lightning Mobile App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
FIELD SERVICE LIGHTNING

Field Service Lightning gives you a powerful, highly customizable, mobile-friendly field service hub
EDITIONS
in Salesforce.
Running a field service business means managing numerous moving parts. With Field Service Available in: Salesforce
Lightning, you get the tools that you need to manage work orders, scheduling, and your mobile Classic and Lightning
workforce. Here are some of the things you can do. Experience

• Create records that represent your field service technicians, dispatchers, and agents, and add The Field Service Lightning
details about their skills, location, and availability core features, managed
• Set up multilevel service territories that represent the regions where your technicians can work package, and mobile app
are available in Enterprise,
• Track the location and status of your inventory, warehouses, service vehicles, and customer Performance, Unlimited,
sites and Developer Editions.
• Schedule one-time or recurring work orders for customers, and add details about technician Work orders are also
preference and required skills and parts available in Professional
• Create maintenance plans and templates to standardize your field service tasks Edition.

• Generate service reports to keep customers informed about service progress

What’s Included in Field Service Lightning

Core Features
When Field Service Lightning is enabled, you gain access to a suite of standard objects that you can find in Setup and as tabs in
Salesforce. These objects make up the core field service features, including work orders and service appointments.
Managed Package
The Field Service Lightning managed package builds on the core features and includes:
• A Guided Setup tool that walks you through creating field service records and customizing your settings
• A dynamic scheduling console that gives dispatchers and supervisors a bird’s-eye view of all team members and scheduled
appointments
• A scheduling optimizer that allocates resources to appointments in the most efficient way possible by accounting for technician
skill level, travel time, location, and other factors
• Scheduling policies and triggers that help you customize your scheduling model and display preferences
Mobile App
The offline-friendly Field Service Lightning mobile app for iOS and Android makes work a pleasure for technicians in the field. App
users can update work orders, track parts, gather customer signatures, and connect with dispatchers from their mobile devices.
Download the app from the App Store or Google Play.
Ready to get started? The following resources will help you stay organized.

Tip: Check out the Field Service Lightning Developer Guide for object relationship diagrams, API reference information, and code
samples.

1
Field Service Lightning

IN THIS SECTION:
Field Service Lightning Limits and Limitations
Learn about Field Service Lightning limits and limitations.
Set Up Field Service Lightning
Build and manage your field service operation in one place. Create records representing your workforce, set up work order tracking
and inventory management, and customize the Field Service Lightning mobile app to set up your mobile workforce for success.
Manage Work Orders for Field Service
Work orders, which track work to be performed for customers, are the heart of Field Service Lightning. Learn how to create and
customize work orders and maintenance plans.
Manage Shifts
Shifts in Field Service Lightning let you define variable working periods for your shift-based workforce, such as contractors or on-call
staff. Create shifts for particular dates and times when you need coverage, and assign them to service resources. When the managed
package is installed, scheduling and Enhanced Optimization consider workforce availability during shifts.
Manage Service Resources
Service resources are field service technicians that can be assigned to service appointments. Learn how to create time sheets and
view a service resource’s travel routes and calendar.
Manage Service Crew Membership
Efficiently manage your service crews to accommodate a fast-changing field service schedule. Create crews, find and add members
with the right skills, adjust membership dates to match appointment times, and view all crews’ schedules and members in one
place.
Manage Service Appointments
Learn how to create, schedule, reschedule, and unschedule service appointments. Tighten up your schedule by fixing overlaps,
grouping nearby appointments, and filling schedule gaps.
Manage Your Field Service Inventory
Stay on top of the movement of inventory in your field service operation. Learn how to request and transfer products, track
consumption, and process customer returns.
Manage Service Reports
Make your customers happy with service reports delivered to their inboxes. Technicians and dispatchers can create reports for work
orders, work order line items, or service appointments and email them directly to the customer. Use standard templates or create
variations of your own.
Optimize Your Field Service Schedule
Use schedule optimization to formulate the optimal schedule for your team and customers. Schedule optimization helps you comply
with service-level agreements and minimize travel time, overtime, costs, and no-shows.
Work in the Dispatcher Console
The Field Service Lightning dispatcher console is the main working space for dispatchers. It features a dynamic map and a highly
customizable Gantt chart showing upcoming appointments, active team members, and more. To reach the dispatcher console, from
the App Launcher, find and open the Field Service app, and then click the Field Service tab.
Field Service Lightning Object Fields
Learn about the fields available on Field Service Lightning standard objects.

2
Field Service Lightning Field Service Lightning Limits and Limitations

Field Service Lightning Limits and Limitations

Learn about Field Service Lightning limits and limitations.
EDITIONS
To review Field Service Lightning mobile app limitations, see Field Service Lightning Mobile App
Considerations. Available in: Salesforce
Classic and Lightning
Experience
General Limits The Field Service Lightning
core features, managed
Limit Details package, and mobile app
Maximum number of service resources per user 1 are available in Enterprise,
Performance, Unlimited,
Maximum number of service territories in a 10,000 and Developer Editions.
service territory hierarchy Work orders are also
available in Professional
Maximum number of work orders in a work 10,000 Edition.
order hierarchy

Maximum number of work order line items in 10,000

a work order line item hierarchy

Maximum number of work orders that can be 2,500

generated simultaneously for a maintenance
Tip: To decrease the number of work
plan
orders generated, increase the Frequency
value, decrease the Generation
Timeframe value, or decrease the
number of assets related to the
maintenance plan.

Maximum number of locations in a location 10,000

hierarchy

Maximum number of signature blocks on a 20

service report template

Maximum number of values in the Signature 1,000

Type picklist on digital signatures

Maximum number of child assets per asset 2,000

Maximum number of levels in an asset hierarchy 50

Maximum number of assets in an asset hierarchy 10,000

Maximum size of asset hierarchies that can be 500

viewed in the tree grid view

Maximum number of appointments that can 50

be scheduled at once time with the Group
Nearby Appointments action

3
Field Service Lightning Field Service Lightning Limits and Limitations

Limit Details
Maximum runtime in seconds for the Group Nearby Appointments 60
action

Maximum number of coordinates in a map polygon 3,200

(Recommended) Maximum number of polygons in an org 30,000

Exceeding this limit can cause dispatcher console performance
issues. To avoid such issues, set the sharing of the Map Polygon
object to Private and use sharing so dispatchers only see polygons
that are relevant to them.

Maximum number of report markers on the Gantt map 500

Maximum number of rows on the Gantt 500

Maximum number of service appointments in the appointment 3,000

list

Maximum number of skills displayed in the Gantt Skills filter panel 2,000

Maximum number of skills considered per service resource during 50

a Gantt skill filter operation When the Gantt’s resource skill filter runs, only 50 skills are
considered for each service resource. This means that service
resources with more than 50 skills may not appear when you filter
for a skill that they possess. This limit applies only to the Gantt
resource skill filter; the Candidates action finds all resources with
the skills you need.

Maximum number of operating hours records displayed in the 2,000

Default Operating Hours lookup field on the Global Actions >
Appointment Booking settings page

Maximum number of service appointments displayed in the 1,000

Long-Term view in the Gantt

Maximum number of resource absences displayed in the 200

Long-Term view in the Gantt

Maximum number of active scheduling recipes per category 75

Maximum number of active scheduling recipes per org 1,000

Maximum number of service territories that can be viewed without 2,000

searching

Minimum screen resolution for a smooth dispatcher console 1366 x 768 pixels (minimum)
experience 1920 x 1080 pixels (recommended)

4
Field Service Lightning Field Service Lightning Limits and Limitations

Schedule Optimization Request Limits

Limit Details
Maximum optimization requests per hour per org 3,600

Maximum service appointments optimized per rolling 24 hours 50,000

Maximum service appointments optimized per request 5,000

Maximum service territories optimized in a request 100

Maximum service resources optimized per request 500

Maximum days optimized per request 21

Maximum number of objects passed to the optimization service 45,000

in 1 request (for example, service appointments + related objects
such as skill requirements and assigned resources)

Maximum number of objects returned synchronously for In-day 1,000

optimization (more objects are returned asynchronously)

Limitations
Dispatcher Console
• Service appointments without assigned resources are shown on the appointment list but not on the Gantt.
• Territory utilization calculation doesn’t consider secondary territory members.
• The dispatcher console map can appear different than the map displayed on service territory member detail pages because of
a difference in geocoding granularity. The dispatcher console map tends to be more accurate.
• Because Google Maps is restricted in China, Field Service Lightning features that depend on Google Maps don’t work there. To
minimize errors and customize access for users in China, see Disable Google Maps-based Field Service Lightning features for
China users.
• If a service resource has more than 23 stops in a period of 24 hours (including starting point, ending point, appointments, and
absences), the resource map shows only the first 23 stops on the route and displays an error. This is a Directions API limitation.
Inventory Management
• Technicians using the Field Service Lightning mobile app can consume—via the Products Consumed related list—only one
serialized product item per product per work order. For example, you can have multiple product items associated with your
Inverter product that are assigned serial numbers. A mobile app user can add only one of them as a product consumed on a
specific work order. This limitation doesn’t apply to non-mobile platforms.
• The Location field on serialized product items can’t be updated manually. The location auto-updates if a related product transfer
is marked received. To allow serialized product transfers (a beta feature), contact Salesforce.
Linked Articles
Linked articles are knowledge articles attached to a work order, work order line item, or work type. They have the following limitations.
• Quick actions and global actions aren’t supported for linked articles.
• The Article widget and Feed Articles Tool aren’t available in the feed view.
• In Lightning Experience, clicking an article link in a feed item redirects you to the article page in Salesforce Classic. In the Salesforce
mobile app, linked articles can’t be accessed from feed items.

5
Field Service Lightning Field Service Lightning Limits and Limitations

• The Linked Work Types related list isn’t available on articles in any platform.
• The Knowledge One widget isn’t available on work types in the console. To manage linked articles on work types in the console,
use the Articles related list.
• Linked articles are read-only in the Salesforce mobile app.
Multiday Scheduling
Multiday scheduling lets you schedule service appointments that span multiple days. It includes the following limitations.
• A service resource can’t be assigned to any other appointment during a multiday service appointment.
• Multiday service appointments that overlap with other appointments don’t trigger the Fix Overlaps action.
• Multiday service appointments can’t be assigned to capacity-based service resources.
• Multiday service appointments can’t span more than eight weeks.
• If a multiday service appointment has a scheduling dependency, its Scheduled End date isn't calculated when the appointment
is scheduled. For this reason, we recommend against creating dependencies between multiday appointments.
Operating Hours
• You can’t create a master-detail relationship between a custom object and Time Slot in which Time Slot is the master object.
• Operating hours can't span a full 24 hours. Instead, use the operating hours 00:00–23:59.
• Operating hours for secondary service territory memberships must be identical to or contained within the resource’s primary
territory membership’s hours.
• Multiple time slots aren't supported for secondary STM operating hours.
Salesforce App
Most Field Service Lightning features are available in all versions of the Salesforce mobile app. Be aware of these mobile app limitations.
• In Salesforce for iOS:
– You can’t create service appointments, and the Recent related list isn’t available.
– You can’t create service resources or absences, and the Recent related list isn't available on service resources or absences.

• On field service records created via a related list, the field that lists the parent record doesn’t populate until you save the record.
This issue applies to all versions of the Salesforce mobile app. For example, when you create a service appointment from the
Service Appointments related list on a work order, the Parent Record field is blank until you tap Save. Once the record is created,
the parent record field lists the parent work order as expected.
• When an app user is working offline and offline sync permission isn’t enabled, creating or updating records can cause an error
if the Created Date or Last Modified Date fields appear to occur in the future.
• The dispatcher console—a Field Service Lightning managed package feature—isn’t available in the Salesforce mobile app.
• The Linked Work Orders and Linked Work Order Line Items related lists on articles aren’t available.
• Linked articles are read-only. You can search the Knowledge base and read attached articles, but you can’t attach or detach
articles. To manage linked article settings and attach or detach articles, use the desktop site.
• Linked articles can’t be accessed from feed items.
Salesforce on iPad Safari
• Creating service reports from work orders or service appointments isn't supported on Lightning Experience on iPad Safari.
• The dispatcher console isn’t supported on iPad Safari. We recommend that you use Lightning Experience on a desktop to use
the dispatcher console.
Scheduling and Optimization
• A scheduling policy can contain up to 10 Match Boolean work rules.
• The Gantt and Appointment Booking features can retrieve up to 2,000 security policies.

6
Field Service Lightning Field Service Lightning Limits and Limitations

• Match Fields work rules aren’t supported for schedule optimization.

• If the Emergency Chatter action is used for an appointment with a scheduling dependency, the dependency isn’t considered
during scheduling.
• Schedule optimization is supported only for service appointments whose parent record is a work order or work order line item.
• Schedule optimization is supported only for service territories with at least one primary territory member.
• If a service appointment doesn’t list an address and therefore lacks a defined latitude and longitude, the scheduling optimizer
uses the appointment’s assigned resource’s home base to make scheduling decisions.
• If a multiday service appointment has a scheduling dependency, its Scheduled End date isn't calculated when the appointment
is scheduled. For this reason, we recommend against creating dependencies between multiday appointments.
• Resource schedule optimization has the following limitations and considerations.
– Under Keep these appointments scheduled, you can select a category of appointments that must remain scheduled.
The optimization can move and then reschedule appointments in this category. If the optimization must keep more than
50 appointments scheduled, it fails.
– Complex work information that’s not fully available in the optimization data is considered excluded from resource schedule
optimization. For example, a partial chain of a scheduling dependency is excluded.
– Resource schedule optimizations can’t run in parallel for the same service resource on the same time interval.
– You can’t run resource schedule optimization on capacity-based resources.
– The Gantt doesn’t show percentage-based progress for resource schedule optimization requests.

• If the Fix Overlaps feature is in use, the “Reshuffle other assignments” option is only partially supported for this setting: When
unable to find a valid schedule for an appointment. If more than one appointment is dropped from the schedule during a
Fix Overlaps operation, only one of the appointments is reshuffled.
• You can use platform encryption with standard Salesforce objects and fields. With the managed package, if you encrypt custom
objects and fields, scheduling and optimization could yield unexpected results.
Service Appointments
• The Owner and Parent Record fields on service appointments aren't available in custom report types. They also can’t be referenced
in formulas, validation rules, workflow rules, flows, or processes. To limit the available owners or types of service appointment
parent records, use an Apex trigger.
• Service appointment fields whose values are inherited from the parent record can’t be referenced in formulas, validation rules,
workflow rules, flows, or processes. The standard inherited fields are Work Type, Account, Parent Record Type, and Parent Record
Status Category.
Service Reports
• Service reports can’t be created on service appointments whose parent records are assets, accounts, leads, or opportunities.
• The Create Service Report action isn’t available in the Salesforce mobile app.
• Section titles and rich text fields in service reports can’t be translated.
• Digital signature field labels can’t be customized.
• Related list filtering on service reports has the following limitations:
– The Status field on contract line items isn’t available for filtering
– The Filters tab isn’t available in Internet Explorer 8

• Service Report Template lookup is not supported in Visualforce pages. To include Service Report Lookup in a Visualforce page
for the edit of a Work Order, create a Custom lookup.

7
Field Service Lightning Field Service Lightning Limits and Limitations

Service Resources
• If you deactivate a service resource, make sure to update records that were associated with that resource. For example, if a
deactivated service resource was a required resource for an account, update that account to prevent scheduling issues.
• Capacity-based service resources have the following limitations.
– If the managed package is installed, capacity-based resources must include a Hours per Time Period value on their capacity
record. If the user’s capacity should be measured in work items, fill out Work Items per Time Period as well and set the Hours
per Time Period to a high number which likely won’t be achieved.
– Capacity serves as a guideline, not a rule. Resources can still be scheduled beyond their capacity, and you aren’t notified
when a resource exceeds their capacity.
– The Fix Overlaps feature isn’t support for capacity-based service resources.
– Schedule optimization respects daily capacity, but not weekly or monthly.
– Resource schedule optimization—the optimization of an individual service resource’s schedule—isn’t supported for
capacity-based service resources.
– If a service resource is capacity-based with a defined capacity, their utilization percentage isn’t shown in the Gantt.
– Capacity-based resources can’t be assigned to appointments that have a scheduling dependency.
– Capacity-based resources can't be relocated or assigned to a secondary service territory.

Street-Level Routing (SLR)

• If a service appointment requires a travel distance of more than 100 kilometers, aerial routing is used.
• Multiday work scheduling doesn’t support SLR and uses aerial routing instead. Predictive travel isn’t supported with complex
work.
• Any scheduling action that is triggered in a transaction with data manipulation language (DML) uses aerial routing. When SLR
is enabled and scheduling requires SLR travel results that are not primed locally, you must use a callout to retrieve the results. If
DML occurs in the same transaction as the callout, it causes an exception. To avoid this exception, allow the system to use aerial
routing or ensure that DML is completed in a separate transaction. If you want transactions of this type to cause an exception
rather than a switch to aerial routing, from the App Launcher, find and open the Field Service Admin app, and then click Field
Service Settings > Scheduling. Select Avoid aerial calculation upon callout DML exception.
Work Capacity Limits
• Work capacity limits serve only as a suggestion, not a rule. Field Service Lightning’s scheduling and optimization features don’t
enforce work capacity limits, so a limit can be exceeded by manual or automatic scheduling.
• The work capacity usage fields, Estimated Usage (Hours), Estimated Usage (Minutes), and Remaining Capacity (Hours), don’t
update to reflect scheduled work, so it’s not possible to track limit progress.
• Service appointment capacity usage records aren’t generated, so the Service Appointment Capacity Usage related list on work
capacity usage records doesn’t show the appointments that count toward the related work capacity limit.

8
Field Service Lightning Set Up Field Service Lightning

Set Up Field Service Lightning

Build and manage your field service operation in one place. Create records representing your
EDITIONS
workforce, set up work order tracking and inventory management, and customize the Field Service
Lightning mobile app to set up your mobile workforce for success. Available in: Salesforce
Classic and Lightning
IN THIS SECTION: Experience

1. Enable Field Service Lightning The Field Service Lightning

Enable Field Service Lightning to start using field service features. core features, managed
package, and mobile app
2. Install the Field Service Lightning Managed Package
are available in Enterprise,
After Field Service Lightning is enabled, install the managed package to gain access to the Performance, Unlimited,
dispatcher console, scheduling tools, a range of custom objects, and Guided Setup. and Developer Editions.
3. Manage Field Service Permissions Work orders are also
Give your team access to Field Service Lightning features by assigning them permission set available in Professional
Edition.
licenses.
4. Set Up Service Territories, Operating Hours, and Shifts for Field Service
Create service territories to track the places where your team performs field service work. Assign regular operating hours to each
service territory to indicate when work can be performed. Create shifts to assign resources to ad hoc hours, such as holiday hours
or for workers without a set schedule.
5. Set Up Work Order Management for Field Service
A work order represents work to be performed on your customers’ products. Customize your work order settings and create time-saving
templates called work types.
6. Set Up Your Field Service Workforce
Create service resources and service crews to represent your mobile workforce. Then, assign permission sets to members of your
team who work as dispatchers or support agents.
7. Set Up Your Field Service Inventory
Track and manage the storage, request, transfer, and consumption of every item in your inventory, and ensure that your mobile
workforce has the right parts in stock to do their job.
8. Get Ready for Scheduling
Define your service appointment life cycle, configure appointment booking settings, and get to know your Field Service Lightning
scheduling policies, optimization settings, and sharing settings.
9. Set Up Field Service in Communities
Keep customers, partners, and contractors in the loop about field service work. Add field service objects to Lightning communities
and communities built using the Salesforce Tabs + Visualforce template.
10. Test Your Field Service Configuration with Health Check
Use the Field Service Health Check to run a suite of automated tests on your Field Service settings and configuration data. When
Health Check identifies a problem, you get on-the-spot recommendations to align your Field Service configuration with our best
practices.
11. Report on Field Service Lightning
Create report types to track field service activity in your org. To take your reporting a step further, use the Field Service Analytics App.
12. Manage Data Integration Rules for Field Service
Set up data integration rules to ensure that service resource travel time is accurately calculated.

9
Field Service Lightning Enable Field Service Lightning

Enable Field Service Lightning

Enable Field Service Lightning to start using field service features.
EDITIONS
1. From Setup, enter Field Service Settings in the Quick Find box, then select Field
Service Settings. Available in: Salesforce
Classic and Lightning
2. Enable Field Service Lightning, and click Save to display more settings.
Experience
Note: If you don’t have a Field Service Lightning add-on license, you just see an option
The Field Service Lightning
to enable work orders, which is on by default.
core features, managed
3. Optionally, turn on in-app notifications for Salesforce app and Lightning Experience users when package, and mobile app
are available in Enterprise,
any of the following actions occurs on a work order or work order line item that they own or
Performance, Unlimited,
follow:
and Developer Editions.
• A text or file post is added Work orders are also
• A tracked field is updated available in Professional
Edition.
• The record owner changes
• The resource assignments change on a related service appointment
USER PERMISSIONS
If the option to track all related objects is selected in your feed tracking settings for work orders,
users are also notified when child records of work orders—such as service appointments—are To enable Field Service
created or deleted. Lightning:
• Customize Application
4. Optionally, update the sharing settings. See Limit Access to Field Service Records.
5. When you set up work types, which are templates for work orders, you can opt to automatically
add a service appointment to new work orders or work order line items associated with a work type. Configure the number of days
between the created date and due date on auto-created service appointments.
6. If you want to use your knowledge base in field service, select the fields that the search engine scans to suggest articles on work
orders or work order line items.
7. Save your changes.

10
Field Service Lightning Install the Field Service Lightning Managed Package

Install the Field Service Lightning Managed Package

After Field Service Lightning is enabled, install the managed package to gain access to the dispatcher
EDITIONS
console, scheduling tools, a range of custom objects, and Guided Setup.
When you install the Field Service Lightning managed package, you get the following features. Available in: Salesforce
Classic and Lightning
• Guided Setup: There’s no need to go it alone! This nifty tool walks you through key setup tasks,
Experience
including assigning permission sets, creating service resources, and customizing appointment
booking settings. The Field Service Lightning
• Scheduling and optimization: Swiftly optimize your team’s schedule in a way that enforces core features, managed
your business objectives. Assign appointments according to your rules and priorities, such as package, and mobile app
technician skills, location, and availability. are available in Enterprise,
Performance, Unlimited,
• Dispatcher console: Give dispatchers and supervisors a bird’s-eye view of your field service and Developer Editions.
operations. The dispatcher console includes a customizable appointment list, easy-to-reach Work orders are also
scheduling actions, dynamic Gantt chart, and interactive map. Dispatchers can check that jobs available in Professional
are routed to the right people, receive alerts, and monitor appointments in real time. Edition.
• Administration app: Manage optimization, customize the dispatcher console, and update
your managed package settings in one place.
USER PERMISSIONS
1. Click the installation link on the download page:
https://fsl.secure.force.com/install To install the Field Service
Lightning managed
You can install the managed package on a production or sandbox org. package:
2. Select Install for Admins Only. • Customize Application

If you receive a request to approve third-party access, click Yes and Continue. Approving this To assign a permission set
license:
request allows the street-level routing and optimization services to function.
• Manage Users
3. If a message indicates that the installation is taking longer than expected, click Done. To create a permission set:
You’ll receive an email notification after the installation is complete. • Manage Profiles and
Permission Sets
Once the package is installed, the App Launcher includes two new apps.

• The Field Service app is for dispatchers. The Field Service tab in this app leads to the dispatcher console.
• The Field Service Admin app is for administrators. The Field Service Settings tab in this app leads to the managed package settings.
You can add the Field Service and Field Service Settings tabs to other apps.

11
Field Service Lightning Manage Field Service Permissions

Note: Salesforce Setup includes a separate Field Service Settings page where you can customize general settings related to field
service.

Manage Field Service Permissions

Give your team access to Field Service Lightning features by assigning them permission set licenses.
EDITIONS
Field service players usually fall into one or more of the following profiles.
Available in: Salesforce
Admin
Classic and Lightning
A Salesforce admin integrates Field Service Lightning features and sets up user permissions as
Experience
needed for your org.
Agent The Field Service Lightning
Agents handle inbound cases, create work orders, and book appointments from the dispatcher core features, managed
package, and mobile app
console.
are available in Enterprise,
Dispatcher Performance, Unlimited,
Dispatchers build and manage appointments, assign technicians, and optimize the schedule and Developer Editions.
based on technician skills, routing, and job priority. Work orders are also
Technician available in Professional
Edition.
Field resources or technicians receive work orders and appointments from dispatchers or agents.
They also update job progress from mobile devices with the Salesforce mobile app or the Field
Service Lightning mobile app. USER PERMISSIONS
All users need the Field Service Standard user permission to access field service objects. Most user
To access field service
licenses already include this permission; for the full list of licenses, contact Salesforce Support. objects:
Field Service Lightning also includes three permission set licenses related to the managed package • Field Service Standard
and mobile app. We recommend using the managed package’s Guided Setup tool to assign these To assign a permission set
permission set licenses; for steps, see Assign Field Service Lightning Permissions. license:
• Manage Users
Permission Set License Description Who Needs It To create a permission set:
Field Service Dispatcher Provides access to the Dispatchers • Manage Profiles and
dispatcher console Permission Sets

Field Service Scheduling Allows the user to be shown on Technicians

the dispatcher console Gantt
and included in scheduling and
optimization

12
Field Service Lightning Manage Field Service Permissions

Permission Set License Description Who Needs It

Field Service Mobile Provides access to the Field Service Mobile users (typically technicians)
Lightning mobile app

You don’t need a permission set license to access field service objects. For example, inventory managers, admins, and customer support
agents probably don’t need one. However, for these users to access field service records, Field Service Lightning must be enabled.

IN THIS SECTION:
Create Field Service Permission Sets
Create Field Service Lightning permission sets from the Field Service Admin app.
Assign Field Service Lightning Permissions
After you create your field service permission sets, give users the permissions they need to complete their field service tasks. You
can assign permissions in Setup or in Guided Setup.
Set Custom Permissions for Field Service
The Field Service Lightning managed package includes custom permissions that control users’ access to actions and views. For
example, you can control access to bulk actions, such as dispatching, optimizing, and scheduling, or the ability to drag and drop
appointments on the Gantt.
Assign Field Service Page Layouts
The Field Service Lightning managed package provides standard object page layouts that include field service Visualforce components
and Chatter actions. Assign these page layouts to the System Administrator and Standard User profiles.

13
Field Service Lightning Manage Field Service Permissions

Create Field Service Permission Sets

Create Field Service Lightning permission sets from the Field Service Admin app.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Classic and Lightning
Service Settings tab. Experience
2. Click Getting Started > Permission Sets. The Field Service Lightning
3. On each tile, click Create Permissions. The following permission sets are created. core features, managed
package, and mobile app
Tile Name Permission Sets Created Purpose are available in Enterprise,
Performance, Unlimited,
FSL Admin FSL Admin License* Let users access and manage and Developer Editions.
FSL Admin Permissions all Field Service Lightning Work orders are also
objects, including the Field available in Professional
Service Lightning Visualforce Edition.
pages and logic services. FSL
Admin Permissions contains
USER PERMISSIONS
the permissions included in
FSL Dispatcher Permissions To configure the Field Service
along with additional Lightning managed
configuration permissions. package:
• Customize Application
FSL Agent FSL Agent License* FSL Agent Permissions
To assign a permission set
FSL Agent Permissions provides the minimum
license:
permissions needed to use
• Manage Users
the field service Chatter
actions, such as the Book To create a permission set:
Appointment, Get Candidates, • Manage Profiles and
Permission Sets
and Emergency.

FSL Resource FSL Mobile License • FSL Mobile License

FSL Scheduling License provides the permission
FSL Resource Permissions set license needed for
users to log in to the Field
Service Lightning mobile
app.
• FSL Scheduling License
provides the permission
set license needed for the
user to be shown on the
Gantt and scheduled by
the scheduling engine
and optimizer.
• FSL Resource Permissions
provides the minimum
permissions needed for
users to update
appointment status and

14
Field Service Lightning Manage Field Service Permissions

Tile Name Permission Sets Created Purpose

update their last known location.

FSL Dispatcher FSL Dispatcher License • FSL Dispatcher License gives users the
FSL Dispatcher Permissions permission set license needed to load
the dispatcher console.
• FSL Dispatcher Permissions contains
the permissions included in FSL Agent
Permissions and FSL Resource
Permissions along with permissions to
operate the dispatcher console and
run optimization.

FSL Self Service FSL Self Service License Let community users view all global
FSL Self Service Permissions actions and their related objects for
creating, booking, and scheduling their
own appointments.

FSL Community Dispatcher FSL Community Dispatcher License Let users view and use the dispatcher
FSL Community Dispatcher Permissions console, view global actions and their
related objects, and schedule, optimize,
and dispatch service appointments.

*Newer Salesforce orgs don’t need the FSL Agent License and FSL Admin License permission sets. In these orgs, Salesforce doesn’t create
these two permission sets.
When a permission set is current, the Create Permissions link on the tile is replaced by a message indicating that it’s up to date.

15
Field Service Lightning Manage Field Service Permissions

Assign Field Service Lightning Permissions

After you create your field service permission sets, give users the permissions they need to complete
EDITIONS
their field service tasks. You can assign permissions in Setup or in Guided Setup.
1. From Setup, enter Manage Users in the Quick Find box, then select Manage Users > Available in: Salesforce
Users. Classic and Lightning
Experience
2. Click a user’s name.
3. Click Permission Set Assignments at the top of the page or scroll down to the Permission The Field Service Lightning
Set Assignments related list. core features, managed
package, and mobile app
4. Click Edit Assignments. are available in Enterprise,
5. Enable the appropriate permission sets and click Save. Performance, Unlimited,
and Developer Editions.
Tasks Permission Sets Work orders are also
available in Professional
Admin: Manage all Field Service Lightning • FSL Admin License* Edition.
objects, including the Field Service Admin
• FSL Admin Permissions
app, Field Service Lightning Visualforce pages,
USER PERMISSIONS
and logic services.

Agent: Access all global actions and their To assign a permission set
• FSL Agent License* license:
related objects to create, book, and schedule
• FSL Agent Permissions • Manage Users
service appointments.
To create a permission set:
Dispatcher: Access all global actions and their • FSL Dispatcher License • Manage Profiles and
related objects to create, book, and schedule Permission Sets
• FSL Dispatcher Permissions
service appointments.

Technician: Manage service appointments • FSL Mobile License

and their related parent objects.
• FSL Scheduling License
• FSL Resource Permissions

*Newer Salesforce orgs don’t need the FSL Agent License and FSL Admin License permission sets. In these orgs, Salesforce won’t
create these two permission sets, so they don’t need to be assigned.

Tip: Alternatively, you can assign permission sets to users from Guided Setup in the Create Service Resources and Create
Dispatchers and Agents steps. Simply click an icon in the Licenses column to assign a permission set license and its associated
permission sets to a user. You can always make further changes in Setup.

This is a Field Service Lightning managed package feature.

16
Field Service Lightning Manage Field Service Permissions

IN THIS SECTION:
How Are Field Service Permission Sets Updated?
Permission sets provided by the Field Service Lightning managed package are automatically updated at the beginning of each major
release.

How Are Field Service Permission Sets Updated?

Permission sets provided by the Field Service Lightning managed package are automatically updated
EDITIONS
at the beginning of each major release.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
The managed package has three major releases each year that follow Salesforce’s release cadence Experience
within 72 hours: Winter, Spring, and Summer.
The Field Service Lightning
Because new versions require new permissions, the permission sets provided by the managed core features, managed
package must be updated to include any new required permissions. All managed package-provided package, and mobile app
permission sets are updated when a user launches one of the following pages: are available in Enterprise,
• Dispatcher Console (vf001_ServiceExpert) Performance, Unlimited,
and Developer Editions.
• Book Appointment Chatter action (AppointmentBookingVf and
Work orders are also
AppointmentBookingCommunitiesVf) available in Professional
• Candidates Chatter action (GetCandidates) Edition.
• Emergency Chatter action (EmergencyWizard)
• Admin Settings (vf066_settings)
During this update process, any “minimum” permissions that were removed from the permission set are readded. Permissions added
by an admin aren’t removed.
To check if a permission set is current, from the App Launcher, find and open the Field Service Admin app. Click Field Service Settings >
Getting Started > Permission Sets. Each permission set tile should include a message indicating that it is current. If it doesn’t, click
Update Permissions on the tile.

Important: Auto-update of permission sets is logged on the behalf of the user who triggered the update, even if the user doesn’t
have permission to update permission sets. To turn off this process, ask Salesforce to disable the Auto Update of FSL Permission Sets
feature.

17
Field Service Lightning Manage Field Service Permissions

Set Custom Permissions for Field Service

The Field Service Lightning managed package includes custom permissions that control users’
EDITIONS
access to actions and views. For example, you can control access to bulk actions, such as dispatching,
optimizing, and scheduling, or the ability to drag and drop appointments on the Gantt. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Assign custom permissions to users on the Custom Permissions page in Setup. For example, add
The Field Service Lightning
them to the FSL Admin, FSL Dispatcher, and FSL Community Dispatcher custom FSL permission
core features, managed
sets.
package, and mobile app
Optionally, you can give users the extended custom permissions marked in the table. To use these are available in Enterprise,
permissions, add them to users, and then activate them in Field Service Settings > Dispatcher Performance, Unlimited,
Console UI > Extended Custom Permissions. and Developer Editions.
Work orders are also
Important: If you activate the extended permissions without first adding them to users, you available in Professional
make the Gantt read-only. Activation is required only once in existing orgs and is irreversible. Edition.
The managed package custom permissions use the FSL namespace prefix.

Custom Permission Description

Abort Optimization Request Abort an optimization request from the Gantt.

Bulk Dispatch Dispatch selected appointments from the appointment list.

Bulk Optimize Submit an optimization request using Optimize in the appointment list action menu.

Bulk Schedule Schedule selected appointments with the Schedule button on the appointment list or on polygons.

Bulk Unschedule Unschedule selected appointments from the appointment list action menu or on polygons.

Create Absences from Gantt Create resource absences on the Gantt.

Create Custom Gantt Filters Create custom filters for appointments on the Gantt.

Fill-in Fill in schedule gaps using Fill-In Schedule on the resource action menu.

Fix Overlaps Resolve overlapping appointments using Fix Overlaps on the resource action menu.

Enable Gantt Locker Lock and unlock the Gantt using the Gantt locker. Without this permission, Gantt access is read-only.
(This permission is an extended custom permission.)

Gantt - Enable Gantt Policy Select a non-default policy for scheduling and calculating rule violations. (This permission is an
Picker extended custom permission.)

Gantt and List - Show Get Find resources for an appointment using Get Candidates on the appointment list, or when
Candidates right-clicking services on the Gantt. (This permission is an extended custom permission.)

Gantt and Map - Enable Drag Drag selected services from the appointment list, map, or Gantt, and place them on the Gantt. (This
and Drop permission is an extended custom permission.)

Gantt Palettes Edit Create, edit, and delete Gantt palettes.

Gantt Palettes View View the Palettes tab in the Gantt and apply the selected palette.

Gantt - Show Change Status Change status when you right-click services on the Gantt. Without this permission, users can't dispatch
Action from the map. (This permission is an extended custom permission.)

18
Field Service Lightning Manage Field Service Permissions

Custom Permission Description

Gantt - Show Pin Service Pin or unpin appointments when you right-click services on the Gantt. (This permission is an extended
custom permission.)

Gantt - Show Unschedule Unschedule appointments when you right-click services on the Gantt. (This permission is an extended
custom permission.)

Group Nearby Adjusts the schedule to find other appointments on that day that are close to the selected
appointment. The Group Nearby action is available when you right-click services on the Gantt.

Hide map on Emergency Wizard Hide the map view in the Emergency Wizard and show just the candidates instead.

Longterm View See the Long-Term Gantt view in the dispatcher console. When this permission is enabled, the
Long-Term Gantt view replaces the multi-day view.

Map Polygons - Show In Show the In Jeopardy flag when you right-click a map polygon. (This permission is an extended
Jeopardy custom permission.)

MDT View See the multi-day view in the dispatcher console. The Long-Term Gantt view replaces the multi-day
view.

Monthly Utilization Show utilization in the Gantt resolution menu in the top-right corner.

Policy Picker in Appointment Change the scheduling policy in the Book Appointment action.
Booking

Policy Picker in Get Candidates Change the scheduling policy in the Get Candidates action.

Polygons - create\update Create and update map polygons.

Polygons - view View map polygons.

Publish custom Gantt filters Share custom filters for appointments on the Gantt.

Reshuffle Reshuffle appointments from the appointment action menu, or when you right-click services on the
Gantt.

Resource Schedule Optimization Optimize a resource's schedule using Resource Schedule Optimization from the resource action
menu.

Schedule Schedule an appointment from the appointment list or from the map.

Service List View - Canceled Show the Canceled appointment list.

Service List View - Contractors Show the Contractors appointment list.

Service List View - Crews Show the Crews appointment list.

Service List View - Flagged Show the Flagged appointment list.

Service List View - Gantt Show the Gantt appointment list.

Service List View - In Jeopardy Show the In Jeopardy appointment list.

Service List View - Rule Violating Show the Rule Violating appointment list.

Service List View - Scheduled Show the Scheduled appointment list.

19
Field Service Lightning Manage Field Service Permissions

Custom Permission Description

Service List View - Selected Show the Selected appointment list.

Service List View - Todo Show the Todo appointment list.

Service List View - Unscheduled Show the Unscheduled appointment list.

Streaming API After activating Gantt Live Updates in your org, use the streaming API to send live streaming updates
of the Gantt. When this permission is disabled, users see only Gantt changes timed using the interval
defined in Field Service Settings > Dispatcher Console UI > Timed Updates.

Utilization on Service Territory For the selected Gantt horizon, view utilization percentages for each territory’s workforce.

View resource on secondary STM If enabled, show a resource’s secondary territory membership on the Gantt.

Example: To limit the dispatchers who can optimize your schedule so the system isn’t bogged down with optimization requests,
remove custom permissions for bulk actions in the dispatcher console:
• FSL.Bulk Dispatch
• FSL.Bulk Optimize
• FSL.Bulk Schedule
• FSL.Bulk Unschedule
A user with the FSL.Bulk Optimize custom permission sees the Optimize action. Users without it can’t run an optimization. Removing
any of these custom permissions hides the action in the user interface.

20
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

Assign Field Service Page Layouts

The Field Service Lightning managed package provides standard object page layouts that include
EDITIONS
field service Visualforce components and Chatter actions. Assign these page layouts to the System
Administrator and Standard User profiles. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Important: If you created your own field service profiles, perform the following steps on
The Field Service Lightning
those profiles instead of the standard profiles. core features, managed
1. From Setup, enter Profiles in the Quick Find box, then click Profiles. package, and mobile app
are available in Enterprise,
2. Click System Administrator.
Performance, Unlimited,
3. In the Page Layouts section, find the Operating Hours object and click View Assignment. and Developer Editions.
4. Selecting all profiles and assign the FSL Operating Hours Layout. Work orders are also
available in Professional
5. Click Save. Edition.
6. Repeat the previous steps for the following objects.
• Service Appointment: Assign the FSL Service Appointment Layout USER PERMISSIONS
• Service Resource: Assign the FSL Service Resource Layout
To customize the Field
• Work Order: Assign the FSL Work Order Layout Service Lightning managed
• Work Order Line Item: Assign the FSL Work Order Line Item Layout package:
• Customize Application
• Work Type: Assign the FSL Work Type Layout
To assign page layouts:
7. Save your changes. • Manage Profiles and
Permission Sets
8. Repeat the previous steps for the Standard User profile.

Set Up Service Territories, Operating Hours, and Shifts for Field Service
Create service territories to track the places where your team performs field service work. Assign
EDITIONS
regular operating hours to each service territory to indicate when work can be performed. Create
shifts to assign resources to ad hoc hours, such as holiday hours or for workers without a set schedule. Available in: Salesforce
Classic and Lightning
IN THIS SECTION: Experience

Create Service Territories for Field Service The Field Service Lightning
Create hierarchies of service territories to organize your field service workforce and ensure that core features, managed
service resources are assigned to service appointments near their home base. Service territories package, and mobile app
typically represent geographical areas where your team works, but they can also be functional are available in Enterprise,
territories such as field sales and field service. Performance, Unlimited,
and Developer Editions.
Set Up Shifts for Field Service Lightning Work orders are also
Shifts in Field Service Lightning let you define variable working periods for your shift-based available in Professional
workforce, such as contractors or on-call staff. Create shifts for particular dates and times when Edition.
you need coverage, and assign them to service resources. When the managed package is
installed, scheduling and Enhanced Optimization consider workforce availability during shifts.

21
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

Create Service Territories for Field Service

USER PERMISSIONS EDITIONS

To create service territories: Create on service territories Available in: Salesforce

Classic and Lightning
To view service territories and the Service Read on service territories
Experience
Territories tab:
The Field Service Lightning
To edit service territories: Edit on service territories
core features, managed
To delete service territories: Delete on service territories package, and mobile app
are available in Enterprise,
To view service territory locations: Read on service territories Performance, Unlimited,
To create, update, or delete service territory Edit on service territories and Developer Editions.
locations: Work orders are also
available in Professional
To view service territory members: Read on service territories Edition.

To create, update, or delete service territory Edit on service territories

members:

Create hierarchies of service territories to organize your field service workforce and ensure that service resources are assigned to service
appointments near their home base. Service territories typically represent geographical areas where your team works, but they can also
be functional territories such as field sales and field service.
Before you start, make a list of the territories you want to create and who works in each territory. To keep scheduling straightforward,
try to create territories with no more than 50 technicians assigned to them.
You can organize service territories into hierarchies of up to 10,000 territories. We recommend creating the highest-level territories first.
For example, create a San Francisco Bay Area territory with four child territories: Peninsula, North Bay, South Bay, and East Bay.
If the Field Service Lightning managed package is installed, use Guided Setup to quickly create your service territories.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Go to Guided Setup. When you launch guided setup, your Field Service Lightning permission sets are scanned to make sure
that they’re up-to-date. You’ll see a message if you’re missing a necessary permission.
3. Click Create Service Territories.
4. Create your territories one by one. Click a territory name to update its name, operating hours, and address.
5. Operating hours indicate the working hours of technicians in the territory. Territory members use these hours unless different hours
are specified on their service territory member records. Use the lookup to select existing operating hours, or click New Operating
Hours to create your own.
• To create more complex or varying time slots, save your new operating hours and click Open Operating Hours Record below
the Operating Hours field. Then, customize your time slots in the Time Slots related list.
• To avoid issues with appointment booking, always specify a time zone on your operating hours.

6. Drag territories within the list to create a hierarchy.

7. To update additional fields on a service territory or attach files, select the territory name and click Open Service Territory Record.
If the managed package isn’t installed, create and manage service territories from the Service Territories tab.

22
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

IN THIS SECTION:
Guidelines for Creating Service Territories for Field Service
Learn how to use service territories to track where your field service team works.
Guidelines for Creating Operating Hours for Field Service
Operating hours in Field Service Lightning can represent technician hours, service territory hours, appointment arrival windows, and
customer appointment time preferences. Learn how to set operating hours for each scenario.

Guidelines for Creating Service Territories for Field Service

Learn how to use service territories to track where your field service team works.
EDITIONS
Creating Service Territories
Create service territories from Guided Setup or from the Service Territories tab. Depending on Available in: Salesforce
how your business works, you may decide to create territories based on cities, counties, or other Classic and Lightning
factors. If you plan to build out a hierarchy of service territories, create the highest-level territories Experience
first. Service territory hierarchies can contain up to 10,000 territories.
The Field Service Lightning
Note: When you create a service territory, public groups are created in your org. These core features, managed
groups are used with the Field Service Lightning managed package to ensure that the package, and mobile app
correct data is available even when field service object access is set to private. are available in Enterprise,
Performance, Unlimited,
Determining Territory Size and Developer Editions.
The size of your service territories has a significant impact on scheduling, optimization, and Work orders are also
dispatching. If a service territory is too large and many service resources and dispatchers are available in Professional
assigned to it, optimization and dispatching become cumbersome. Try to stay within these Edition.
suggested limits when designing your service territories:
• Up to 50 service resources per service territory
• Up to 1,000 service appointments per day per service territory
• Up to 20 qualified service resources per service appointment
Creating Service Territory Members
Service territory members are service resources who work within the territory. Associating them with a territory ensures that they’re
assigned to appointments near their home base.
Assign service resources to service territories in the Service Territories related list on the resource detail page or the Service Territory
Members related list on the territory detail page. Use the Type field to indicate whether the territory is a primary, secondary, or
relocation territory for the resource.
• The primary territory is typically the territory where the resource works most often—for instance, near their home base. Resources
can have only one primary territory. If a Match Territory work rule is included in the applied scheduling policy, the resource can
be assigned only to appointments in their primary or relocation territories.
• Secondary territories are territories where the resource can be assigned to appointments if needed. A resource can have more
than one secondary territory.
• Relocation territories represent temporary moves and, during their active dates, serve as the primary territory during scheduling.
If a Working Territories work rule is included in the applied scheduling policy, the resource can also be assigned to appointments
in their secondary territories.
Setting Membership Start and End Times
Follow these best practices to avoid issues during scheduling and optimization.
• Service territory memberships should be 24 hours or longer.

23
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

• Service territory memberships should start and end at the same hour, and shouldn’t fall inside the operating hours listed on the
membership record (or if no hours are listed, on the service territory). This way, there’s no question about the resource’s availability
on their first day as a member of the territory. For simplicity, we recommend using midnight (00:00). For example:
– Start Date: 1/12/2019 00:00
– End Date: 3/12/2019 00:00

Note: We recommend using 00:00 because it aligns with Field Service Lightning’s default Start of Day, which is 00:00.
However, you can set a custom Start of Day on Service Resource Availability work rules if the default doesn’t make sense—for
example, if your team typically works night shifts. To enforce a custom Start of Day, from the Field Service Admin app, click
Field Service Settings > Scheduling and select Set the hour that starts a new day based on the Availability rule(s).
If the applied scheduling policy uses a custom Start of Day, set your service territory memberships to start and end at that
time rather than at midnight.

• During scheduling and optimization, Field Service Lightning uses the service territory member’s own time zone—set on the
user record—to interpret the territory membership start and end times. If the user’s time zone differs from the service territory’s
time zone, adjust the membership start and end time accordingly. For example, if the user’s time zone is 3 hours behind the
service territory’s time zone, set the territory membership start time to 3:00 rather than 00:00.
• If you're using Enhanced Optimization, service territory memberships can't be longer than three years. If you need a service
territory membership to be longer than three years, keep the End Date fields blank.
Deleting Service Territories
You can’t delete a service territory with service appointments. If you try to delete it, you’re prompted to assign the appointments to
a different territory.
If you delete a service territory with members, the service resources who were members no longer have a connection to the territory.
Adding Locations to Service Territories
Associate location records with service territories from the Service Territory Locations related list. Add site, plant, and warehouse
locations to the service territory in which they’re located. Add mobile locations, like vans, to the service territories where they can
be used for field service work.

Guidelines for Creating Operating Hours for Field Service

USER PERMISSIONS EDITIONS

To view operating hours and time slots: Read on operating hours Available in: Salesforce
Classic and Lightning
To create operating hours: Create on operating hours
Experience
To assign operating hours to service Edit on service resources
The Field Service Lightning
resources:
core features, managed
To assign operating hours to service Edit on service territories package, and mobile app
territories: are available in Enterprise,
Performance, Unlimited,
To assign operating hours to accounts: Edit on accounts and Developer Editions.
To update, create, or delete time slots: Edit on operating hours Work orders are also
available in Professional
Edition.

Operating hours in Field Service Lightning can represent technician hours, service territory hours,
appointment arrival windows, and customer appointment time preferences. Learn how to set
operating hours for each scenario.

24
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

When operating hours are They represent... How to configure

associated with...
Accounts The hours when the customer allows service Update the Operating Hours field on an
appointments account.

Service territories The default working hours for the service Select operating hours when creating a
territory members, unless different hours service territory in Guided Setup. Or, update
are specified on a service territory member the Operating Hours field on the service
record. territory record.

Service territory members The hours when the member (a service Update the Operating Hours field on a
resource) is available to work service territory member record.

Appointment booking The appointment booking arrival windows Select your default operating hours for
offered to customers during scheduling appointment booking in the Customize
Appointment Booking step in Guided
Setup. Or, from the App Launcher, find and
open the Field Service Admin app, and
then click Field Service Settings > Global
Actions > Appointment Booking. Then,
update the Default Operating Hours field.

Tip: If different appointment booking windows are needed for different level of service—for instance, standard customers get
4-hour booking windows while VIP customers get 2-hour windows—add entitlements to your work orders. In the Operating Hours
field on the entitlement, select the appropriate appointment booking window operating hours.

Create Operating Hours

We recommend creating operating hours in Guided Setup—a Field Service Lightning managed package feature—to save time and
gain visibility into how they’re used. Operating hours are an element of the following Guided Setup steps.
• Create Service Territories
• Create Service Resources
• Customize Appointment Booking
You can also create and manage operating hours from the Operating Hours tab, outside of Guided Setup. By default, only System
Administrators can view, create, and assign operating hours.
Operating hours are composed of time slots, which are managed from the Time Slots related list on an operating hours record. Time
slots can vary by day. A day can have multiple time slots, but they must be adjacent for the hours to be respected during optimization.
For example, an operating hours record can have the following time slots.
• Monday, 9 AM to 5 PM
• Tuesday, 9 AM to 5 PM
• Wednesday, 6 AM to 12 PM and Wednesday, 12 PM to 6 PM
• Thursday, 9 AM to 5 PM
• Friday, 9 AM to 5 PM
Each operating hours record is associated with a time zone, which ensures that scheduling and optimization function properly. For
appointment booking hours, Field Service Lightning uses the time zone listed on the operating hours of the service appointment’s

25
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

service territory. This way, one operating hours record can be used to represent appointment booking windows across your customer
base.

Note: If you have access to 2,000 or more service territories, the appointment list shows only selected territories. Use the search
bar to find territories that aren't selected.

Assign Operating Hours to Service Resources

A service resource’s hours can vary depending on the service territory where the resource is working. Service resources therefore have
unique operating hours for their primary and secondary territories. Service territory members automatically use their service territory’s
operating hours, although the Operating Hours field on the service territory member record appears blank. If a resource needs different
operating hours than their territory, assign them separate operating hours on their service territory member record.
To view a service territory member record, click the member number in one of the following related lists.
• Service Territory Members list on the service territory
• Service Territories list on the service resource
Operating hours listed on a secondary territory member record are respected during scheduling only if:
• They use the same time zone as the resource’s primary territory membership’s hours
• They are identical to or contained within the resource’s primary territory membership’s hours
• Respect secondary STM operating hours is selected in the Field Service Admin app. Click Field Service Settings > General
Logic .
Otherwise, the primary service territory operating hours are used.
For example, suppose a user has a primary and secondary service territory. Her Monday hours are 12 PM to 5 PM in the primary territory,
but 9 AM to 5 PM in the secondary territory. When she’s being scheduled to a Monday service appointment in the secondary territory,
her primary hours are used because they’re more restrictive.

Enforce Operating Hours

If the Field Service Lightning managed package isn’t installed, operating hours serve as a suggestion rather than a rule. If the managed
package is installed, here’s how operating hours affect scheduling.
• During schedule optimization, service resources are assigned only to appointments that fall within the operating hours listed on
their service territory member record or, if none are listed, on the primary service territory record.
• The Field Service - Service Appointment Visiting Hours work rule type ensures that a customer’s appointments fall within their
account’s operating hours. Add a work rule of this type to any scheduling policy.

Tip: Create Apex triggers that limit time slot settings. For example, restrict the start and end times on time slots to half-hour
increments, or prohibit end times later than 8 PM.

26
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

Set Up Shifts for Field Service Lightning

Shifts in Field Service Lightning let you define variable working periods for your shift-based workforce,
EDITIONS
such as contractors or on-call staff. Create shifts for particular dates and times when you need
coverage, and assign them to service resources. When the managed package is installed, scheduling Available in: Lightning
and Enhanced Optimization consider workforce availability during shifts. Experience

The Field Service Lightning

IN THIS SECTION: core features, managed
What Are Shifts? package, and mobile app
Shifts let you set up work intervals that vary from day to day or week to week. You can extend are available in Enterprise,
or replace your operating hours with shifts. Performance, Unlimited,
and Developer Editions.
Create a Job Profile for Shifts Work orders are also
A job profile lets you describe different types of shifts based on the required skills—for example, available in Professional
a night manager versus weekend on-call worker. Add skills to a job profile to indicate the Edition.
experience or expertise that's required for a service resource.

What Are Shifts?

Shifts let you set up work intervals that vary from day to day or week to week. You can extend or
EDITIONS
replace your operating hours with shifts.
Shifts are similar to operating hours in Salesforce, with some key differences. Operating hours let Available in: Lightning
you define consistent, ongoing time slots when your team is available. Shifts, by contrast, let you Experience
define variable time slots that can vary from day to day. You can use both shifts and operating hours
The Field Service Lightning
to assign work, so that you can assign team members to shifts where and when they’re needed.
core features, managed
For example, if you use operating hours for your regular weekday hours, you can create shifts to package, and mobile app
define weekend on-call duties. Shifts can also replace operating hours; for example, you can create are available in Enterprise,
shifts for a workforce of students or contractors that don’t have regular work hours. Performance, Unlimited,
and Developer Editions.
When the managed package is installed, scheduling and Enhanced Optimization consider shift
Work orders are also
availability. Confirmed shifts appear on the Gantt.
available in Professional
Edition.
Prerequisites for Using Shifts
Make sure that your Salesforce org meets the following requirements to use shifts.
• You must have at least one service territory.
• You must have at least one service resource who’s assigned to a service territory.
• To let them create shifts, give your shift and service managers access to view, create, and edit the following objects:
– Shifts
– Job Profiles
– Service Territories
– Service Resources
– Service Territory Memberships

• To select job profiles when you create shifts, add the Job Profile field to shift layouts.

27
Field Service Lightning Set Up Service Territories, Operating Hours, and Shifts for
Field Service

Limitations for Shift Management

• Scheduling and optimization features in the managed package don’t consider job profiles.
• In the Shifts tab, you can't use the quick search box to filter.
• The NOT operator isn't supported when you define filter logic for shifts. If your filter logic uses NOT, we recommend adjusting the
filter type instead, for example by using the does not contain operator.

Create a Job Profile for Shifts

A job profile lets you describe different types of shifts based on the required skills—for example, a
EDITIONS
night manager versus weekend on-call worker. Add skills to a job profile to indicate the experience
or expertise that's required for a service resource. Available in: Lightning
1. From the App Launcher, click Job Profiles. Experience
2. Click New. The Field Service Lightning
3. Enter a name and description for the job profile. core features, managed
package, and mobile app
4. Associate skills with the job profile. are available in Enterprise,
a. In the Related tab, next to Skill Requirements, click New. Performance, Unlimited,
and Developer Editions.
b. Select the skill and skill level that are required for the job profile. You can also create skills.
Work orders are also
c. Click Save. available in Professional
Edition.
To continue adding skills, repeat these steps.
5. Click Save.
USER PERMISSIONS

To view, create, and update

shifts and job profiles
• View, create, and edit on
Shifts, Job Profiles,
Service Territories,
Service Resources,
Service Territory
Memberships

28
Field Service Lightning Set Up Work Order Management for Field Service

Set Up Work Order Management for Field Service

A work order represents work to be performed on your customers’ products. Customize your work
EDITIONS
order settings and create time-saving templates called work types.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Create Work Types for Field Service
Chances are, your business performs the same tasks for multiple customers. Work types are The Field Service Lightning
templates that save you time and make it easier to standardize your field service work. core features, managed
package, and mobile app
Customize Work Order Settings for Field Service
are available in Enterprise,
To control how your team works with work orders and work types, customize page layouts and Performance, Unlimited,
assign user permissions. and Developer Editions.
Set Up Knowledge for Work Orders Work orders are also
Attach knowledge articles to work orders, work order line items, and work types to share available in Professional
Edition.
guidelines and specs with technicians in the field. Learn how to customize page layouts to let
your team view or manage attached articles, also known as linked articles.
Set Up Path for Field Service
To guide your team as they complete field service jobs, add an interactive, color-coded progress bar to work orders, work order line
items, and service appointments.

Create Work Types for Field Service

Chances are, your business performs the same tasks for multiple customers. Work types are templates
EDITIONS
that save you time and make it easier to standardize your field service work.
Before you start, make a list of the work types you want to create. For example, a heater installation Available in: Salesforce
company can create work types names Install Heater, Repair Heater, and Replace Heater. List the Classic and Lightning
skills and parts required to complete each task, and any knowledge articles that should be attached Experience
to it such as specs or guidelines.
The Field Service Lightning
If the Field Service Lightning managed package is installed, use Guided Setup to quickly create your core features, managed
work types. package, and mobile app
are available in Enterprise,
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field
Performance, Unlimited,
Service Settings tab.
and Developer Editions.
2. Click Go to Guided Setup. When you launch guided setup, your Field Service Lightning Work orders are also
permission sets are scanned to make sure that they’re up-to-date. You’ll see a message if you’re available in Professional
missing a necessary permission. Edition.
3. Click Create Work Types and Skills.
4. Enter a name to create a work type, and update the Name, Description, Due Date Offset, and USER PERMISSIONS
Estimated Duration.
To create work types:
Tip: Hover over each field’s info icon for help filling it out. • Create on work types
To apply work types to work
5. Select Auto-Create Service Appointment to generate a child service appointment when a orders or work order line
work order or work order line item is created from the work type. items:
• Edit on work orders

29
Field Service Lightning Set Up Work Order Management for Field Service

6. Optionally, add required skills to represent the expertise or certification needed to complete the work. You can add a skill level from
the work type’s Skill Requirements related list, outside of Guided Setup.
7. To update additional fields and add supporting records, select a work type in the list and click Open Work Type Record.

8. To apply a work type to a work order or work order line item, select the work type in the Work Type field on the record when creating
it. When you add a work type, the record inherits settings from the work type.
If the managed package isn’t installed, create and manage work types from the Work Types tab.

IN THIS SECTION:
Guidelines for Creating Work Types for Field Service
Work types help you standardize your field service processes. Learn about inherited work type settings, required skills and products,
auto-created service appointments, and attaching knowledge articles.
Guidelines for Creating Skills for Field Service
Assign skills to service resources to represent certifications or areas of expertise. Add skill requirements to work types, work orders,
and work order line items to indicate the skills needed to complete the work.

Guidelines for Creating Work Types for Field Service

Work types help you standardize your field service processes. Learn about inherited work type
EDITIONS
settings, required skills and products, auto-created service appointments, and attaching knowledge
articles. Available in: Salesforce
Work orders and work order line items that contain a value in the Work Type field inherit the following Classic and Lightning
values from their work type: Experience

• Duration The Field Service Lightning

• Duration Type core features, managed
package, and mobile app
• Required skills (found in the Skill Requirements related list)
are available in Enterprise,
• Required products (found in the Products Required related list) Performance, Unlimited,
• Linked articles (found in the Articles related list) and Developer Editions.
Work orders are also
Service appointments with a value in the Work Type field inherit their work type’s Duration and
available in Professional
Duration Type. Edition.
You can update a record’s settings after they’re inherited from the work type.

30
Field Service Lightning Set Up Work Order Management for Field Service

Skill Requirements
Skill requirements on work types represent the skills that are needed to complete the work. Work orders and work order line items inherit
their work type’s skill requirements. Define required skills in the Skill Requirements related list.
You can enforce skill requirements during schedule optimization using the Match Skills work rule in a scheduling policy. If you’re not
using the Field Service Lightning managed package, skill requirements serve as a suggestion rather than a requirement.
If you add a work type to an existing work order, the work order only inherits the skill requirements if the work order didn’t yet have any.
Similarly, updating a work type’s skill requirements doesn’t affect work orders that were already created using that work type.
The previous rules are also true for work order line items. Work order line items don’t inherit their parent work order’s skill requirements.

Note: Customizations to skill requirements, such as validation rules or Apex triggers, are not carried over from work types to work
orders and work order line items.

Required Products
Required products on work types represent the products that are needed to complete the work. Work orders and work order line items
inherit their work type’s required products. Define required products in the Products Required related list.
If you add a work type to an existing work order, the work order only inherits the required products if the work order didn’t yet have any.
Similarly, updating a work type’s required products doesn’t affect work orders that were already created using that work type.
The previous rules are also true for work order line items. Work order line items don’t inherit their parent work order’s required products.

Note: Customizations to required products, such as validation rules or Apex triggers, are not carried over from work types to work
orders and work order line items.

Auto-Created Service Appointments

If the Auto-Create Service Appointment option on a work type is selected, a service appointment is created when the work type is applied
to a work order or work order line item. The service appointment lists the work type in its Work Type field and inherits the work type’s
Duration and Duration Type. A service appointment isn’t created if the work order or work order line item already has an appointment.
If a user selects Auto-Create Service Appointment on an existing work type, service appointments aren’t created on work orders and
work order line items that were already using the work type.

Exact Appointments Setting

When you schedule a service appointment that has an associated work type, scheduling also considers the Exact Appointments field in
the work type. If Exact Appointments is selected in the work type, then the appointment’s time slot reflects the duration of the work
rather than a time window in which the work occurs.

Knowledge Articles
When you attach a knowledge article to a work type, the article shows up on work orders and work order line items that use the work
type. For example, if you have a work type named Solar Panel Replacement, you can attach an article that explains how to replace a
solar panel. Any work order using that work type automatically includes the article, and the person assigned to the work order has the
instructions at their fingertips.
Articles on work types work a little differently than articles on work orders and work order line items. Here are the differences:
• A Linked Work Types related list isn’t available on article page layouts, so you can’t see which work types an article is attached to.
• The Knowledge One widget isn’t available on work types in the console in Salesforce Classic, but the Articles related list is.

31
Field Service Lightning Set Up Work Order Management for Field Service

• To ensure that field service records are associated with the most current versions of knowledge articles, articles attached to work
types don’t specify an article version. For this reason:
– When work orders and work order line items inherit an article from their work type, they inherit the latest version of the article
published in their org’s default Knowledge Settings language.
– An article attached to a work type may display in a different title or language in the Articles related list versus in the Knowledge
Lightning component. The Articles related list reflects the article version that is inherited by work orders and work order line
items using the work type.

Guidelines for Creating Skills for Field Service

USER PERMISSIONS EDITIONS

Create, update, and delete skills in Setup: Customize Application Available in: Salesforce
Classic and Lightning
Assign skills to service resources: Edit on service resources
Experience
View service resources’ skills: Read on service resources
The Field Service Lightning
Add required skills to work orders or work Edit on work orders core features, managed
order line items: package, and mobile app
are available in Enterprise,
Add required skills to work types: Edit on work types Performance, Unlimited,
and Developer Editions.
Work orders are also
Assign skills to service resources to represent certifications or areas of expertise. Add skill requirements available in Professional
to work types, work orders, and work order line items to indicate the skills needed to complete the Edition.
work.
If the Field Service Lightning managed package is installed, you can easily create and assign skills
in Guided Setup when you create work types and service resources.
If you’re not using Guided Setup, create skills in Setup first. Then, assign them to service resources or create skill requirements.
1. Decide how to measure skill level. Skills and skill requirements can be assigned a skill level between 0 and 99.99. For example, use
the Skill Level field to indicate years of experience, or create a matrix that corresponds professional license classes to skill level
numbers.

Tip:
• Create validation rules to limit potential skill level values. For example, only allow multiples of 10.
• Create field-level help to let your users know how skill level is determined.

2. Create skills in Setup.

a. From Setup, enter Skills in the Quick Find box, then select Skills under Field Service.
b. Enter a name, like Electrician Certification, and a description.
c. Skip the Assign Users and Assign Profiles sections, which are specific to Chat.
d. Save your changes.

3. Assign the skill to service resources.

a. From a service resource record, create a new resource skill in the Skills related list.
b. Select a skill, and enter a skill level from 0 to 99.99.

32
Field Service Lightning Set Up Work Order Management for Field Service

c. Enter a start date and, if needed, an end date. For example, if a technician must be recertified in a particular skill every six months,
enter an end date that’s six months later than the start date.
d. Save your skill.

4. Add the skill as a requirement on work types, work orders, or work order line items. Work orders and work order line items inherit
their work type’s skill requirements.
a. From a work type, work order, or work order line item record, create a new skill requirement in the Skill Requirements related
list.
b. Select a skill, and enter a skill level from 0 to 99.99.
c. Save your skill requirement.

Customize Work Order Settings for Field Service

To control how your team works with work orders and work types, customize page layouts and
EDITIONS
assign user permissions.
1. Assign user permissions. Available in: Salesforce
Classic and Lightning
Users Who Will... Need These Permissions Permissions Are Experience
Auto-Enabled on These
The Field Service Lightning
Standard Profiles
core features, managed
Enable Field Service Lightning Customize Application System Administrator package, and mobile app
are available in Enterprise,
View the Work Orders tab, Read on work orders Read Only, Standard User, Performance, Unlimited,
work orders, and work order Solution Manager, Contract and Developer Editions.
line items Manager, Marketing User, and Work orders are also
System Administrator available in Professional
Edition.
Create or clone work orders Create on work orders Standard User, Solution
Manager, Contract Manager,
Marketing User, and System USER PERMISSIONS
Administrator
To edit page layouts and set
Edit work orders Edit on work orders Standard User, Solution field history tracking:
Manager, Contract Manager, • Customize Application
Marketing User, and System To create and edit users:
Administrator • Manage Internal Users
Delete work orders Delete on work orders System Administrator

Create, clone, edit, or delete Edit on work orders Standard User, Solution
work order line items Manager, Contract Manager,
Marketing User, and System
Administrator

2. Customize the fields and related lists on the following objects’ page layouts.

Note: If you have your own field service terminology, remember that you can rename an object’s tab and labels. In Setup,
select Rename Tabs and Labels, and enter your own term for the object you’d like to rename.

33
Field Service Lightning Set Up Work Order Management for Field Service

Page Layout Recommended Customizations

Work Order • Arrange the fields. The default layout includes only some of the available fields.
• Confirm that your page layout has the desired related lists:
– Child Work Orders: The work order’s child work orders
– Object Milestones: Milestones on the work order (available only if entitlement management is
set up)
– Products Consumed: Products used during the completion of the work order
– Product Requests: Products requested for the work order
– Product Request Line Items: Line items on product requests
– Products Required: Products needed to complete the work order
– Resource Preferences: Preferred, required, or excluded service resources on the work order
– Service Appointments: Appointments indicating when the work is scheduled
– Service Reports: Reports summarizing the work for customers
– Skill Requirements: Skills needed to complete the work order
– Time Sheet Entries: Schedule of technicians’ time spent on the work order
– Work Order Line Items: Subtasks or steps on the work order

• Optionally, add your own custom values to the Status picklist field. The Status field comes with these
default values:
– New
– In Progress
– On Hold
– Completed
– Cannot Complete
– Closed
– Canceled
When you create a custom value, select a status category that the value falls into. The available status
categories match the default status values. For example, if you create a Customer Absent value, you
may decide that it belongs in the Cannot Complete category.
To learn which processes reference Status Category, see How are Status Categories Used?

Work Order Line Item • Arrange the fields. The default layout includes only some of the available fields.
• Optionally, add your own custom values to the Status picklist field. The Status field is identical to
the Status field on work orders.
• Confirm that your page layout has the desired related lists:
– Child Work Order Line Items: The line item’s child line items
– Product Request Line Items: Line items on product requests
– Product Requests: Products requested for the line item
– Products Consumed: Products used during the completion of the line item
– Products Required: Products needed to complete the line item

34
Field Service Lightning Set Up Work Order Management for Field Service

Page Layout Recommended Customizations

– Service Appointments: Appointments indicating when the work is scheduled
– Service Reports: Reports summarizing the work for customers
– Skill Requirements: Skills needed to complete the line item
– Time Sheet Entries: Schedule of technicians’ time spent on the line item

Work Type • Arrange the fields. The default layout includes only some of the available fields.
• Confirm that your page layout has the desired related lists:
– Products Required: The products needed to complete the work. Work orders and work order
line items inherit their work type’s required products.
– Skill Requirements: The skills needed to complete the work. Work orders and work order line
items inherit their work type’s skill requirements.

a. To let users view and manage work orders in a variety of places, add the Work Orders related list to any of the following objects’
page layouts.
• Accounts
• Assets
• Cases
• Contacts
• Entitlements
• Maintenance plans

Note: Before adding the related list, update the field-level security for the Maintenance Plan and Suggested
Maintenance Date fields on work orders to make them available to users.

• Return orders
• Return order line items
• Service contracts

IN THIS SECTION:
How are Status Categories Used?
Service appointments, work orders, and work order line items have two status-related fields—Status and Status Category—which
come with the same standard values. Status categories, which are referenced in many field service processes, allow you to use custom
status values while maintaining a consistent work classification for tracking, reporting, and business process management.

35
Field Service Lightning Set Up Work Order Management for Field Service

How are Status Categories Used?

Service appointments, work orders, and work order line items have two status-related fields—Status
EDITIONS
and Status Category—which come with the same standard values. Status categories, which are
referenced in many field service processes, allow you to use custom status values while maintaining Available in: Salesforce
a consistent work classification for tracking, reporting, and business process management. Classic and Lightning
When you create a custom Status value, you must indicate which category it belongs to. For example, Experience
if you create a Customer Absent value, you may decide that it belongs in the Cannot Complete
The Field Service Lightning
category. core features, managed
View and manage status values in Setup by navigating to the Status field settings for service package, and mobile app
appointments, work orders, or work order line items. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Many field service triggers and processes are based on appointment, work order, or work order line item status. To ensure that these
processes work as expected when custom statuses are in use, Salesforce references the Status Category field—rather than the Status
field— before making changes.
The following field service processes are based on status category, rather than status. If you create custom status values or reference the
Status or Status Category fields in custom apps, triggers, or validation rules, keep these in mind.
• Status-based sharing rules for work orders, work order line items, and service appointments
• Status-based paths on work orders, work order line items, and service appointments
• Dispatcher console appointment list filters
• Dispatch scheduled jobs, which are triggered by an appointment’s status category being updated to Dispatched
• Dispatch Chatter notification settings, which are triggered by an appointment’s status category being changed to Dispatched
• Dispatch drip feed—found in the Field Service Admin app > Field Service Settings tab > Dispatch—which dispatches one or
more appointments when the assigned resource’s previous appointment’s status category changes to Completed
• Calendar syncing, which checks for appointments whose status category is Dispatched
• Completed icon on the dispatcher console map, which appears when an appointment’s status category changes to Completed
• KPI for completed service appointments shown on the Gantt, capacity view, and service resource view, which is based on appointments
whose status category is Completed

36
Field Service Lightning Set Up Work Order Management for Field Service

Set Up Knowledge for Work Orders

Attach knowledge articles to work orders, work order line items, and work types to share guidelines
EDITIONS
and specs with technicians in the field. Learn how to customize page layouts to let your team view
or manage attached articles, also known as linked articles. Available in: Salesforce
Important: Knowledge must already be set up in your org. Classic and Lightning
Experience
1. Add the Articles related list to work order and work order line item page layouts.
The Field Service Lightning
2. Let Lightning Experience users manage attached articles. In Lightning Experience, add the core features, managed
Knowledge component to your work order, work order line item, and work type detail page package, and mobile app
layouts. are available in Enterprise,
Performance, Unlimited,
3. Let users view and modify attached articles from the console. In the layout editor for work orders
and Developer Editions.
and work order line items, select Custom Console Components and add the Knowledge One
Work orders are also
widget to the console sidebar.
available in Professional
4. The Knowledge One console widget suggests articles to attach based on key fields. Select the Edition.
fields that suggestions are based on. (The Knowledge Lightning component doesn’t offer article
suggestions.)
USER PERMISSIONS
a. In Setup, enter Field Service in the Quick Find box, then select Field Service
Settings. To attach or detach an
article on a work order or
b. Select the fields that the search engine should scan to suggest relevant articles from your work order line item:
knowledge base. • Read on work orders
c. Save your changes. AND Read on the article
type AND Knowledge
5. Optionally, customize linked article page layouts, fields, validation rules, and more in Setup. enabled

• In Lightning Experience, navigate to Linked Article in the Object Manager. To attach or detach an
article on a work type:
• In Salesforce Classic, navigate to the Linked Articles page under Knowledge. • Read on work types AND
Read on the article type
Note: Linked articles include the following limitations. AND Knowledge
• Quick actions and global actions aren’t supported for linked articles. enabled

• The Article widget and Feed Articles Tool aren’t available in the feed view. To edit page layouts:
• Customize Application
• In Lightning Experience, clicking an article link in a feed item redirects you to the article
page in Salesforce Classic. In the Salesforce mobile app, linked articles can’t be accessed To edit console layouts:
from feed items. • Customize Application
AND Service Cloud User
• The Linked Work Types related list isn’t available on articles in any platform.
• The Knowledge One widget isn’t available on work types in the console. To manage linked
articles on work types in the console, use the Articles related list.
• Linked articles are read-only in the Salesforce mobile app.

37
Field Service Lightning Set Up Work Order Management for Field Service

Set Up Path for Field Service

To guide your team as they complete field service jobs, add an interactive, color-coded progress
EDITIONS
bar to work orders, work order line items, and service appointments.
With Path, your team can quickly see a record’s status and how close it is to completion, and update Available in: Salesforce
the status by clicking the desired value on the path. Classic and Lightning
Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To set up a path:
• Modify All Data
To create, customize, or
publish a community:
• Create and Set Up
Communities AND View
Setup and Configuration

You can set up one path per record type. The steps in a path (1) correspond to the Status picklist values. Help users succeed by displaying
up to five key fields and handy step-specific guidance beneath each path step (2).
Several statuses can represent the record’s conclusion: Canceled, Cannot Complete, Completed, and Closed. Therefore, the last stage of
the path displays as Final Status when the record is open. Users are prompted to select a final status from these values when they try
to close the record, and the path then shows the selected final status. The order of the path steps is based on the order of the values in
the Status picklist, though statuses representing conclusion are grouped in the final step.
Path is available for work orders, work order line items, and service appointments in Lightning Experience and Lightning communities.
It isn’t available in Salesforce Classic, the Salesforce mobile app, or the Field Service Lightning mobile app.

38
Field Service Lightning Set Up Your Field Service Workforce

1. On the Path Settings page in Setup, enable Path. Select Remember User's Path Preferences to let users decide whether
the path remembers its previous state or is always closed when the page loads.
2. If you plan to create a path based on the Status field for a field service object, assign a status category to each status. From the field
settings for the object’s Status picklist field in Setup, click Edit next to a value. Select the corresponding status category and save
your changes. Status categories determine which statuses are grouped in the Final Status stage on the path, and are also used in
scheduling.

3. From the Path Settings page in Setup, follow the prompts to create a path for the Work Order, Work Order Line Item, or Service
Appointment object. Paths can be based on the Status field or a custom picklist. Optionally, select key fields or add guidance for
each step in the path.
4. To add your path to record detail pages in your org, drag the Path component onto the object detail page in Builder.
5. To add your path to a Lightning community, drag the Path component onto the object detail page in Experience Builder.

Set Up Your Field Service Workforce

Create service resources and service crews to represent your mobile workforce. Then, assign
EDITIONS
permission sets to members of your team who work as dispatchers or support agents.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Create Service Resources for Field Service
Service resources are individual users or groups of users—known as service crews—who can The Field Service Lightning
perform field service work. Create service resources so you can assign service appointments to core features, managed
them. package, and mobile app
are available in Enterprise,
Create Service Crews Performance, Unlimited,
Set up teams who can be assigned to field service appointments as a unit. A service crew is a and Developer Editions.
group of service resources whose combined skills and experience make them a good fit to work Work orders are also
together on appointments. For example, a wellhead repair crew might include a hydrologist, available in Professional
a mechanical engineer, and an electrician. Edition.
Set Up Crew Management
Give admins and dispatchers access to a drag-and-drop service crew management tool where
they can easily create service crews and update service crew membership.
Limit Access to Field Service Records
By default, all users can view and update work orders, work order line items, and service appointments. You can limit access to these
records so that your team members see only the records that are relevant to them.

39
Field Service Lightning Set Up Your Field Service Workforce

Create Service Resources for Field Service

USER PERMISSIONS EDITIONS

To create service resources: Create on service resources Available in: Salesforce

Classic and Lightning
To deactivate service resources: Edit on service resources
Experience
To view resource capacities: Read on service resources
The Field Service Lightning
To create, update, or delete resource Edit on service resources core features, managed
capacities: package, and mobile app
are available in Enterprise,
To view service resource skills: Read on service resources Performance, Unlimited,
To create, update, or delete service resource Edit on service resources and Developer Editions.
skills: Work orders are also
available in Professional
To view, create, edit, or delete resource Read on service resources AND Edit on Edition.
absences: service resources

To delete resource absences: Edit on service resources

Service resources are individual users or groups of users—known as service crews—who can perform field service work. Create service
resources so you can assign service appointments to them.

Tip: If the Field Service Lightning managed package is installed, you can use Guided Setup to quickly create service resources and
assign them the proper permission sets. From the App Launcher, find and open the Field Service Admin app, and then click the
Field Service Settings tab. Click Go to Guided Setup > Create Service Resources and follow the guidance to update or create
service resources.
1. From the Service Resources tab, click New.
2. Select a user and enter a resource name—typically, the user’s name.
3. If the resource represents an individual user, select the user in the User field. If the resource represents a service crew, leave the User
field blank and select the crew in the Service Crew field. Service resources must list a user or a service crew.
4. Select Active to be able to assign the resource to service appointments. Inactive resources also can’t access the Field Service Lightning
mobile app.
5. Indicate whether the resource is a technician, dispatcher, or crew.

Note: Field Service Lightning users can see Asset as a picklist option in the Resource Type field. However, you can’t save the
record when you select Asset in an org that doesn’t have access to Lightning Scheduler.
Resources who are dispatchers can’t be capacity-based, included in schedule optimization, or added to service crews. Only users
with the Field Service Dispatcher permission set license can be dispatchers.

6. Enter a location if applicable. Service resources might be linked to a location if they manage or operate the location (such as a
warehouse or van). A location can’t be linked to more than one service resource.
7. Select Capacity-Based if the resource is limited to working a certain number of hours or appointments in a specified time period.
You can define the resource’s capacity in the Capacities related list.
Contractors are likely capacity-based.

8. Select Include in Scheduling Optimization to check if the resource has the permission set license needed for optimization.
To be included in optimization, users need the Field Service Scheduling permission set license.

40
Field Service Lightning Set Up Your Field Service Workforce

9. Complete the remaining fields as needed, and save your changes.

Once a resource is created, add details in their related lists.
Service Territories
Select the territories where the resource is available to work. For each territory, select a type:
• Primary: (One territory) Where the resource works most often—for instance, near their home base.
• Secondary: (One or more territories) Where they can be assigned to appointments if needed. Secondary territory membership
dates can overlap.
• Relocation: (One or more territories) Represents a temporary move.
Skills
Assign skills to indicate the resource’s areas of expertise. Optionally, enter a skill level of 0–99.99.
Try to track only skills that factor into scheduling decisions. For example, don’t include skills that are common among all service
resources. Aim to assign fewer than 50 skills to each service resource.

IN THIS SECTION:
Define a Service Resource’s Capacity
Typically, contractors in field service can work a specified amount in a given time period. Define a service resource’s capacity so they
aren’t overbooked during schedule optimization.
Estimate a Service Resource’s Efficiency
People work at different paces depending on their skills and level of experience. Assign an efficiency score to service resources to
facilitate scheduling. The scores are considered during scheduling and can affect an appointment’s scheduled end time.
Guidelines for Creating Service Resources for Field Service
Learn how to view, create, and manage service resources to keep your field service operation running smoothly.
Guidelines for Setting Up Field Service Contractors
If you’re running a field service operation, it’s likely that you work with contractors in addition to your full-time employees. Learn
how to incorporate contractors into your field service processes.

Define a Service Resource’s Capacity

Typically, contractors in field service can work a specified amount in a given time period. Define a service resource’s capacity so they
aren’t overbooked during schedule optimization.
1. To indicate that a service resource is capacity-based, select Capacity-Based on the resource record and save your change.
2. In the Capacities related list, click New Resource Capacity.
3. Enter the capacity start and end dates—for example, enter the resource’s contract dates.
4. Specify how much the resource can work.
• Select the time period that the capacity is based on. For example, if the resource can work 80 hours per month, select Month.
• To base the resource’s capacity on the number of hours worked, enter the hours per time period. For example, if the resource
can work 80 hours per month, enter 80.
• To base the resource’s capacity on the number of service appointments assigned to them, enter the work items per time period.
For example, if the resource can complete 20 appointments per month, enter 20.

5. Save your changes. You can create multiple capacities for a resource as long as the start and end dates don’t overlap.

41
Field Service Lightning Set Up Your Field Service Workforce

Tip: If the Field Service Lightning managed package is installed, view and update a service resource’s capacity on the Capacity
tab on the service resource detail view.

Considerations
• If the managed package is installed, capacity-based resources must include a Hours per Time Period value on their capacity record.
If the user’s capacity should be measured in work items, fill out Work Items per Time Period as well and set the Hours per Time Period
to a high number which likely won’t be achieved.
• Capacity serves as a guideline, not a rule. Resources can still be scheduled beyond their capacity, and you aren’t notified when a
resource exceeds their capacity.
• The Fix Overlaps feature isn’t support for capacity-based service resources.
• Schedule optimization respects daily capacity, but not weekly or monthly.
• Resource schedule optimization—the optimization of an individual service resource’s schedule—isn’t supported for capacity-based
service resources.
• If a service resource is capacity-based with a defined capacity, their utilization percentage isn’t shown in the Gantt.
• Capacity-based resources can’t be assigned to appointments that have a scheduling dependency.
• Capacity-based resources can't be relocated or assigned to a secondary service territory.

Estimate a Service Resource’s Efficiency

People work at different paces depending on their skills and level of experience. Assign an efficiency
EDITIONS
score to service resources to facilitate scheduling. The scores are considered during scheduling and
can affect an appointment’s scheduled end time. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
In the Efficiency field on a service resource record, enter a value from 0.1 through 10. An efficiency
The Field Service Lightning
of 1 means that the technician works at a typical or average speed. An efficiency greater than 1
core features, managed
means that the technician works faster than average. Less than 1 means that the technician works
package, and mobile app
slower than average.
are available in Enterprise,
During schedule optimization, the following formula is used to estimate the time that a technician Performance, Unlimited,
needs to complete an appointment: Duration / Efficiency = Actual time to perform an appointment and Developer Editions.
Work orders are also
Tip: To give preference to highly efficient service resources in schedule optimization, create available in Professional
a Resource Priority service objective based on the service resource Efficiency field. Edition.
Example: The estimated duration on the Battery Replacement work type is 60 minutes.
• Alexander, an expert, has an efficiency of 2.0. If Alexander is assigned to a Battery
Replacement appointment, the appointment is scheduled to end 30 minutes after the
scheduled start (60/2=30).
• Jane, a technician, has an efficiency of 1.0. If Jane is assigned to a Battery Replacement
appointment, the appointment is scheduled to end 1 hour after the scheduled start
(60/1=60).
• Janice, a junior technician, has an efficiency of 0.5. If Janice is assigned to a Battery
Replacement appointment, the appointment is scheduled to end 2 hours after the
scheduled start (60/0.5=120).

42
Field Service Lightning Set Up Your Field Service Workforce

Guidelines for Creating Service Resources for Field Service

Learn how to view, create, and manage service resources to keep your field service operation running
EDITIONS
smoothly.
Available in: Salesforce
View Service Resources Classic and Lightning
Experience
View service resources on the Create Service Resources page in Guided Setup or the Service
Resources tab. In addition: The Field Service Lightning
core features, managed
• Resources that are assigned to a service appointment appear in the Assigned Resources related
package, and mobile app
list on the appointment detail page.
are available in Enterprise,
• Resources that belong to a service territory appear in the Service Territory Members related list Performance, Unlimited,
on the territory detail page. and Developer Editions.
• Resources that belong to a service crew appear in the Service Crew Members related list on the Work orders are also
service crew detail page. available in Professional
Edition.

Create Service Resources

Create service resources from the Create Service Resources page in Guided Setup or the Service Resources tab. Service resources can
represent users or groups of users (known as service crews). When creating service resources, follow these guidelines:
• To create a service resource that represents a user, select the user in the User lookup field and select a Resource Type of Technician.
• To create a service resource that represents a service crew, select the crew in the Service Crew field and select a Resource Type of
Crew. Service resources that are crews can’t be activated unless the crew has at least one active member.

Assign Service Resources to Service Appointments

Manually assign a resource to a service appointment from the Assigned Resources related list on the appointment detail page. You can
assign multiple resources to an appointment. Optionally, indicate which service crew a service resource belongs to in the Service Crew
field on the assigned resource record.
To access assigned resource records, you need access to service appointments.

Deactivate Service Resources

For tracking purposes, resources can only be deactivated, not deleted. To deactivate a user, deselect Active on their detail page.
Service resources that belong to service crews can’t be deactivated. If you deactivate a service resource, make sure to update records
that were associated with that resource. For example, if a deactivated service resource was a required resource for an account, update
that account to prevent scheduling issues.
Deactivating a user deactivates the related service resource. You can’t create a service resource that is linked to an inactive user.

View Service Resource Schedules

The Service Appointments related list shows all appointments that a resource is assigned to, while the Absences related list shows define
periods of time when the resource is unavailable to work. The Service Resource Availability work rule type ensures that resources aren’t
assigned to appointments when they’re absent. Otherwise, resources can be manually assigned to appointments that conflict with their
absences.

Tip: Create a trigger that sends an approval request to a supervisor when a resource creates an absence.

43
Field Service Lightning Set Up Your Field Service Workforce

Guidelines for Setting Up Field Service Contractors

If you’re running a field service operation, it’s likely that you work with contractors in addition to
EDITIONS
your full-time employees. Learn how to incorporate contractors into your field service processes.
Available in: Salesforce
Get Set Up Classic and Lightning
Experience
The way you track contract work in Salesforce depends on how you want to track capacity, assign
appointments, and exchange data with contractors. Follow these basic steps to add contractors to The Field Service Lightning
your org. Steps 1–3 can be completed by the contractor manager. The remaining steps would likely core features, managed
need to be completed by your Salesforce admin. package, and mobile app
are available in Enterprise,
Step Details Performance, Unlimited,
and Developer Editions.
1. Create an account that represents the For example, “Solar Installation Contracting.” Work orders are also
contractor. available in Professional
Edition.
2. Create contacts for the account. You can create a contact for every contractor
technician, or just for the contractor manager.

3. Make the contacts community users. Depending on the licenses that your
organization has purchased, you can assign
them the Customer Community Plus or Partner
Community license. If both are available, partner
community licenses are ideal for users who are
engaged in sales or distribution with your
company.

4. Assign permission set licenses, create a Assign field service permission set licenses to
contractor user profile, and configure object each user:
permissions. • The Field Service Scheduling permission set
license allows the user to be included in
scheduling.
• The Field Service Mobile permission set
license gives the user access to the Field
Service Lightning mobile app
For help assigning the permission set licenses,
see Manage Field Service Permissions.
Then, create a user profile for contractors
(recommended) and configure their object
permissions.

Tip: To customize contractors’ mobile

app experience, assign a unique mobile
settings configuration—accessible from
the Field Service Mobile Settings page in
Setup—to the contractor user profile.

5. Create a service resource to represent the You can create service resources for every
contractor users. contractor technician or just for the contractor
manager. Each service resource is linked to a

44
Field Service Lightning Set Up Your Field Service Workforce

Step Details
user—in this case, the partner or customer community user.

6. Create a service territory for each contractor company, and add Creating a contractor-specific territory lets the contractor manager
the contractor users as service territory members. see only their employees in the community dispatcher console.
For example, if you’re contracting with Ursa Major Solar, create a
territory named Ursa Major Solar Contracting.

7. Add the dispatcher console to the community. For help, see Add the Dispatcher Console to a Community.

Assign Service Appointments to Contractors

Ready to assign a work order to your contractor team? You’ve got options! Here are two common approaches to assigning work to
contractors.

Approach Best for you if...

• The contractor manager is a community user but not a service • You want to track individual contractor technicians’ details in
resource Salesforce
• The contractor technicians are service resources with Field • You want contractor technicians to be able to view or update
Service Mobile licenses appointment details in the field
1. The dispatcher shares the work order with the contractor • You want the scheduling engine to consider each contractor
manager. technician’s schedule when making assignments
2. In your community, the contractor manager uses the Book
Appointment action to assign the associated service
appointment to a technician.
3. The technician uses the mobile app to view the assignment,
and update the service appointment and work order status
when the work is complete.

• The contractor manager is a community user and a service • You don’t want to track individual contractor technicians’
resource details in Salesforce
• The contractor manager tracks the contractor technicians in a • You want the contractor manager to be responsible for viewing
separate system and updating appointment details in the field
1. The dispatcher assigns the service appointment to the • You don’t need to differentiate between different contractor
contractor manager by creating an assigned resource record. technicians’ schedules when assigning work with the
scheduling engine
2. The contractor coordinates with the contractor team to
complete the work.
3. When the service appointment is complete, the contractor
updates the service appointment and work order status from
your Salesforce community.

Tip: The Contractors list view in the dispatcher console Service Appointment List shows only service appointments that are
assigned to capacity-based service resources.

45
Field Service Lightning Set Up Your Field Service Workforce

Create Service Crews

USER PERMISSIONS EDITIONS

To create service crews: Create on service crews Available in: Salesforce

Classic and Lightning
To create service crews using the crew Create on service crews
Experience
management tool: AND
The Field Service Lightning
Create on service resources core features, managed
AND package, and mobile app
are available in Enterprise,
Edit on service territories
Performance, Unlimited,
and Developer Editions.
To create service resources representing Create on service resources
Work orders are also
crews:
available in Professional
To assign service crews to service Edit on service appointments Edition.
appointments:

To view service crew members: Read on service crews AND Read on service
resources

To create, update, or delete service crew Edit on service crews

members:

Set up teams who can be assigned to field service appointments as a unit. A service crew is a group of service resources whose combined
skills and experience make them a good fit to work together on appointments. For example, a wellhead repair crew might include a
hydrologist, a mechanical engineer, and an electrician.
Create service crews from the crew management tool or the Service Crews tab.
From the Crew Management Tool

This is a Field Service Lightning managed package feature.

1. Open the crew management tool by clicking the Crew Management tab or opening the Lightning page that contains it.

Note: Not sure how to get to the crew management tool? Ask your admin to follow the steps in Set Up Crew Management
and let you know where the tool is located.

2. Click New Service Crew to open the crew wizard.

3. Complete the fields on the Basics tab.
4. Optionally, add skills to the crew on the Skills tab. For example, perhaps the crew you’re creating must always include someone with
the Welding skill. Adding skills makes it easier to find potential crew members with the skills you need.
5. Select a leader on the Crew Leader tab.
6. Save your crew. This creates an active service resource of type Crew that’s used during scheduling. You can now view the crew in
the crew management tool and add members to it.

46
Field Service Lightning Set Up Your Field Service Workforce

From the Service Crews Tab

1. Customize page layouts to support crew features.
a. Update the field-level security settings of the Service Crew field on service resources so it’s not hidden. Then, add the field to
service resource page layouts and check that the User field is not marked as required. This lets you create service resources that
represent service crews so crews can be assigned to service appointments.

Note: Though the User and Service Crew fields won’t be marked required in the UI, service resource records can’t be
saved unless one of the fields is filled out.

b. Update the field-level security settings of the Gantt Label field on service crew members so it’s not hidden. Then, add the field
to the Service Crew Member page layout.

2. From the Service Crews tab, click New.

3. Enter a crew name and ideal size, and save your changes.
4. Add service resources to the crew from the Service Crew Members related list. You can specify start and end dates for members and
flag the crew leader.
5. Create a service resource to represent the crew, which is required for scheduling. Changing a crew’s members doesn’t affect its
service appointment assignments.
a. From the Service Resources tab, click New.
b. Enter a name for the crew.
c. Leaving the User field blank, select the crew in the Service Crew field.
d. Select a Resource Type of Crew.
e. Select Active to be able to assign the crew to service appointments and manage its membership with the crew management
tool. Service resources of type Crew can’t be activated unless the crew has at least one active member.
f. Skip the optimization option, which doesn’t apply to service crews.
g. Save your changes.

47
Field Service Lightning Set Up Your Field Service Workforce

IN THIS SECTION:
Considerations for Scheduling Service Crews
Service crews, much like individual service resources, can be assigned to service appointments. Learn how absences, efficiency, and
crew settings affect service crew scheduling.

Considerations for Scheduling Service Crews

Service crews, much like individual service resources, can be assigned to service appointments.
EDITIONS
Learn how absences, efficiency, and crew settings affect service crew scheduling.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Absences Experience
If a service resource of type Crew has resource absences, those absences are considered in
The Field Service Lightning
scheduling. Absences associated with individual crew members’ corresponding service resources
core features, managed
aren’t considered.
package, and mobile app
Appointment Assignments are available in Enterprise,
Service appointments can be assigned only to service resources. Therefore, to assign a crew to Performance, Unlimited,
a service appointment, you need a service resource of type Crew that represents the crew. If and Developer Editions.
you create your crew from the crew management tool, this resource is created automatically. Work orders are also
Otherwise, follow the steps in Create Service Crews. available in Professional
Edition.
When an appointment is assigned to a service crew, the appointment gains these assigned
resources:
• The service resource of type Crew
• The service resources of type Technician who are active service crew members during the appointment time
The appointment’s assigned resources are refreshed only when the appointment is dispatched or assigned to a different crew.
Changing the appointment date doesn’t refresh the assigned resources.
If you want appointments that don’t require crews to be assigned only to individual service resources, use the Resource Priority
service objective in your scheduling policy. Give your technicians a lower priority so the scheduler prefers to assign work to them.
To prohibit the scheduling of all appointments to crews, assign a “No Crew” skill to your individual service resources. Then, add this
skill as requirement to the work type, work order, or work order line item in question.
Capacity
Capacity-based scheduling isn’t supported for service crews because a service resource of type Crew can’t be capacity-based.
Efficiency
When an appointment is scheduled to a crew, the Crew Efficiency field on the crew’s service resource is used to calculate the
appointment’s Scheduled End. The crew members’ efficiencies aren’t considered.
Geolocation Tracking and Service Territories
• The Last Known Location is tracked for crew leaders only. If a crew has more than one leader, the most updated location is
displayed on the map.
• If a service resource is relocated to another service territory while they belong to a crew, the service resource membership record
is drawn only on the relocation territory.
• A service crew member’s home base is considered to be the home base defined for the service resource representing the crew
they belong to.
Membership Requirements
• Only active service resources of the Technician resource type can be added to crews.

48
Field Service Lightning Set Up Your Field Service Workforce

• To belong to a crew, a service resource needs service territory membership in the territory where the crew provides service. The
time span of service crew membership must match or be fully contained in the time span of service territory membership.
• A service resource can be a member of multiple crews as long as the membership dates don’t overlap.
• Service resources that belong to a service crew don’t receive notifications about assignments or assignment changes. Assignment
notifications are sent only to service resources that are assigned individually to appointments.
• Removing all members from a service crew deactivates the related service resource of type Crew.
Minimum Crew Size
Work orders, work order line items, and work types come with a Minimum Crew Size and a Recommended Crew Size. For example,
a crew might have a recommended size of 3, but a minimum size of 2. Work orders and work order line items inherits their work
type’s crew size settings.

Note: The crew size fields are hidden for all users by default. If you don’t see them, update their field-level security settings
in Setup.
Field Service Lightning doesn’t consider the Recommended Crew Size when assigning appointments. To determine whether a
service crew fits the minimum crew size requirement for an appointment, the scheduling engine either counts the crew’s service
crew members or checks the Service Crew Size field on the Service Crew record. You can adjust these settings on the Service Crew
Resources Availability work rule. If the Minimum Crew Size is blank or 1, the scheduler may assign the work to technicians or to crews.
You can customize the Service Crew Resources Availability work rule to serve one of two purposes:
• Compare a service appointment parent record’s Minimum Crew Size field to the Crew Size field on the service crew.
• Compare a service appointment parent record’s Minimum Crew Size field to the actual number of allocated service crew members
at the time of the assignment. Consider Service Crew Membership must be selected on the Service Crew Resources Availability
work rule.
If the Minimum Crew Size is blank or 1 on the service appointment’s parent record, all service resources (of either the Crew or
Technician type) are considered as candidates. This is also true for optimization, although a crew is not a candidate if it has no valid
crew members and Consider Service Crew Membership is selected on the Service Crew Resources Availability work rule.
If your org was created before Spring ’18, you need to create this work rule and add it to your scheduling policies.
Multiday Appointments
When a multiday appointment is scheduled for a technician whose start date on a service crew is in the future, the multiday
appointment is elongated to last the duration of the technician’s membership in the service crew.
Resource Preferences
Service resources that belong to a crew can’t be candidates for appointments while they belong to a crew. Therefore, the Required
Resource and Excluded Resource work rules and the Preferred Resource service objective don’t apply to active service crew members.
Scheduling Candidates
When the scheduler is looking for candidates to perform a job, only service resources of type Crew and Technician are considered
as candidates. If a service resource is a current member of a service crew, the resource is not considered as a candidate. If a service
resource is manually assigned to a service appointment while they belong to a crew, the dispatcher console shows a rule violation.
Sharing
When a service appointment is dispatched, members of the assigned service crew get Read access to the appointment and its parent
record and the crew leader gets Read/Write access. If the Field Service Lightning managed package isn’t installed, service crew
leaders don’t receive any extra permissions.
If an appointment’s Scheduled Start changes or an assigned resource of type Crew is updated, the appointment’s assigned resources
are refreshed to keep the sharing settings current. A change in a service crew membership record doesn’t trigger the refresh.

49
Field Service Lightning Set Up Your Field Service Workforce

Skills
Skills can be assigned to service resources of any type—Technician or Crew—and are considered during scheduling. Unless skills
are assigned to a service crew directly on the service resource of type Crew, a service crew’s combined skills aren’t considered and
the crew may be under-scheduled.
If you want the scheduling engine to consider a service crew’s combined skills—that is, all skills assigned to the service crew
members—enable skill grouping. This way, if an appointment requires the Drilling skill, a service crew with a member that has the
Drilling skill will be considered as a candidate.
From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab. On the
Scheduling tab, select Enable resource crew skill grouping and save your changes.

Note:
• When skill grouping is enabled, the scheduling engine calculates the crew’s skill set for that time slot. The skill set is
recalculated each time the scheduling engine searches for appointment candidates because it can vary based on crew
member allocation.
• If multiple members of a service crew have the same skill, the scheduling engine considers the highest skill level when
calculating the crew’s combined skill set.

Utilization
When utilization is calculated for the utilization view and metrics shown in the dispatcher console, a service crew member is considered
to be utilized like the service resource representing the crew they belong to.

50
Field Service Lightning Set Up Your Field Service Workforce

Set Up Crew Management

Give admins and dispatchers access to a drag-and-drop service crew management tool where they
EDITIONS
can easily create service crews and update service crew membership.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To create Visualforce tabs:

• Customize Application
To set Visualforce page
security and create
permission sets:
• Manage Profiles and
Permission Sets
To assign permission sets:
• Assign Permission Sets

51
Field Service Lightning Set Up Your Field Service Workforce

1. Decide which users need access to the crew management tool. Ensure that each user has at least one of these permission sets:
• FSL Admin Permissions
• FSL Dispatcher Permissions

2. Add the crew management tool to your org in one of two ways:
• Create a Visualforce tab named Crew Management for the FSL.CrewManagement page.
• Embed the Crew Management custom Lightning component in a Lightning page. Because the component includes a detailed
chart, give it plenty of space on the page.

3. Create a permission set with access to the following elements, and assign it to the relevant users.
• Crew Management tab, if you created one
• FSL.CrewManagement Visualforce page
• FSL.CrewsResourceLightbox Visualforce page
• FSL.CrewsSaLightbox Visualforce page
• FSL.CrewsWorkorderLightbox Visualforce page
• FSL.CrewsWorkorderLineItemLightbox Visualforce page
• FSL.CrewManagement Apex class

You’re all set! For help using crew management, see Manage Service Crew Membership.

Limit Access to Field Service Records

By default, all users can view and update work orders, work order line items, and service
EDITIONS
appointments. You can limit access to these records so that your team members see only the records
that are relevant to them. Available in: Salesforce
1. Set sharing to Private for work orders, work order line items, and service appointments. Classic and Lightning
Experience
a. In Setup, enter Sharing Settings in the Quick Find box, and click Sharing Settings.
b. Click Edit. The Field Service Lightning
core features, managed
c. In the Default Internal Access column, select Private for the objects that you want to limit package, and mobile app
access to. are available in Enterprise,
d. Save your changes. Performance, Unlimited,
and Developer Editions.
2. Set up sharing settings for dispatchers. For a dispatcher to access the service resources and Work orders are also
service appointments in a territory, they must be a member of the public group for that territory. available in Professional
Edition.
a. From the App Launcher, find and open User Territories.
b. Click New.
c. Select a service territory.
d. Select the user you want to add as a member of that territory's public group.

Note: User territories give users access to the following objects for that territory.
• Resource Absences
• Service Appointments
• Service Resources
• Service Territories

52
Field Service Lightning Set Up Your Field Service Workforce

• Parent objects of shared Service Appointments; for example, Accounts, Assets, Opportunities, Work Orders, and Work
Order Line Items

3. Set up sharing settings for service resources. These settings allow dispatchers to control access to the appointment and its related
information until they have finalized the appointment's details.
a. From Setup, enter Field Service Settings in the Quick Find box, then click Field Service Settings.
b. Select any of the following options. Hover over a setting’s information icon for details.
• Share dispatched service appointments with their assigned resources
• Share service appointments’ parent work orders with their assigned resources
• Let service crew members edit their service appointments

c. Save your changes.

Note: When a service resource is removed from a service appointment, sharing is deleted only for that service appointment.
Sharing on the parent work order is still retained.

4. Because record access needs can change, Field Service Lightning regularly checks that users have access to the right records. After
your service resources are assigned to service territories, confirm that this sharing update process is active.
a. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
b. Select Sharing > Scheduled Jobs.
c. Expand the User Territories scheduled job, and confirm that Active is selected.
d. Select which territories to check sharing for, and configure the job frequency.

Tip:
• Limit each job to fewer than 100 territories.
• If territory membership changes frequently, try a frequency of 1 day. If territory membership is generally static, you
can decrease the frequency to 30 days, for example.

e. Enter time horizon information.

• The time horizon determines how long the resource appears in the Gantt resource list after their territory membership ends.
For example, enter 7 so that dispatchers can see the resource’s work in the previous week’s schedule on the Gantt.
• The backwards time horizon determines how far in advance a new resource appears in the Gantt resource list. For example,
enter 2 to show the resource in the resource list two days before their territory membership starts.

f. Save your changes.

g. To immediately update the sharing rows, click Run Now.

Note:
• When an appointment is canceled, it’s visible only to the appointment owner and the relevant dispatchers based on the user
territory object. The sharing rules no longer apply.
• You can give dispatchers access to records by sharing information across territories and syncing calendars to include absences
and other events.
• In some orgs, the Field Service Admin app has similar sharing options. We recommend disabling the app sharing settings and
using the Setup settings.

53
Field Service Lightning Set Up Your Field Service Workforce

• When User Territory Sharing is enabled and the option Automatically populate user groups based on User Territory is
selected, the User Territory Apex Rule does the following.
– If you create a service territory, it creates a public group with the same name. The public group is added to
ServiceTerritoryShare object.
– If you create a user territory record, it adds the user to the public group for that service territory.
– If you create a service appointment with that service territory, the public group is added to the ServiceAppointmentShare
object to grant access to the record.
– When a service appointment with that territory is shared, related parent records (such as Accounts, Assets, Opportunities,
Work Orders, and Work Order Line Items) are also shared. The service appointment record and its parent record are shared
with the associated public group and its users. If the parent record of the appointment is a Work Order Line Item, the
associated Work Order is also shared. Optionally, in Field Service Settings under Sharing > Scheduled Jobs, select
which parent objects are shared when an appointment is shared. For example, to share Work Orders but not Accounts,
check Share parent Work Order when Service Appointment is shared and deselect Share parent Account when
Service Appointment is shared.
If you don't have User Territory Sharing enabled or sharing settings weren’t private when you created the service territory
records, you must manually create the sharing records.

• Public group names must be unique. For example, User Territory Sharing doesn't work if you have a queue with the same
name as one of your public groups.
• When a service appointment is created without a user territory, it’s associated with the Field Service Default public group. This
default group allows a user to access a service appointment and work order even when there’s no associated territory. Field
Service Lightning adds users in all user territories as members of this public group. If you’re a dispatcher, you can filter the
Gantt and show service appointments that aren’t associated with a territory.

Example: John is a dispatcher for the New Jersey service territory, and his user territory record gives him access to New Jersey
field service records. Madison is a technician for the Pennsylvania service territory, but on August 1 she is moving to the New Jersey
territory.
To reflect Madison’s move, the admin adds an end date of July 31 to her Pennsylvania service territory member record. The admin
then creates a New Jersey service territory member record for Madison with a start date of August 1.
The admin has configured the User Territory sharing job to run daily for all service territories, including Pennsylvania and New
Jersey. This job calculates which records users need access to. Because the job’s backwards time horizon is set to one day, John
receives access to Madison’s field service records one day before she starts work in New Jersey.

54
Field Service Lightning Set Up Your Field Service Inventory

Set Up Your Field Service Inventory

Track and manage the storage, request, transfer, and consumption of every item in your inventory,
EDITIONS
and ensure that your mobile workforce has the right parts in stock to do their job.
First, a little vocabulary review! Field service inventory management comes with a full toolbox of Available in: Salesforce
features. You can find these features in Salesforce as tabs or related lists: Classic and Lightning
Experience
• Locations are places, like warehouses, sites, or work vehicles, where inventory is stored.
• Product items represent products in your inventory stored at a particular location, such as The Field Service Lightning
bolts stored in a warehouse. Each product item is associated with a product and a location in core features, managed
Salesforce. If a product is stored at multiple locations, the product will be tracked in a different package, and mobile app
product item for each location. are available in Enterprise,
Performance, Unlimited,
• Products required are products that are needed to complete a work order or work order line and Developer Editions.
item. Work orders are also
• Products consumed are product items that were used to complete a work order, and are no available in Professional
longer in your inventory. Edition.
• Product item transactions describe actions performed on a product item. They’re
auto-generated records that help you track when a product item is replenished, consumed, or
adjusted.
• Product requests are orders for products, which you might create when stock is running low.
• Product request line items are subdivisions of a product request.
• Product transfers track the transfer of product items between inventory locations.
• Return orders track the return or repair of products.
• Return order line items are subdivisions of a return order.
• Shipments represent the shipment of product items between locations.
Now that you’ve got the important terms under your belt, it’s time to configure your org for inventory management.

IN THIS SECTION:
Customize Inventory Settings
To control how your team manages inventory, customize page layouts and assign user permissions.
Create Inventory Locations for Field Service
Locations are places, like warehouses, customer sites, or work vehicles, where inventory is stored for a field service operation. Create
locations so you can track the items stored there and restock when necessary.
Create Product Items to Represent Inventory
After you customize your field service inventory settings, track where your inventory is stored by creating product items.

55
Field Service Lightning Set Up Your Field Service Inventory

Customize Inventory Settings

To control how your team manages inventory, customize page layouts and assign user permissions.
EDITIONS
1. Assign user permissions.
Available in: Salesforce
Users Who Will... Need These Permissions Classic and Lightning
Experience
Enable Field Service Lightning Customize Application
The Field Service Lightning
View the Locations, Products, Product Items, Read on the object core features, managed
Product Requests, Product Transfers, Return package, and mobile app
Orders, or Shipments tab and records are available in Enterprise,
Performance, Unlimited,
Create, edit, or delete locations, products, Create, Edit, or Delete on the object
and Developer Editions.
product items, product requests, product
Work orders are also
transfers, return orders, or shipments available in Professional
Add products required to work orders, work Edit on work orders, work order line items, or Edition.
order line items, or work types work types

Create, edit, or delete products consumed on Create on work orders AND Read on product USER PERMISSIONS
work orders or work order line items items To edit page layouts and set
View product item transactions Read on product items field history tracking:
• Customize Application
Edit product item transactions Edit on product items To create and edit users:
Create addresses for locations Create on Addresses • Manage Internal Users

2. Customize the fields and related lists on the following objects’ page layouts.

Tip: If you have your own field service terminology, remember that you can rename an object’s tab and labels. In Setup, select
Rename Tabs and Labels, and enter your own term for the object you’d like to rename.

Page Layout Recommended Customizations for Inventory Management

Location • Arrange the fields.

Important:
– Add the Inventory Location field so you can track where inventory is stored.
– Add the Mobile Location field so you can flag mobile locations such as service vehicles.
– If you plan to create location hierarchies, add the Parent Location field, and optionally
the read-only Root Location and Hierarchy Level fields.
– Optionally, customize the values in the Location Type field. Its out-of-the-box values are
Warehouse, Van, Site, and Plant.

• Confirm that your layout includes the desired related lists:

– The Addresses related list shows addresses related to the location, such as billing and shipping
addresses.
– The Assets related list shows assets at the location.

56
Field Service Lightning Set Up Your Field Service Inventory

Page Layout Recommended Customizations for Inventory Management

– The Associated Locations related list shows related accounts.
– The Child Locations related list shows locations within the location, such as vehicles which are
parked at a warehouse when not in use.
– The Maintenance Plans related list shows maintenance plans linked to the location.
– The Product Items related list shows product items (inventory) stored at the location.
– The Product Transfers (Source) related list shows product transfers that originated at the location.
– The Product Transfers (Destination) related list shows product transfers in which items were
transferred to the location.
– The Service Territory Locations related list shows related service territories, which usually indicates
that the location is within the territory.

Address • Arrange the fields, which appear in the Addresses related list on locations.
• Optionally, customize the values in the Address Type field. Its default values are Mailing, Shipping,
Billing, and Home.

Associated Location Associated locations let you associate multiple accounts with one location. For example, a shopping
center location may have multiple customer accounts.
• Arrange the fields, which appear in the Associated Locations related list on locations and accounts.

Product • Confirm that your layout includes the following related lists:
– The Product Items related list shows product items that track the storage of the product in an
inventory location.
– The Return Order Line Items shows return order line items that track the return or repair of the
product.

• Define values for the Quantity Unit of Measure picklist field, which comes with one value (Each).
These values are reflected in the Quantity Unit of Measure field on product items, product request
line items, product transfers, products consumed, and products required.
a. From Setup, enter Products in the Quick Find box, then select Fields under Products.
b. Click Quantity Unit of Measure.
c. In the Quantity Unit of Measure Picklist Values related list, click Edit to change the default or
New to add values. For example, you may need values like Kilograms or Liters.
d. Save your changes.

Product consumed Arrange the fields that appear in the Products Consumed related list.

Product item • Arrange the fields.

• Confirm that your layout includes the following related lists.
– The Product Item Transactions related list automatically tracks the replenishment, consumption,
and adjustment of product items.
– The Product Transfers related list shows transfers of the inventory.

57
Field Service Lightning Set Up Your Field Service Inventory

Page Layout Recommended Customizations for Inventory Management

Product item transaction Arrange the fields that appear in the Product Item Transactions related list.

Product request • Arrange the fields.

• Optionally, customize the Status field values. The default values are Draft, Submitted, and Received.
• Confirm that your layout includes the following related lists.
– The Product Transfers related list shows transfers that are created to fulfill the request.
– The Product Request Line Items related list shows the request’s line items (each associated with
a product).
– The Return Orders related list shows return orders associated with the request.

Product request line • Arrange the fields.

item
• Optionally, customize the Status field values. The default values are Draft, Submitted, and Received.
• Confirm that your layout includes the following related lists:
– The Product Transfers related list shows transfers created to fulfill the request.
– The Return Order Line Items related list shows return order line items associated with the product
request line item.

Product required Arrange the fields that appear in the Products Required related list.

Product transfer • Arrange the fields. The default layout includes only some of the available fields.
• Optionally, customize the Status field values. The default values are Ready for Pickup and Completed.
• Confirm that your layout includes the Product Item Transactions related list, which automatically
tracks the replenishment, consumption, and adjustment of the product items being transferred.

Return order • Arrange the fields.

• Confirm that your layout includes the following related lists:
– The Product Transfers related list shows product transfers related to the return
– The Return Order Line Items related list shows subdivisions of the return, each associated with
a specific product
– The Work Orders related list shows work orders related to the return
– The Work Order Line Items related list shows work order line items related to the return

Return order line item • Arrange the fields.

• Confirm that your layout includes the following related lists:
– The Product Transfers related list shows product transfers related to the return
– The Work Orders related list shows work orders related to the return
– The Work Order Line Items related list shows work order line items related to the return

Shipment • Arrange the fields.

• Optionally, customize the Status field values. The default values are Shipped and Delivered.

58
Field Service Lightning Set Up Your Field Service Inventory

Page Layout Recommended Customizations for Inventory Management

• Confirm that your layout includes the Product Transfers related list, which shows transfers that the
shipment fulfills.

Work order Confirm that your layouts include the following related lists.
Work order line item • The Products Required related list shows products needed to complete the work.
• The Products Consumed related list shows product items used to complete the work.
• The Product Requests related list shows product requests created to ensure that the assigned service
resources have the parts they need to complete the work.
• The Product Request Line Items related list shows product request line items associated with the
work.
• The Return Orders related list shows return orders associated with the work.
• The Return Order Line Items related list shows return order line items associated with the work.

3. Make the following tabs visible to your users:

• Locations
• Products
• Product Items
• Product Requests
• Product Request Line Items
• Product Transfers
• Return Orders
• Shipments
You can add the tabs to a custom app or instruct users to add them in Salesforce.

Create Inventory Locations for Field Service

USER PERMISSIONS EDITIONS

To create locations: Create on locations Available in: Salesforce

Classic and Lightning
To view associated locations: Read on accounts
Experience
To create, update, or delete associated Edit on accounts
The Field Service Lightning
locations:
core features, managed
To view addresses: Read on locations package, and mobile app
are available in Enterprise,
To create, update, or delete addresses: Edit on locations Performance, Unlimited,
and Developer Editions.
Work orders are also
Locations are places, like warehouses, customer sites, or work vehicles, where inventory is stored available in Professional
for a field service operation. Create locations so you can track the items stored there and restock Edition.
when necessary.

59
Field Service Lightning Set Up Your Field Service Inventory

1. From the Locations tab, click New.

2. Enter a location name.
3. Select a location type:
• Warehouse (default)
• Site
• Van
• Plant

4. If inventory is stored at the location, select Inventory Location. This allows you to you associate the location with items in your
inventory, known as product items.
5. If the location can be moved, like a van or tool box, select Mobile Location.
6. Complete the other fields as appropriate.
7. Click Save.
8. In the Addresses related list, create addresses for the location. The available types of addresses are Mailing, Shipping, Billing, and
Home.
9. In the Files related list, attach files like blueprints, photographs, or registration information.
10. In the Service Territory Locations related list, create records to indicate which service territories the location belongs to. Service
territory locations are warehouses, customer sites, or vehicles that are located or operate in the service territory.

60
Field Service Lightning Set Up Your Field Service Inventory

Create Product Items to Represent Inventory

After you customize your field service inventory settings, track where your inventory is stored by
EDITIONS
creating product items.
Product items represent your inventory. Each product item is linked to a storage location, such as Available in: Salesforce
a van or warehouse, and to a specific product, indicating the item being stored. Create product Classic and Lightning
items so you can track inventory usage and restock when necessary. Experience

Important: Before you get started, choose whether to assign serial numbers to product The Field Service Lightning
items for identification purposes. core features, managed
package, and mobile app
• If you assign a serial number, each product item represents a single item in your inventory: are available in Enterprise,
for example, create one product item representing a motor with serial number 012345 Performance, Unlimited,
stored at Warehouse A. Before serializing product items, review the Inventory Management and Developer Editions.
limitations in Field Service Lightning Limits and Limitations. Work orders are also
• If you choose not to assign serial numbers, you can specify a quantity on each product available in Professional
item. Product item quantities auto-update to reflect transfers between locations. Create Edition.
one product item for every location that has the product in stock. For example, create:
– One product item representing 100 batteries stored at Warehouse A USER PERMISSIONS
– One product item representing 15 batteries stored in Service Van 1
To create product items:
• Create on product items
1. From the Product Items tab, click New.
To view product item
2. Use the lookup field to select a product. transactions:
• Read on product items
Tip: To add products to your org, see Guidelines for Creating Products.
To create, update, or delete
3. Use the lookup field to select the location where the product item is stored. Only locations that product item transactions:
have the Inventory Location option selected can be associated with product items. • Edit on product items

4. Enter the Quantity on Hand, which is the amount at this location. If you intend to add a serial
number, this value will likely be 1.
5. If needed, add a unit of measure; for example, grams, packs, or units. These values are inherited from the Quantity Unit of Measure
field on products.
6. If the Quantity on Hand is 1, enter a serial number.
7. Click Save.
The product item now appears in the Product Items related list on the associated location and product records. In addition, the Product
Item Transactions related list on the product item now contains a “Replenished” transaction that tells you when the product item was
created.
If you update a product item, a new product item transaction is created with a type of “Adjusted” and a quantity that is the difference
between the old and new Quantity On Hand. Deleting a product item deletes all related product item transactions.

61
Field Service Lightning Get Ready for Scheduling

Get Ready for Scheduling

Define your service appointment life cycle, configure appointment booking settings, and get to
EDITIONS
know your Field Service Lightning scheduling policies, optimization settings, and sharing settings.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
IN THIS SECTION:
The Field Service Lightning
Customize the Service Appointment Life Cycle core features, managed
A service appointment life cycle shows the sequence of stages that a service appointment package, and mobile app
passes through. The life cycle starts when the appointment is created and ends when it reaches are available in Enterprise,
its final status. Performance, Unlimited,
and Developer Editions.
Customize Appointment Booking Settings
Work orders are also
Users can schedule service appointments for a work order, work order line item, or other record available in Professional
by using the Book Appointment Chatter action. Customize this scheduling experience from Edition.
the Field Service Admin app.
Reserve Time Slots for Designated Types of Work
Create specific time slots dedicated to service appointments that meet your criteria.
Set Up Routing for Travel Time Calculations
By default, Field Service Lightning uses aerial routing to estimate travel time between job sites. You can improve the accuracy of
these estimates by enabling street-level routing (SLR), which considers real turn-by-turn data. To further fine-tune travel time
calculation, enable predictive travel.
Enable Multiday Service Appointments
Chances are that your grander projects require more than a day’s work. Happily, you can schedule service appointments that span
multiple days.
Activate Schedule Optimization
Activate Field Service Lightning schedule optimization so you can create optimal schedules for your field service team. You can
configure optimization to run regularly, or run it manually.
Activate Enhanced Optimization
Enhanced Optimization provides a range of scheduling features that help you address last-minute scheduling challenges, make
more informed scheduling decisions, and minimize surprises for your team.

62
Field Service Lightning Get Ready for Scheduling

Customize the Service Appointment Life Cycle

A service appointment life cycle shows the sequence of stages that a service appointment passes
EDITIONS
through. The life cycle starts when the appointment is created and ends when it reaches its final
status. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Service appointments come with the following statuses to represent stages in their life cycle.
The Field Service Lightning
• None core features, managed
• Scheduled package, and mobile app
• Dispatched are available in Enterprise,
Performance, Unlimited,
• In Progress and Developer Editions.
• Completed Work orders are also
• Cannot Complete available in Professional
Edition.
• Canceled

Tip: Update the status names to fit your business by editing the Status picklist values in
Setup. Changing the name doesn’t change a status’s automatic transition behavior.
Here’s how to customize your service appointment life cycle.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Service Appointment Life Cycle.
3. Click SA Status. Select a status value for each description.
4. Save your changes.
5. Click the Status Transitions tab.
6. Each row represents a flow or transition in the service appointment life cycle. Modify the existing flows, delete flows, or add new
ones.

Note: When a service appointment is unscheduled, its status changes to None.

7. Optionally, click More Details to limit the user profiles that can make each status change. You can also select a custom Visualforce
page to display when a user tries to make the status change. The status flow diagram at the bottom of the page shows your status
flows, but doesn’t show profile-based restrictions.
8. Save your changes.

63
Field Service Lightning Get Ready for Scheduling

Customize Appointment Booking Settings

Users can schedule service appointments for a work order, work order line item, or other record by
EDITIONS
using the Book Appointment Chatter action. Customize this scheduling experience from the Field
Service Admin app. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field
The Field Service Lightning
Service Settings tab.
core features, managed
2. Select Global Actions > Appointment Booking. package, and mobile app
3. Configure your settings. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Field Name Description

Default scheduling policy The scheduling policy used to generate a list of arrival windows or
time slots when a user clicks Book Appointment or Candidates
in the feed. By default, these actions use the Customer First
scheduling policy. This policy aims first to use the customer’s
preferred service resources, then to schedule the appointment as
soon as possible, and finally to minimize the resource’s travel time.

Tip:
• You can also change this setting on the Customize
Appointment Booking page in Guided Setup.
• Optionally, create a custom Scheduling Policy lookup
field for an object and map it to the object on the
Derivations tab in Global Actions. This way, records of
that object type use the policy you selected rather than
the default policy.

Default operating hours The operating hours that determine the arrival window time slots
that are offered to customers. Each appointment’s scheduled start
falls within the arrival window requested by the customer.
By default, the Gold Appointments Calendar operating hours are
used, which consist of two-hour time slots, Monday–Friday, from
9 AM to 5 PM. You can change the arrival window operating hours
on the Customize Appointment Booking page in Guided

64
Field Service Lightning Get Ready for Scheduling

Field Name Description

Setup—which also lets you quickly define and preview your
hours—or from the Operating Hours tab.

Tip: If different appointment booking windows are needed

for different level of service—for instance, standard
customers get 4-hour booking windows while VIP customers
get 2-hour windows—add entitlements to your work orders.
In the Operating Hours field on the entitlement, select the
appropriate appointment booking window operating hours.

Ideal grading threshold An appointment’s grade represents its adherence to the scheduling
policy’s service objectives. Enter a value 0–100. When potential
appointments are shown in the Book Appointment action,
appointments with a grade equal to or higher than the ideal
grading threshold have an Ideal flag.

Recommended grading threshold An appointment’s grade represents its adherence to the scheduling
policy’s service objectives. Enter a value 0–100. When potential
appointment times are shown in the Book Appointment action,
appointments with a grade below the ideal grading threshold and
equal to or higher than the recommended grading threshold have
a Recommended flag.

Minimum Grade An appointment’s grade represents its adherence to the scheduling

policy’s service objectives. Enter a value 0–100. Appointments
below this value aren’t shown in the list.

Number of hours for initial appointment search If the difference between the earliest start permitted and due date
is greater than this value, the appointment is displayed in an initial
list while the search continues for additional candidates.

Show grades explanation When this option is selected, clicking the info icon next to an option
shows its score for each service objective in the applied scheduling
policy. These scores are averaged to form the overall score.

Custom CSS (cascading style sheet) To customize the appearance of the Book Appointment and
Candidates actions, enter a name of a CSS file.

Disable service territory picker in appointment booking Hide the service territory field in the Book Appointment action.

Pin three highest graded time slots to the top Highlight the three highest-graded time slots and pin them to the
top of the list in a Golden Slots section.

Open extended view by default Display appointment details in the extended view. When this option
isn’t selected, users must click Show More Options to see the
Earliest Start Permitted and Due Date fields.

Note: For an appointment to be scheduled, the following

information is required: scheduling policy, work type, earliest
start permitted, and due date. While a service territory isn’t
required, it’s recommended.

65
Field Service Lightning Get Ready for Scheduling

IN THIS SECTION:
Time Zones and Appointment Booking
In large field service operations, the service appointment’s support agent, assigned resource, and customer could all be in different
time zones. Field Service Lightning’s appointment booking process shows each user’s appointment details in their own time zone.

Time Zones and Appointment Booking

In large field service operations, the service appointment’s support agent, assigned resource, and
EDITIONS
customer could all be in different time zones. Field Service Lightning’s appointment booking process
shows each user’s appointment details in their own time zone. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
If your operation spans multiple time zones, follow these guidelines when creating records.
The Field Service Lightning
• For work orders, complete the Service Territory field. A service appointment inherits its parent core features, managed
record’s service territory when the parent is a work order or work order line item, but you can package, and mobile app
set a unique service territory on an appointment. are available in Enterprise,
• For service territories, select operating hours that are associated with the territory’s time zone. Performance, Unlimited,
For example, for a New York service territory, select operating hours with the New York time and Developer Editions.
zone. Work orders are also
available in Professional
• Create operating hours in Guided Setup that represent the arrival windows offered in the Book
Edition.
Appointment action.
1. From the App Launcher, find and open the Field Service Admin app, and then click the
Field Service Settings tab.
2. Select Go to Guided Setup > Customize Appointment Booking.
3. Update the operating hours, and save your changes.
You can also update the operating hours from Field Service Settings > Scheduling > Appointment Booking.
When the Book Appointment action is used, Field Service Lightning doesn’t consider the time zone defined on the arrival windows
operating hours record. Instead, it uses the time zone of the service appointment’s service territory’s operating hours. This way, when a
customer selects a time slot, the appointment is scheduled according to the customer’s time zone.

Example:
• The support agent’s time zone is Eastern Time (ET).
• The service resource’s time zone is Mountain Time (MT) on both the user record and the primary service territory.
A customer in Nevada calls the company for an appointment, and the support agent creates a work order. The work order sets
the customer’s service territory to the match the site address. The service territory uses the customer’s time zone—in this case,
Pacific Time (PT).
On the Book Appointment page, the customer selects an arrival window of 1–3 PM. The arrival window is in the customer’s time
zone (PT) because it uses the work order’s service territory’s time zone.
After the appointment is booked, each person involved can view its details in their time zone.
• When the customer (PT) receives an email confirmation, the arrival window is listed as 1–3 PM.
• When the support agent (ET) views the service appointment, the arrival window is listed as 4–6 PM.
• When the assigned resource (MT) checks the schedule in the Field Service Lightning mobile app, the arrival window is listed
as 2–4 PM.

66
Field Service Lightning Get Ready for Scheduling

Reserve Time Slots for Designated Types of Work

Create specific time slots dedicated to service appointments that meet your criteria.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
Any time slot on an operating hours record can be designated for a specific type of work. The type Classic and Lightning
of work is determined by any checkbox field on service appointments. For example, you can Experience
designate a time slot to support only appointments whose Emergency field is selected.
The Field Service Lightning
1. Decide which service appointment fields can be used to reserve time slots. core features, managed
a. From the Object Manager, find the Service Appointment object and click Field package, and mobile app
Sets. are available in Enterprise,
Performance, Unlimited,
b. Open the Designated Work Fields field set. and Developer Editions.
c. Drag any checkbox field into the field set. Work orders are also
available in Professional
Note: You can customize a field by adding it to the service appointment object. Edition.

2. Add the TimeSlot Designated Work work rule to one or more scheduling policies. When the
policy is in use, the scheduling optimizer respects your designated time slot preferences during scheduling.
a. Click the Scheduling Policies tab and select a policy.
b. In the Scheduling Policy Work Rules related list, click New.
c. In the Work Rule field, select New Work Rule.
d. Select Field Service - TimeSlot Designated Work and click Next.
e. Add a name and description.
f. Save your changes.

3. Reserve a time slot for service appointments of a specified type.

a. From the operating hours tab, select an operating hours record.
b. From the detail view, right-click a time slot.
c. Hover over Designate Work and select a checkbox.

67
Field Service Lightning Get Ready for Scheduling

If an appointment doesn’t meet the criteria of your designated time slot, the scheduling optimizer won’t schedule it within the time
slot.

Set Up Routing for Travel Time Calculations

By default, Field Service Lightning uses aerial routing to estimate travel time between job sites. You
EDITIONS
can improve the accuracy of these estimates by enabling street-level routing (SLR), which considers
real turn-by-turn data. To further fine-tune travel time calculation, enable predictive travel. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Note: As a beta feature, Street Level Routing is a preview and isn’t part of the “Services”
The Field Service Lightning
under your master subscription agreement with Salesforce. Use this feature at your sole core features, managed
discretion, and make your purchase decisions only on the basis of generally available products package, and mobile app
and features. Salesforce doesn’t guarantee general availability of this feature within any are available in Enterprise,
particular time frame or at all, and we can discontinue it at any time. This feature is for Performance, Unlimited,
evaluation purposes only, not for production use. It’s offered as is and isn’t supported, and and Developer Editions.
Salesforce has no liability for any harm or damage arising out of or in connection with it. All Work orders are also
restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms available in Professional
for related Non-Salesforce Applications and Content apply equally to your use of this feature. Edition.
You can provide feedback and suggestions for Street Level Routing in the Field Service
Lightning group in the Trailblazer Community.
Per-appointment travel time is one of the most important KPIs that a field service organization tracks. A small improvement can give a
technician more time to work, drive less, reduce their carbon footprint, and promptly reach the customer. Accurate route planning helps
your mobile workforce perform at the highest level.
Field Service Lightning uses routing to calculate and minimize travel time and distance between appointments, and shares this information
with users. Travel time also factors into the scores assigned to available time slots and service resources during scheduling. Several
routing options are available:
• Aerial routing: Computes the shortest distance between two locations based on a straight-line route.
• Street-level routing (beta): Computes the distance along roads or transportation routes. SLR is based on actual road speed
measurements and the expected travel speed based on road type. SLR calculation takes a bit longer than aerial routing calculation.

68
Field Service Lightning Get Ready for Scheduling

• Predictive travel (beta): Builds on SLR by incorporating time-of-day data into the calculation. Predictive travel is available only if
Enhanced Optimization is turned on. It applies only to optimization operations, so standard scheduling operations like the Book
Appointment and Candidates actions don’t use it.
To set your travel time calculation preferences, open the Field Service Admin app from the App Launcher. Select Field Service Settings >
Scheduling > Routing.

Considerations
• In Field Service Lightning, routing avoids toll roads, which can result in longer travel times.
• When you switch from aerial routing to SLR, scheduling recalculates travel times, including times for already scheduled appointments.
• When SLR is activated, resource travel speed isn’t considered. However, if the calculation returns to aerial routing, travel speed is
considered.
• The Street Level Routing Cache custom object improves SLR calculation time for distances that were calculated in the previous 30
days between two given points. Don’t delete this object.
• The travel time is based on the Driving profile in Google maps and can’t be changed.
• SLR creates a grid of 200-meter squares. Every service appointment within the grid gets the same geolocation for routing purposes.
• When a service appointment is dragged onto the Gantt to be scheduled, the routing calculation depends on the chosen start time.
• If you’re scheduling work using Queueable Apex, use the Database.AllowsCallouts annotation to estimate travel time with SLR. If
you don’t include this annotation, aerial routing is used instead. For more information, see Queueable Apex: More Than an @future.

• The Travel From field on service appointments displays Aerial as the calculation method for all appointments, except for the last
appointment of the day. Because Travel From is calculated only for the last service appointment of the day, its value is zero for every
other appointment. The last appointment of the day is calculated with SLR.
• If a service appointment requires a travel distance of more than 100 kilometers, aerial routing is used.
• Multiday work scheduling doesn’t support SLR and uses aerial routing instead. Predictive travel isn’t supported with complex work.
• Any scheduling action that is triggered in a transaction with data manipulation language (DML) uses aerial routing. When SLR is
enabled and scheduling requires SLR travel results that are not primed locally, you must use a callout to retrieve the results. If DML
occurs in the same transaction as the callout, it causes an exception. To avoid this exception, allow the system to use aerial routing
or ensure that DML is completed in a separate transaction. If you want transactions of this type to cause an exception rather than a
switch to aerial routing, from the App Launcher, find and open the Field Service Admin app, and then click Field Service Settings >
Scheduling. Select Avoid aerial calculation upon callout DML exception.
• Enhanced Optimization can use aerial, SLR, or predictive travel, and can report which routing method was used. If Enhanced
Optimization isn’t activated, optimization can use aerial or SLR, but aerial is reported as the method.

69
Field Service Lightning Get Ready for Scheduling

Enable Multiday Service Appointments

Chances are that your grander projects require more than a day’s work. Happily, you can schedule
EDITIONS
service appointments that span multiple days.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Experience
Service Settings tab.
The Field Service Lightning
2. Click Scheduling > General Logic. core features, managed
3. In the Multi-day service appointment field field, select Is MultiDay. package, and mobile app
are available in Enterprise,
4. In Setup, add the Is MultiDay field to your service appointment page layout and save Performance, Unlimited,
your changes. and Developer Editions.
5. From Setup, enter Permission Sets in the Quick Find box, then select Permission Sets Work orders are also
under Users. available in Professional
Edition.
6. Click FSL Dispatcher Permissions.
7. In the Apps section, click Custom Permissions.
USER PERMISSIONS
8. Click Edit.
To customize the Field
9. Add the Longterm View custom permission to the FSL Dispatcher permission set. This
Service Lightning managed
permission lets dispatchers select the Long-Term view in the Gantt, which displays up to 6 package:
months at a time. The Long-Term view displays up to 1000 service appointments. The Long-Term • Customize Application
view comes with filtering options, including the option to show only multiday appointments.
To use the Long-Term Gantt
Customize your Long-Term view settings from the Gantt filter’s Hours tab.
view:
Note: The Long-Term view replaces the Multiday view, which displays 5 weeks at a time • Longterm View custom
but doesn’t include filtering options. permission

10. Click Save.

11. To indicate that a service appointment must span multiple days, select Is Multiday on the appointment.
The length of the multiday appointment is based on its duration and the assigned resource’s availability.

Example: Let’s say you want to find the best resource to complete a multiday service appointment in San Francisco. Your service
resources in San Francisco have operating hours from 9:00 AM to 6:00 PM, and their Resource Availability Work Rule gives them
30 minutes of travel time to and from appointments.
You need to schedule a multiday service appointment that lasts 10 hours. Given your service resources’ travel and time constraints,
the Dispatcher Console finds the best service resource for the job. In this example, Alan Reed is the service resource who’s most
available for this service appointment.

70
Field Service Lightning Get Ready for Scheduling

The Dispatcher Console automatically takes your service resources’ travel and break times into account to optimize your multiday
appointments.

71
Field Service Lightning Get Ready for Scheduling

Activate Schedule Optimization

Activate Field Service Lightning schedule optimization so you can create optimal schedules for your
EDITIONS
field service team. You can configure optimization to run regularly, or run it manually.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Note: Activating schedule optimization consumes one Salesforce license, so check that a Experience
license is available.
The Field Service Lightning
We’re phasing in Enhanced Optimization as the default in Field Service Lightning. In new orgs and core features, managed
non-production orgs such as sandboxes and developer orgs, Enhanced Optimization is activated package, and mobile app
for you. In production orgs, we’re staggering automatic activation. are available in Enterprise,
Performance, Unlimited,
To check if enhanced or standard optimization is active, go to Field Service Settings >
and Developer Editions.
Optimization. If you don’t see the Activate toggle, then Enhanced Optimization is active.
Work orders are also
If you see the Activate toggle and it’s off, you can turn on Enhanced Optimization. That way, you available in Professional
can benefit from its in-day optimization, scheduling recipes, and predictive travel features. Otherwise, Edition.
follow these steps for standard optimization.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field USER PERMISSIONS
Service Settings tab.
To enable schedule
2. Click Optimization > Activation. To create an optimization profile and user that are used optimization:
during activation, click Create Optimization Profile. • Customize Application
3. When you’re prompted, switch to the newly created optimization user to set up your AND
optimization.
Modify All Data
a. From Setup, navigate to the Users page.
To create users:
b. Click Edit next to the optimization user, then select Active on their profile. • Manage Internal Users
c. Select Generate new password and notify user immediately.
d. Log out.

4. When you receive a password reset email, click the link and complete the steps to log in as the optimization user.
5. When you’re logged in, click the + icon in the tab bar to see your full list of tabs. Click the Field Service Settings tab.
6. Click Activate Optimization.
7. Click Allow to allow remote site access and be redirected back to Field Service Settings.
8. Log out as the optimization user and log back in with your regular username and password.
Optimization is now active in your org, as seen by the message on the Optimization > Activation page in Field Service Settings. If you
deactivate the optimization user, optimization isn’t available.

72
Field Service Lightning Get Ready for Scheduling

Activate Enhanced Optimization

Enhanced Optimization provides a range of scheduling features that help you address last-minute
EDITIONS
scheduling challenges, make more informed scheduling decisions, and minimize surprises for your
team. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
We’re phasing in Enhanced Optimization as the default in Field Service Lightning. In new orgs and
The Field Service Lightning
non-production orgs such as sandboxes and developer orgs, it’s automatically activated for you. In
core features, managed
production orgs, we’re staggering activation.
package, and mobile app
To check if Enhanced Optimization is active in your org, go to Field Service Settings > are available in Enterprise,
Optimization. If there’s no Activate toggle, then it’s already active. If you see the Activate toggle Performance, Unlimited,
and it’s off, Enhanced Optimization is inactive and you can turn it on. In either case, before you can and Developer Editions.
submit optimization requests, you must create an optimization user. Work orders are also
available in Professional
Note: Activating optimization consumes one Salesforce license, so check that a license is Edition.
available.
If the Activate toggle is off, here’s how to set up Enhanced Optimization.
1. Check that Schedule Optimization has been activated.
2. Activate the related remote site.
a. From Setup, enter Remote Site Settings in the Quick Find box, then select Remote Site Settings.
b. Click Edit next to FSL_Optimize.
c. Select Active and save your changes.

3. From the App Launcher, find and open the Field Service Admin app.
4. Click the Field Service Settings tab, then click Optimization.
5. Activate Enhanced Optimization and click Save.

Enhanced Optimization Features

Enhanced Optimization gives you access to these features.

Feature Description Learn More

In-day optimization Last-minute changes can derail your team’s schedule. Create Optimize Today’s Schedule
scheduling policies that swiftly optimize the day’s schedule so that
you can get your team back on track.

Scheduling recipes Tackle common scheduling challenges with optimization “recipes” Create Scheduling Recipes for
that adjust your schedule after appointment cancellations, time Common Events
changes, and overlaps. Cover all scenarios by creating multiple
recipes in each category

Predictive travel (beta) Predictive travel builds on Field Service Lightning’s street-level Set Up Routing for Travel Time
routing service by incorporating time-of-day route data into travel Calculations
time estimates.

Shift availability Shifts let you assign workers for time periods that don’t follow a Manage Shifts
recurring pattern.

73
Field Service Lightning Set Up Field Service in Communities

Feature Description Learn More

Consecutive work (beta) When you want service appointments to occur back-to-back, create Create Scheduling
an Immediately Followed By dependency between Dependencies Between Service
them. Appointments

Extended Match work rule The Extended Match work rule type lets you schedule service Work Rule Type: Extended Match
appointments using custom criteria.

If the Fix Overlaps feature is in use, the “Reshuffle other assignments” option is only partially supported for this setting: When unable
to find a valid schedule for an appointment. If more than one appointment is dropped from the schedule during a Fix Overlaps
operation, only one of the appointments is reshuffled.

Set Up Field Service in Communities

Keep customers, partners, and contractors in the loop about field service work. Add field service
EDITIONS
objects to Lightning communities and communities built using the Salesforce Tabs + Visualforce
template. Available in: Salesforce
If you use a community to connect with your business partners, employees, or customers, keeping Classic and Lightning
the communication lines open is key to field service success. For example, add work orders and Experience
service appointments to a partner community to stay in sync with contractors. Or, add return orders
The Field Service Lightning
and return order line items to a community to coordinate customer returns. core features, managed
1. To set up field service objects in a Lightning community: package, and mobile app
are available in Enterprise,
a. Create an object page in Page Manager in Experience Builder.
Performance, Unlimited,
b. When prompted to choose a Salesforce object, choose a field service object. Page Manager and Developer Editions.
automatically creates three related pages for the new object page: a record detail page, a Work orders are also
record list page, and a related list page. To use a Visualforce Lightning component in available in Professional
communities, add the Visualforce page from the managed package to the record detail Edition.
page.
c. To expose the field in your Customer Service community, add it to the Navigation Menu in USER PERMISSIONS
the Page Editor.
To create, customize, or
2. To set up field service objects in a community built using the Salesforce Tabs + Visualforce publish a community:
template, add the objects as tabs. For help adding tabs and giving users access to them, see • Create and Set Up
Add Tabs to Your Community. Communities AND View
Setup and Configuration
3. Optionally, configure guest user access to work orders. By default, guest users in communities
can’t view or create work orders.
a. From Setup, enter Communities in the Quick Find box, then select All Communities.
b. Select Builder next to the community whose guest users need access to work orders.
c. In the left-hand panel, click Settings, and then click the name of the guest user profile.
d. In the Standard Object Permissions section, configure access to work orders and save your changes.

Note: Linked articles, which are knowledge articles attached to supported field service records, aren’t supported in Lightning
communities.

74
Field Service Lightning Set Up Field Service in Communities

IN THIS SECTION:
Add the Dispatcher Console to a Community
Hand over the dispatching reins to a field service contractor manager by embedding the dispatcher console in a Lightning community.

Add the Dispatcher Console to a Community

Hand over the dispatching reins to a field service contractor manager by embedding the dispatcher
EDITIONS
console in a Lightning community.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
1. Add the dispatcher console to your Lightning community. Experience
a. In Experience Builder, open the Pages menu on the top toolbar. The Field Service Lightning
b. Click New Page at the bottom of the Pages menu. core features, managed
package, and mobile app
c. Click Standard Page, and follow the prompts to create your page. Give it a helpful name,
are available in Enterprise,
like Dispatcher Console.
Performance, Unlimited,
d. Assign the page a one-column layout. and Developer Editions.
Work orders are also
e. From the Components menu, drag a Visualforce Page component to the Content section
available in Professional
of the page. Set the component’s properties as follows:
Edition.
• VF Page name: vf001_ServiceExpert
• Height: Any value (we suggest 800 pixels) USER PERMISSIONS
• Record ID: Leave unchanged—{!recordId}
To create, customize, or
f. Open the navigation menu and add a menu item. Use the following settings: publish a community:
• Name: Any value (for example, Dispatcher Console) • Create and Set Up
Communities AND View
• Type: Community Page Setup and Configuration
• Page: Select the page you created earlier To create a permission set:
• Manage Profiles and
g. In the Members section, select the FSL Community Dispatcher Permissions to be allowed Permission Sets
in the community.
To assign a permission set
h. Publish your changes. license:
• Manage Users
2. Give community users access to the new dispatcher console page.
To use the dispatcher
a. Confirm that the community users who need access to the dispatcher console have a console in a community:
Partner Community user license. • Partner Community
b. Confirm that a service territory has been created for the contractor. For details, see Guidelines license and FSL
for Setting Up Field Service Contractors. Dispatcher permission
set license
c. Create the community dispatcher permission sets. From the App Launcher, find and open
the Field Service Admin app, and then click Field Service Settings. Then, click Getting
Started > Permission Sets.
d. Find the FSL Community Dispatcher tile. Confirm that the tile shows a message indicating that the permission set is current. If
it doesn’t, click Create Permissions.
e. Assign two permission sets to the community users who need access to the dispatcher console:
• FSL Community Dispatcher License permission set

75
Field Service Lightning Test Your Field Service Configuration with Health Check

• FSL Community Dispatcher Permissions permission set

Note: Community dispatchers can’t access the complex work feature—for details, see Create Scheduling Dependencies Between
Service Appointments—or Live Gantt updates.

Test Your Field Service Configuration with Health Check

Use the Field Service Health Check to run a suite of automated tests on your Field Service settings
EDITIONS
and configuration data. When Health Check identifies a problem, you get on-the-spot
recommendations to align your Field Service configuration with our best practices. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
To get the most useful results from this Health Check, complete setting up Field Service.
The Field Service Lightning
You can run two types of validations with the Field Service Health Check: general and horizon based. core features, managed
• A general validation checks your org for incorrect configurations, such as out-of-date permission package, and mobile app
sets or incomplete scheduling policies. are available in Enterprise,
Performance, Unlimited,
• A horizon-based validation checks the service appointments, resources, and territory
and Developer Editions.
memberships for a given time frame and service territory. It makes sure that these records don't
Work orders are also
have any issues that could result in scheduling errors. available in Professional
For both types of validations, results are grouped as critical tests and important tests. A critical test Edition.
failure can result in immediate performance degradations. An important test failure can impact
performance, or it can be caused by a deliberate customization that goes against our typical best
USER PERMISSIONS
practices.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field To run Field Service Health
Service Settings tab. Check:
• FSL Admin Permissions
2. Click Health Check.

76
Field Service Lightning Test Your Field Service Configuration with Health Check

3. Run Health Check on your Field Service configuration.

a. Under General Validations, view the results of the last Field Service Health Check run. The tests are rerun each time you open
the page. If you make any changes, click Re-Run All Tests.
b. Under Horizon Based Validations, enter information for the scheduling horizon that you would like to check, and click Run Tests.
Horizon Based Validations can take a little while to complete.
• For Horizon Start and Horizon End, select the date range to validate.
• For Service Territories, select at least one territory. You can also choose whether to validate service appointments that aren't
assigned to a territory.
• Select a scheduling policy to validate your configuration against.
• Optionally, select a filter. For example, validate only pinned appointments. You can filter validations using only boolean
fields.

77
Field Service Lightning Test Your Field Service Configuration with Health Check

4. View your results. To get more information on failed tests, select More Info in the Actions dropdown menu.

78
Field Service Lightning Report on Field Service Lightning

Report on Field Service Lightning

Create report types to track field service activity in your org. To take your reporting a step further,
EDITIONS
use the Field Service Analytics App.
You can create a variety of custom report types to stay informed about field service records. Available in: Salesforce
Classic and Lightning
1. From Setup, enter Report Types in the Quick Find box, then select Report Types and
Experience
click New Custom Report Type.
2. In the Primary Object dropdown menu, select the field service object you want to report on: The Field Service Lightning
core features, managed
Note: This table doesn’t include feed objects that are available as secondary objects. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
Primary Object Description Available Secondary
and Developer Editions.
Objects
Work orders are also
Accounts View accounts’ maintenance Field service objects: available in Professional
plans, product requests, Edition.
Maintenance Plans
return orders, resource
preferences, and work orders. Product Requests USER PERMISSIONS
Product Request Line Items
Resource Preferences To create or update custom
report types:
Return Orders • Manage Custom Report
Work Orders Types
To create a public reports
Assets View assets’ maintenance Field service objects: folder:
plans, replacements, and work Asset Relationships • Manage Public Reports
orders.
Maintenance Assets
Work Orders

Cases View cases’ work orders, Field service objects:

return orders, and product Product Requests
requests.
Product Request Line Items
Return Orders
Work Orders

Contacts View contacts’ maintenance Field service objects:

plans, service appointments, Maintenance Plans
return orders, and work
orders. Return Orders
Service Appointments
Work Orders

Locations View locations’ maintenance Addresses

plans, parts, part transfers, and Assets
more.
Maintenance Plans

79
Field Service Lightning Report on Field Service Lightning

Primary Object Description Available Secondary Objects

Product Items
Product Requests (Source Location)
Product Requests (Destination Location)
Product Request Line Items (Source
Location)
Product Request Line Items (Destination
Location)
Product Transfers (Source Location)
Product Transfers (Destination Location)
Service Resources
Service Territory Locations
Shipments (Source Location)
Shipments (Destination Location)
Return Orders (Source Location)
Return Orders (Destination Location)
Work Orders
Work Order Line Items

Maintenance Plans View maintenance plans’ work orders and Maintenance Assets
assets. Work Orders

Operating Hours View the operating hours of service Service Territories

territories and their members. Time Slots

Orders View an order’s associated return orders. Field service objects:

Return Orders

Product Items View the transfer, consumption, and Product Transfers

replenishment of parts in your inventory. Products Consumed

Product Item Transactions

Product Request Line Items View the transfers related to parts in your Product Transfers
inventory.

Product Requests View the line items and return orders Product Request Line Items
associated with product requests. Return Orders

Products View product requirements, transfers, Field service objects:

requests, return order line items, and parts. Assets

Product Items

80
Field Service Lightning Report on Field Service Lightning

Primary Object Description Available Secondary Objects

Products Required
Product Request Line Items
Product Transfers
Return Order Line Items

Product Transfers View product quantity, origin and None

destination locations, and owner of
product transfers.

Return Orders View return orders’ line items. Return Order Line Items

Service Appointments Compare the differences between Assigned Resources

scheduled and actual appointment times,
and analyze trends in resource assignment
on appointments.

Service Contracts View service contracts’ maintenance plans Field service objects:
and work orders. Maintenance Plans
Work Orders

Service Crews View appointments that crews are Assigned Resources

assigned to and information about crew Service Crew Members
members.

Service Resources Compare service resources’ capacities, Assigned Resources

absences, and skills, and view the Resource Absences
territories they belong to and service
appointments and crews they are assigned Resource Capacities
to. And, see which accounts or work orders Resource Preferences
list resources as preferred. Service Crew Members
Service Resource Skills
Service Territory Members
Time Sheets

Service Territories Compare the number and types of service Service Appointments
appointments, work orders, and work Service Territory Members
order line items across service territories,
and view the service resources that belong Service Territory Locations
to each territory. Work Orders
Work Order Line Items

Shipments View shipment address and transfer Product Transfers

information.

Time Sheets View time sheets’ owners, entries, and Time Sheet Entries
duration.

81
Field Service Lightning Report on Field Service Lightning

Primary Object Description Available Secondary Objects

Users View field service records created by, Field service objects:
modified by, or associated with users. Assets (Asset Owner, Created By, Last
Modified By)
Locations (Created By, Last Modified By)
Maintenance Plans (Created By, Last
Modified By)
Operating Hours (Created By, Last Modified
By)
Product Items (Created By, Last Modified
By)
Product Requests (Created By, Last
Modified By)
Product Request Line Items (Created By,
Last Modified By)
Product Transfers (Created By, Last
Modified By)
Return Orders (Created By, Last Modified
By, Returned By)
Service Appointments (Created By, Last
Modified By)
Service Crews (Created By, Last Modified
By)
Service Resources (User, Created By, Last
Modified By)
Service Territories (Created By, Last
Modified By)
Shipments (Created By, Last Modified By)
Time Sheets (Created By, Last Modified By)
Work Orders (Owner, Created By, Last
Modified By)
Work Types (Created By, Last Modified By)

Work Orders Compare information such as the number Object Milestones

of appointments or line items per work Products Consumed
order, or work order service territories. And,
analyze how resource preferences and skill Product Requests
requirements vary between work orders. Products Required
Product Request Line Items
Resource Preferences
Service Appointments

82
Field Service Lightning Manage Data Integration Rules for Field Service

Primary Object Description Available Secondary Objects

Skill Requirements
Time Sheet Entries
Work Order Line Items
Work Order Line Items

Work Types Compare information such as work type Maintenance Plans

duration and skill requirements. Products Required
Skill Requirements

3. Complete the required fields and click Next.

Tip: In the Store in Category dropdown menu, we recommend choosing Customer Support Reports or Other
Reports. This is the category where users find the custom report type on the Reports tab. You can also create your own field
service report folder. Make your choices on the Define Report Records Set page.

4. Click Save.
5. As needed, remove and rearrange fields from your report layout.
Salesforce also offers the Field Service Analytics App, which is bundled with the Service Analytics App. To learn more, see The Field
Service Analytics App.

Tip: To view work orders with milestones in your org, use the Object Milestones custom report type. The Milestone Status and
Milestone Status Icon fields are not available in work order reports.

Manage Data Integration Rules for Field Service

Set up data integration rules to ensure that service resource travel time is accurately calculated.
EDITIONS
When you add a street address to certain types of field service records, Salesforce calculates the
address’s latitude, longitude, and location accuracy. You can reference this data, which is visible Available in: Salesforce
only in the API, in any custom field service applications. Geolocation information is used to calculate Classic and Lightning
service resource travel times if the Field Service Lightning managed package is installed. Experience

This geolocation data feature, known as “geocoding”, is enabled for all supported field service The Field Service Lightning
objects when you enable Field Service Lightning. The API contains values for the following three core features, managed
fields on work orders, work order line items, service appointments, service territories, resource package, and mobile app
absences, and service territory members: are available in Enterprise,
Performance, Unlimited,
Field Name Description and Developer Editions.
Work orders are also
Latitude The latitude of the street address. available in Professional
Edition.
Longitude The longitude of the street address.

83
Field Service Lightning Manage Data Integration Rules for Field Service

Field Name Description

GeocodeAccuracy The accuracy of the latitude and longitude. This field contains one
of the following values, listed in order from most to least accurate:
• Address—In the same building
• NearAddress—Near the address
• Block—Midway point of the block
• Street—Midway point of the street
• ExtendedZip—Center of the extended ZIP code area
• Zip—Center of the ZIP code area
• Neighborhood—Center of the neighborhood
• City—Center of the city
• County—Center of the county
• State—Center of the state
• Unknown—No match for the address was found (for instance,
the address is invalid)

Note: Because Google Maps is restricted in China, Field Service Lightning features that depend on Google Maps don’t work there.
To minimize errors and customize access for users in China, see Disable Google Maps-based Field Service Lightning features for
China users.

Keep Geocoding Data Current

Salesforce uses data integration rules to periodically refresh these three fields. A refresh occurs when:
• The record is created or updated
• The record type’s data integration rule is deactivated and reactivated
Allow some time for the geocoding fields to refresh. The processing time varies based on the number of records being updated.

Note: If bulk geocoding is turned off for a data integration rule, deactivating or reactivating the rule does not refresh the geocoding
fields. Bulk geocoding is enabled by default.
To keep an eye on the status of a record’s geocoding data:
• In Lightning Experience: On the record, select Check Integration Status in the action menu.
• In Salesforce Classic: Add the Data Integration Rules related list to the detail page layout of the records you’d like to track. The
related list includes:
– The time the record’s geocoding data was last refreshed.
– The record’s geocoding status. To learn what each status means, see Statuses for Data Integration. A status of In Sync means
that your geocoding data is current.
– An Update link that lets you manually run an instant refresh.

84
Field Service Lightning Manage Work Orders for Field Service

Turn Off GPS Tracking for Individual Users

If GPS tracking is turned on at the org level but a few technicians need it turned off, add the Exclude Technician from Geolocation Tracking
permission to their user profile. Turning off geolocation tracking can cause schedule optimization errors.

Opt Out of Geocoding

If you’re already using another geocoding service, opt out of Field Service Lightning geocoding.
1. From Setup, enter Data Integration in the Quick Find box, then select Data Integration Rules.
2. Click Deactivate next to the following rules.
• Geocodes for Work Order Address
• Geocodes for Work Order Line Item Address
• Geocodes for Service Appointment Address
• Geocodes for Service Territory Address
• Geocodes for Service Territory Member Address
• Geocodes for Resource Absence Address

Manage Work Orders for Field Service

Work orders, which track work to be performed for customers, are the heart of Field Service Lightning.
EDITIONS
Learn how to create and customize work orders and maintenance plans.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Create Work Orders for Field Service
Create work orders to track work to be performed for a customer. The Field Service Lightning
core features, managed
Create Maintenance Plans
package, and mobile app
Create preventive maintenance plans for specific assets so your customers never miss a beat. are available in Enterprise,
Maintenance plans let you define how often maintenance visits occur and mass-generate work Performance, Unlimited,
orders for future visits. and Developer Editions.
Work orders are also
available in Professional
Edition.

85
Field Service Lightning Create Work Orders for Field Service

Create Work Orders for Field Service

Create work orders to track work to be performed for a customer.
EDITIONS
1. From the Work Orders tab or the Work Orders related list on a record, click New.
Available in: Salesforce
2. Optionally, select a work type. Work types are templates that auto-populate the following
Classic and Lightning
settings on work orders:
Experience
• Duration
The Field Service Lightning
• Duration Type
core features, managed
• Minimum Crew Size package, and mobile app
• Recommended Crew Size are available in Enterprise,
Performance, Unlimited,
• Service Report Template
and Developer Editions.
• Skill Requirements Work orders are also
• Products Required available in Professional
• Auto-creation of a service appointment Edition.

• Attached knowledge articles

USER PERMISSIONS
3. Enter the address where the work order is taking place. The work order’s service appointments
and line items inherit its address, though the address on line items can be updated. To create work orders:
• Create on work orders
4. Optionally, select a price book. Associating the work order with a price book lets you link each
work order line item to a price book entry (product). To view work order line
items:
5. If you’re tracking pricing on work orders, enter the tax amount. For example, in a work order • Read on work orders
whose total price is $200, enter 20 to apply a 10 percent tax. You can enter a number with or
To create, update, or delete
without the currency symbol and use up to two decimal places.
work order line items:
6. Complete the remaining fields as needed. • Edit on work orders
7. Click Save.
8. Optionally, add details in the work order’s related lists.
• Work Order Line Items: Subtasks or steps that must be performed to complete the work order. Line items can be marked as
completed one by one, and can each have their own active service appointment, work type, and required skills and products.
Pricing details like discounts and unit price are set at the line item level.
• Child Work Orders: Child records of the work order, which are useful in complex jobs.
• Service Appointments: Records that represent visits to the customer. Work orders and work order line items can have multiple
service appointments. If Auto-Complete Service Appointment is selected on the associated work type, a service appointment
is created when you create the work order.
• Products Required: Inventory require to complete the work order. For details, see Track Required Inventory.
• Skill Requirements: Skills required to complete the work order. For help, see Add Required Skills to Work Orders or Work Types
for Field Service.
• Articles: Relevant knowledge articles.

IN THIS SECTION:
Add Service Resource Preferences to Accounts or Work Orders for Field Service
Designate certain service resources as preferred, required, or excluded on accounts or work orders.

86
Field Service Lightning Create Work Orders for Field Service

Add Required Skills to Work Orders or Work Types for Field Service
Ensure that every field service appointment is assigned to a service resource with the right skills. Add skill requirements to work
types, work orders, and work order line items so they can be checked against a service resource’s assigned skills.
Attach Knowledge Articles to Work Orders or Work Types
Learn how to interact with knowledge articles on work orders, work order line items, and work types.
Guidelines for Creating Work Orders for Field Service
Work orders help you track tasks to be performed on a product. Learn how to create and manage work orders.
Work Order Pricing Guidelines for Field Service
Work orders and work order line items have several price-related settings. Learn about these settings and how to apply them to your
business.

Add Service Resource Preferences to Accounts or Work Orders for Field Service
Designate certain service resources as preferred, required, or excluded on accounts or work orders.
EDITIONS
Work orders inherit their account’s resource preferences. If you don’t want to establish resource
preferences at the account level, add them to individual work orders. To use resource preferences, Available in: Salesforce
the service appointment's parent record must be a work order, not a work order line item. Classic and Lightning
Experience
To enforce resource preferences during schedule optimization, use the Required Resources and
Excluded Resources work rules, which are included in the Customer First scheduling policy. The The Field Service Lightning
Resource Priority service objective also measures an appointment’s adherence to resource preferences core features, managed
of the Preferred type. If you’re not using the Field Service Lightning managed package, resource package, and mobile app
preferences serve as a suggestion rather than a requirement. are available in Enterprise,
Performance, Unlimited,
1. On a work order or account, click New in the Resource Preferences related list.
and Developer Editions.
2. Select a service resource. You can’t add preferences for service resources who are inactive or Work orders are also
dispatchers. available in Professional
Edition.
3. Select a preference type: Preferred, Excluded, or Required.
4. Save your changes.
USER PERMISSIONS
Example:
To view resource
• If your customer had a positive experience with Alicia, a service resource, create a resource preferences:
preference on the customer’s account that designates Alicia as “Preferred” • Read on the parent
• If your customer had a bad experience with Nigel, a service resource, create a resource object (work orders or
preference on the customer’s account that designates Nigel as “Excluded” accounts) AND Read on
service resources
• If your customer purchased a complex piece of equipment that was installed by Evan, a
service resource, create a resource preference on the customer’s account that designates To create, edit or delete
Evan as “Required” resource preferences on
work orders:
The customer’s work orders automatically list those three preferences. This helps the dispatcher • Edit on work orders AND
know to assign their service appointments to Evan and, if a second technician is needed, to Read on service
Alicia if she is available. The dispatcher also knows never to assign the account’s service resources
appointments to Nigel. To create, edit or delete
resource preferences on
accounts:
• Edit on accounts AND
Read on service
resources

87
Field Service Lightning Create Work Orders for Field Service

Add Required Skills to Work Orders or Work Types for Field Service
Ensure that every field service appointment is assigned to a service resource with the right skills.
EDITIONS
Add skill requirements to work types, work orders, and work order line items so they can be checked
against a service resource’s assigned skills. Available in: Salesforce
Adding required skills to work types saves you time and keeps your business processes consistent. Classic and Lightning
Work orders and work order line items inherit their work type’s required skills. For example, a Experience
refrigeration company can add a skill requirement of Refrigerator Maintenance—skill level 50—to
The Field Service Lightning
their Annual Maintenance work type. When an agent creates a work order for their customer’s core features, managed
annual fridge maintenance, selecting that work type on the work order adds the required skill. package, and mobile app
If the Field Service Lightning managed package is installed, you can use Guided Setup to add are available in Enterprise,
required skills to work types. From the App Launcher, find and open the Field Service Admin app, Performance, Unlimited,
and then click the Field Service Settings tab. Then, click Go to Guided Setup, select Create and Developer Editions.
Work Types and Skills, and enter skills in the Skill Requirements field of any work type. Work orders are also
available in Professional
You can also add required skills to work orders, work order line items, or work types from the Skill Edition.
Requirements related list, outside of Guided Setup.
1. Navigate to the record that needs required skills.
USER PERMISSIONS
2. In the Skill Requirements related list, click New.
To view skill requirements:
3. Select a skill. When you’re not using of Guided Setup, skills must be created before they can be
• Read on the parent
added as a requirement; to learn how, see Guidelines for Creating Skills for Field Service. object (work orders or
4. Enter a skill level from 0 to 99.99 based on how your business measures skill level. work types) AND Read
on skills
5. Click Save. The skill now appears in the Skill Requirements related list on the record.
To create, edit or delete skill
You can enforce skill requirements during schedule optimization using the Match Skills work rule.
requirements on work
This rule ensures that appointments are assigned only to service resources who possess the required orders or work order line
skills listed on the parent record. If you’re not using the Field Service Lightning managed package, items:
skill requirements serve as a suggestion rather than a rule.
• Edit on work orders AND
Read on skills
To create, edit or delete skill
requirements on work types:
• Edit on work types AND
Read on skills

88
Field Service Lightning Create Work Orders for Field Service

Attach Knowledge Articles to Work Orders or Work Types

Learn how to interact with knowledge articles on work orders, work order line items, and work
EDITIONS
types.
Available in: Salesforce
Attach an Article Classic and Lightning
Experience
Search for and attach articles to a record from the Articles related list, the Knowledge One console
widget, or the Knowledge component in Lightning Experience. The Field Service Lightning
core features, managed
• In Salesforce Classic: In the Articles related list on a record, click Find Article to search for an package, and mobile app
article, and then attach it. are available in Enterprise,
• In the Salesforce Classic console: To attach articles to work types, use the Articles related list on Performance, Unlimited,
the work type. To attach articles to work orders or work order line items, use the Knowledge and Developer Editions.
One widget or the Articles related list. Work orders are also
available in Professional
• In Lightning Experience and the Lightning Experience console: In the Knowledge component on
Edition.
a record, search for the article and then attach it.

View an Attached Article

Attached articles appear in the Articles related list, Knowledge Lightning component, and Knowledge One console widget. View an
article by clicking its title. If feed tracking for related lists is enabled, you can navigate to attached articles from the record feed.
On article detail pages in Salesforce Classic, the Linked Work Orders and Linked Work Order Line Items related lists show the records that
an article is attached to. A Linked Work Types related list isn’t available.

Update an Attached Article

To publish a new version of an article, open the article and click Edit.
When you attach an article to a work order or work order line item, that version of the article stays associated with the record even if
later versions are published. If needed, detach and reattach an article to ensure that the record is linked to the latest version of the article.
The Linked Article Version field on the linked article detail page leads to the attached version.

Note: Only one version of an article can be attached to a record.

Detach an Article
Detach articles from the Articles related list or Knowledge One console widget in Salesforce Classic, and from the Knowledge component
in Lightning Experience.

Note: Linked articles have the following limitations.

• Quick actions and global actions aren’t supported for linked articles.
• The Article widget and Feed Articles Tool aren’t available in the feed view.
• In Lightning Experience, clicking an article link in a feed item redirects you to the article page in Salesforce Classic. In the
Salesforce mobile app, linked articles can’t be accessed from feed items.
• The Linked Work Types related list isn’t available on articles in any platform.
• The Knowledge One widget isn’t available on work types in the console. To manage linked articles on work types in the console,
use the Articles related list.
• Linked articles are read-only in the Salesforce mobile app.

89
Field Service Lightning Create Work Orders for Field Service

Guidelines for Creating Work Orders for Field Service

Work orders help you track tasks to be performed on a product. Learn how to create and manage
EDITIONS
work orders.
Available in: Salesforce
View Work Orders Classic and Lightning
Experience
View work orders from the Work Orders tab or the Work Orders related list on the following types
of records: The Field Service Lightning
core features, managed
• Accounts package, and mobile app
• Assets are available in Enterprise,
• Cases Performance, Unlimited,
and Developer Editions.
• Contacts
Work orders are also
• Entitlements available in Professional
• Maintenance plans Edition.
• Service contracts
• Return orders
• Return order line items
• Service contracts

Tip: Add work orders to the console to manage work orders and their associated records in one place.

Create Work Orders

Create and edit work orders from the Work Orders tab or the Work Orders related list.
When you create a work order, add line items to the work order from the Work Order Line Items related list. Work order line items
represent specific tasks that a technician must perform to complete the work order. They can be marked as completed one by one, and
make it easier to track and improve field service processes. Pricing details like discounts and unit price are set at the line item level on
work orders.

Delete Work Orders

Delete work orders on the work order’s detail page or the Work Orders related list. Deleting a work order moves it to the Recycle Bin.
Any notes, attachments, activities, line items, and service appointments associated with the work order are also deleted. If you undelete
the work order, the associated items are undeleted.

Create Work Order Hierarchies

Work orders can have child work orders, which are standalone records that can be scheduled, given statuses, and assigned.
Child work orders help you account for cancellations. When work is canceled, you can set the work order status to Canceled and create
a child work order. This lets you track first-time rates and analyze cancellation reasons.

Share Work Orders

You may be able to grant extra access to work orders beyond what your org’s default sharing model allows. However, you can’t make
the sharing model more restrictive than the default.

90
Field Service Lightning Create Work Orders for Field Service

To see who has access to a work order, click Sharing on the work order’s detail page. Work order line items inherit their parent work
order’s sharing settings. To learn more, see Limit Access to Field Service Records.

How Work Orders and Service Appointments Intersect

Service appointments on work orders and work order line items represent service visits to the customer. While work orders and work
order line items let you enter general information about a task, service appointments track details about when, where, and how a visit
occurs. Schedule optimization is based on service appointment data.
Work orders and work order line items provide important capabilities, including price book association and Salesforce Knowledge
integration. The Field Service Lightning mobile app experience is also optimized for service appointments whose parent record is a work
order or work order line item.

Work Order Pricing Guidelines for Field Service

Work orders and work order line items have several price-related settings. Learn about these settings
EDITIONS
and how to apply them to your business.
If you’ve set up a product catalog in Salesforce to track the goods and services that you offer, you Available in: Salesforce
can associate items in your price books with work orders and their line items, similar to the way Classic and Lightning
you can associate products with opportunities or orders. If a work order lists a price book, you can Experience
link each work order line item to a price book entry (product) from the price book.
The Field Service Lightning
For example, if you create a work order for a solar panel installation, select a price book in the Price core features, managed
Book lookup field on the work order. Then, use the Price Book Entry lookup field on its work order package, and mobile app
line items to select items in your price book, such as Site Assessment, Solar Panel, and Inverter. A are available in Enterprise,
quick glance at a completed work order’s line items shows you which products from your product Performance, Unlimited,
catalog were sold as part of the work order. and Developer Editions.
Work orders are also
Work orders contain these price-related fields. available in Professional
Edition.
Work Order Field Description
Discount (Read only) The weighted average of the discounts on all line items
on the work order. It can be any positive number up to 100.

Subtotal (Read only) The total of the work order line items before discounts
and taxes are applied.

Total Price (Read only) The total of the work order line items’ price after
discounts but before tax is added.

Grand Total (Read only) The total price of the work order with tax added.

Price Book The price book associated with the work order. Adding a price book
to the work order lets you link each work order line item to a product
included in the price book.

Tax The total tax on the work order in a currency format. (Do not enter
a percentage.) For example, in a work order whose total price is
$100, enter $10 to apply a 10 percent tax. You can enter a number
with or without the currency symbol and you can use up to two
decimal places.

91
Field Service Lightning Create Work Orders for Field Service

Work order line items contain these price-related fields.

Work Order Line Item Field Description

Discount The percent discount to be applied to the line item’s subtotal. You can enter a number with
or without the percent symbol and you can use up to two decimal places.

Subtotal (Read only) The line item’s unit price multiplied by the quantity.

Total Price (Read only) The line item’s subtotal with discounts applied. This field is blank until you add a
unit price and save the line item.

List Price (Read only) The price of the line item (product) as listed in its corresponding price book entry.
If a product isn’t selected, the list price defaults to zero.

Note: When you select a product to link to the line item, you can see the product’s
list price next to its name and ID in the lookup window. The list price field populates
when you save the line item.

Product The name of the product associated with the line item. The lookup only lists products that
are included in the parent work order’s price book. When you select a product and save the
line item, the following fields are populated on the line item:
• List Price
• Unit Price
• Subtotal
• Total Price

Note: Inline editing isn’t supported on the Product field. To change the product on
a line item, click Edit. Adding a product updates the list price, unit price, subtotal, and
total price based on the related entry in the work order’s price book.

Unit Price By default, the unit price for a work order line item is the line item’s list price from the price
book, but you can change it.

Completing Price Fields

• When completing work order price fields, complete only the Price Book and Tax fields. The Discount, Subtotal, Total Price, and Grand
Total fields are automatically calculated based on line item fields.
• When completing work order line item price fields, complete only the Product and Discount fields. The Subtotal, Total Price, List
Price, and Unit Price fields are automatically calculated based on other line item fields.
• Apply discounts to work orders at the line item level. If your work order doesn’t have line items, its discount is zero.
• Work order line items don’t have to be linked to a product. For example, perhaps you use line items only to track tasks. Just keep in
mind that if the Product field is blank, you can’t use the List Price, Unit Price, Discount, Quantity, Subtotal, or Total Price fields.
• If you plan to use price books for work orders, users need “Use” sharing access to the price book object to complete the following
actions:
– Create or edit work orders with the Price Book field completed
– Create work order line items with the Product field completed
– Create products consumed with the Price Book Entry field completed

92
Field Service Lightning Create Maintenance Plans

Deleting Products and Price Books

• You can’t delete a price book that’s linked to a work order.
• You can’t delete a product that’s linked to a work order line item.
• You can’t delete a price book entry that’s linked to a work order line item. Price book entries are linked to work order line items via
the Product lookup field.
• You can’t remove a price book from a work order if its line items are linked to products from that price book.

Create Maintenance Plans

USER PERMISSIONS EDITIONS

To create maintenance plans: Create on maintenance plans Available in: Salesforce

Classic and Lightning
To view maintenance assets: Read on maintenance plans and assets
Experience
To create, update, or delete maintenance Edit on maintenance plans
The Field Service Lightning
assets:
core features, managed
To generate work orders for a maintenance Read on assets and work types AND Create package, and mobile app
plan: on work orders and service appointments are available in Enterprise,
Performance, Unlimited,
To edit page layouts: Customize Application and Developer Editions.
Work orders are also
available in Professional
Create preventive maintenance plans for specific assets so your customers never miss a beat. Edition.
Maintenance plans let you define how often maintenance visits occur and mass-generate work
orders for future visits.
Heads-up: Some multiplication is required. So grab the nearest math whiz, buy ’em a coffee, and fire up Salesforce!

Note: The fields displayed depend on your page layout settings.

1. From the Maintenance Plans tab or related list, click New.

2. Enter a start date and, if applicable, an end date. For example, perhaps you have a service contract that entitles the customer to two
years of maintenance visits. All work orders related to the plan must fall within this date range.
3. Select a work type. Work orders generated from the maintenance plan inherit its work type’s duration, required skills and products,
and linked articles. Maintenance assets covered by the plan use the same work type, though you can update them to use a different
one.
4. Select an account and contact that represent the customer.
5. If the maintenance plan tracks work that’s outlined in a service contract, select the service contract. You can associate assets covered
by the maintenance plan with contract line items on the service contract.
6. If the maintenance visits are at a location that’s tracked in Salesforce, such as a customer site, select the location.
7. In the Frequency and Frequency Type fields, enter the desired amount of time between the maintenance plan’s work orders.
For example, if you’ve agreed to perform monthly maintenance visits, you need a work order for each visit, so enter 1 and select
Months.

8. In the Generation Timeframe and Generation Timeframe Type fields, enter how far in advance you want work orders to be generated
at one time.
For example, to generate 3 months’ worth of work orders at a time, enter 3 and select Months.

93
Field Service Lightning Create Maintenance Plans

9. Enter the date of the first work order in the next batch, which corresponds to the work order’s Suggested Maintenance Date.
For example, if you want the first maintenance visit to take place on May 1, enter May 1. When you generate work orders, the earliest
work order shows a Suggested Maintenance Date of May 1. The dates on the later work orders are based on the Generation Timeframe,
Frequency, and End Date settings. After each batch is run, if the maintenance plan includes assets, this field auto-updates only on
the maintenance assets. This auto-update is because batch timing is calculated at the maintenance asset level.

10. Optionally, enter the days for the maintenance window start and end. These settings impact the Earliest Start Permitted and Due
Date fields on the maintenance plan’s work orders’ service appointments. If the maintenance window fields are left blank, the service
appointment date fields list their work order’s suggested maintenance date.
For example, enter 3 for both the maintenance window start and end. The Earliest Start Permitted and the Due Date will be, respectively,
3 days before and 3 days after the Suggested Maintenance Date on each work order.

11. To automatically generate a batch of work orders when the current batch nears completion, select Auto-generate work orders.
If this option isn’t selected, you must click Generate Work Orders on the maintenance plan to generate a new batch.
A separate work order is created for each maintenance asset for each maintenance date. Therefore, batch size reflects the generation
timeframe, frequency, and number of assets covered by the plan. For example, if the plan covers two assets and has a generation
timeframe of 2 months and a frequency of 1 month, four work orders are generated at a time.

12. If you selected the option to auto-generate work orders, you can add details about when new batches are generated:
• To move up the timing of batch generation, enter a generation horizon. For example, a generation horizon of 5 means that a
new batch of work orders is generated 5 days before the maintenance plan’s Date of the first work order in the next batch. If
you don’t specify a generation horizon, it defaults to zero.
• If you don’t want a new batch of work orders to be generated until the final work order in the current batch is completed, select
Generate new batch upon completion. A work order is considered completed when its status falls into one of the following
status categories: Cannot Complete, Canceled, Completed, or Closed.

13. If more than one asset is associated with this maintenance plan, select a Work Order Generation Method: one work order for each
asset or one parent work order with a work order line item for each asset.
14. If work order generation method is One work order line item per asset, select a Service Appointment Generation Method: one
service appointment for the parent work order or one service appointment for each work order line item.
To learn more about work order and service appointment generation, see How do generation methods work?.

15. Enter a title and description for the maintenance plan.

16. Save your changes and give yourself a high five. You’re almost there!
17. Add assets covered by the plan in the Assets related list. Maintenance assets inherit their plan’s work type and date of the first work
order in the next batch.

Tip: To control which fields appear in the related list, edit the Maintenance Assets page layout in Setup.

18. If you didn’t select the option to auto-generate work orders, click Generate Work Orders on the maintenance plan to generate a
batch of work orders. Otherwise, they’re automatically generated for you.
Generation can’t create a combined total of more than 2,500 work orders and work order line items at a time. To decrease the number
of work orders and work order line items generated, make one of these changes:
• Increase the Frequency value
• Decrease the Generation Timeframe value
• Remove assets from the maintenance plan

94
Field Service Lightning Create Maintenance Plans

IN THIS SECTION:
Guidelines for Generating Work Orders from a Maintenance Plan
Maintenance plans offer a quick way to automate the creation of work orders for periodic maintenance visits. Learn how to generate
work orders from a maintenance plan.

Guidelines for Generating Work Orders from a Maintenance Plan

Maintenance plans offer a quick way to automate the creation of work orders for periodic
EDITIONS
maintenance visits. Learn how to generate work orders from a maintenance plan.
Available in: Salesforce
How many work orders are generated at a time? Classic and Lightning
Experience
Maintenance plan work orders are generated in batches. The number of work orders in a batch is
based on several maintenance plan settings: The Field Service Lightning
core features, managed
• Generation timeframe: Determines how far into the future work orders will be generated package, and mobile app
• Frequency: Determines the amount of time between work order dates are available in Enterprise,
• Number of maintenance assets: One work order is created per asset, per maintenance date Performance, Unlimited,
and Developer Editions.
For example, with a generation timeframe of 1 year, a frequency of 2 months, and two maintenance Work orders are also
assets, one batch contains 14 work orders that cover one year’s worth of maintenance visits. (Work available in Professional
orders are also generated for the final day of the timeframe. If the generation timeframe is one year Edition.
and the Date of the first work order in the next batch is January 1, 2019, work orders are also
generated for January 1, 2020.)

How do I generate work orders?

You can manually generate each batch of work orders or choose to have a new batch generated automatically when the current batch
nears completion. Manual generation gives you more control if frequent changes are needed after each visit. Automatic generation
provides the assurance that you’re delivering the maintenance you promised to your customer.
To manually generate work orders from a maintenance plan:
• Confirm that Auto-generate work orders isn’t selected.
• Click Generate Work Orders. When the Work Order Generation Status on the maintenance plan changes to Complete, the newly
generated work orders appear in the Work Orders related list.
To turn on automatic generation, select Auto-generate work orders.

If auto-generation is turned on, when is a new batch generated?

• If the maintenance plan includes assets, a new batch is generated for each maintenance asset on the maintenance asset’s Date of
the first work order in the next batch.
• If the maintenance plan doesn’t include any assets, a new batch is generated on the maintenance plan’s Date of the first work order
in the next batch.
To further customize batch generation timing, specify a Generation Horizon (Days) or select Generate new batch upon completion.
For details, see Maintenance Plan Fields.

Note: If both Auto-generate work orders and Generate new batch upon completion are selected, Salesforce doesn’t generate
a new batch of work orders for a maintenance asset until the final work order for that asset in the current batch is completed. If

95
Field Service Lightning Create Maintenance Plans

one maintenance asset’s final work order is completed but another’s is stalled, work orders are generated only for the first
maintenance asset. This results in a staggered batch generation schedule for the maintenance plan.

Can I get a report of the work orders generated?

Enable Chatter and Feed-tracking to receive a Chatter post detailing the work orders, work order items, and service appointments
generated for each maintenance plan.

How do generation methods work?

Generation methods can reduce the number of maintenance plan generated work orders by creating a single parent work order with
a work order line item for each asset covered by the maintenance plan.
On a maintenance plan, select your generation method preferences.
• Choose whether to create one work order or one work order line item for each maintenance asset.
• If you select One work order line item per asset, choose whether to create a service appointment for each work order or each work
order line item.
To ensure that all assets with the same suggested maintenance date, are maintained under one work order, select One work order
line item per asset. If each asset needs a separate service appointment, select One service appointment per work order line item.
When One work order line item per asset is set, and all maintenance assets have the same Next Suggested Maintenance Date on
the maintenance plan, they are grouped in one work order. However, if maintenance assets have different next suggested maintenance
dates, multiple work orders are created for each date.

Tip: To provide guidance on which asset to service first, second, and so on, create guided actions, or flows, in the parent work
order.
If Work Order Generation Method is left as None, the generation is defaulted to one work order per asset.

Work Order Service Appointment Result

Generation Method Generation Method
One work One work One One
order per order line service service
asset item per appointment appointment
asset per work per work
order order line
item

If Work Order Generation Method is set to One work order per asset, you
can’t set a Service Appointment Generation Method
Each asset creates a work order. If a work type is associated with auto-create
service appointment enabled, a service appointment is created for each work
order.
Example: A maintenance plan with four assets, a generation time frame of six
months, and a frequency of one month produces:
• Four work orders a month, 24 work orders for six months.
• A service appointment for each work order, if the auto-create service
appointment is enabled on an associated work type.

96
Field Service Lightning Manage Shifts

Work Order Service Appointment Result

Generation Method Generation Method
One work One work One One
order per order line service service
asset item per appointment appointment
asset per work per work
order order line
item

Invalid: If Work Order Generation Method is set to One work order line
item per asset, you must select a Service Appointment Generation Method.

One parent work order is created, a work order line item is created for each asset,
and one service appointment is created for the parent work order, even if the
associated work type doesn’t have auto-create service appointment enabled.
Example: A maintenance plan with four assets, a generation time frame of six
months, and a frequency of one month produces:
• One work order each month, six work orders for six months.
• Four work order line items on each work order.
• A service appointment for each parent work order, one per month, six for
six months.

One parent work order is created, a work order line item is created for each asset,
and one service appointment is created for each work order line item, if the
associated work type has auto-create service appointment enabled for work
order line items.
Example: A maintenance plan with four assets, a generation time frame of six
months, and a frequency of one month produces:
• One work order each month, six work orders for six months.
• Four work order line items on each work order.
• If auto-create service appointment for work order line item is enabled on
the work type, a service appointment for each work order line item, four
service appointments per month, 24 for six months.

Important: If your existing maintenance plans have work orders or work order line items associated with them, you can’t change
their generation methods. To change pre-existing maintenance plan generation methods, either delete the work orders and
regenerate them or delete the maintenance plan and recreate it with the needed generation methods.

Manage Shifts
Shifts in Field Service Lightning let you define variable working periods for your shift-based workforce, such as contractors or on-call
staff. Create shifts for particular dates and times when you need coverage, and assign them to service resources. When the managed
package is installed, scheduling and Enhanced Optimization consider workforce availability during shifts.

97
Field Service Lightning Create Flexible Work Shifts

IN THIS SECTION:
Create Flexible Work Shifts
Create shifts that vary from day to day or week to week. Shifts let you assign workers for time periods that don’t follow a rigid pattern,
such as rotating on-call duties or occasional overtime.
View Your Shift Schedule
Identify which shifts are covered, and which ones still require a worker to confirm that they’re available. The list view for shifts lets
you examine upcoming shifts and their status. Switch to the schedule view to see shifts grouped by service territory or job profile
in a calendar.
Guidelines for Shift Availability
Learn how to define valid shifts and show when your workers are available for shift work. Shifts can work alone or alongside operating
hours and service territory memberships to define workforce availability.

Create Flexible Work Shifts

Create shifts that vary from day to day or week to week. Shifts let you assign workers for time periods
EDITIONS
that don’t follow a rigid pattern, such as rotating on-call duties or occasional overtime.
1. From the App Launcher, click Shifts. Available in: Lightning
Experience
2. Do one of the following.
• Click New. The Field Service Lightning
core features, managed
• From the schedule view, hover in an empty space and click + New Shift.
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To view, create, and update

a shift
• View, create, and edit on
Shifts, Job Profiles,
Service Territories,
Service Resources,
Service Territory
Memberships

98
Field Service Lightning Create Flexible Work Shifts

3. Define the settings for the shift.

a. Enter a label for the shift.
b. Select a status.
• Tentative—The shift is tentatively defined.
• Published—The shift manager is ready to publish the shift to service resources.
• Confirmed—The shift has an assigned service resource. The scheduling engine considers confirmed shifts.

c. Enter dates and times for the shift's start and end.
d. Optional: Optionally, select a service territory and a service resource.
If you assign a service territory to the shift, the assigned service resource must be a member of the service territory.

e. Optional: Optionally, for Time Slot Type, select the type of working hours included in the shift. Normal hours fall within the service
resource's normal working hours, while extended fall outside those hours (for example, overtime hours).
f. Optional: Optionally, choose a job profile that defines the skills required to work during this shift.

4. Click Save.

99
Field Service Lightning View Your Shift Schedule

View Your Shift Schedule

Identify which shifts are covered, and which ones still require a worker to confirm that they’re
EDITIONS
available. The list view for shifts lets you examine upcoming shifts and their status. Switch to the
schedule view to see shifts grouped by service territory or job profile in a calendar. Available in: Lightning
1. From the App Launcher, click Shifts. Experience
2. Navigate to a list view other than the Recently Viewed list view, such as the All Shifts list view The Field Service Lightning
or a custom list view. Click the dropdown next to the list view name, and select the name of core features, managed
the list view that contains the shifts you want to see. package, and mobile app
are available in Enterprise,
3. Optionally, define filters to change which shifts appear.
Performance, Unlimited,
4. To view upcoming shifts, click and select . and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS
• To see a calendar of shifts that are assigned to each job profile, click the Shifts tab.
To view, create, and update
• To see a calendar of shifts that are assigned to each service resource, click the Resources
a shift
tab.
• View, create, and edit on
Shifts, Job Profiles,
Service Territories,
Service Resources,
Service Territory
Memberships

Keep the following considerations in mind when you work with shifts.
• If the managed package is installed, availability for confirmed shifts appears on the Gantt.
• In the Shifts tab, you can't use the quick search box to filter.

100
Field Service Lightning Guidelines for Shift Availability

• The NOT operator isn't supported when you define filter logic for shifts. If your filter logic uses NOT, we recommend adjusting the
filter type instead, for example by using the does not contain operator.
• You can create a shift from the schedule view by hovering in an empty space and clicking + New Shift.

Guidelines for Shift Availability

Learn how to define valid shifts and show when your workers are available for shift work. Shifts can
EDITIONS
work alone or alongside operating hours and service territory memberships to define workforce
availability. Available in: Lightning
Experience
Considerations The Field Service Lightning
core features, managed
For shifts to be valid, they must meet the following criteria.
package, and mobile app
All shifts are available in Enterprise,
To create shifts, you must have at least one service territory and one service resource that’s Performance, Unlimited,
assigned to that service territory. A shift must be fully contained within a primary service territory and Developer Editions.
membership for a service resource in that territory. Work orders are also
available in Professional
Shifts with a service territory
Edition.
When you create a shift with a service territory, the shift’s timespan must be fully contained
within the service resource's primary service territory membership for that territory.
Shifts without a service territory
When you want to define workforce availability across many territories, create the shift without a territory. A shift without a service
territory must be fully contained in a primary service territory membership. It adds availability in all territories based on territory
memberships; availability is added where the shift intersects service territory memberships.

101
Field Service Lightning Guidelines for Shift Availability

Scheduling, Enhanced Optimization, and Shift Availability

When the managed package is installed, scheduling and Enhanced Optimization consider workforce availability during shifts.
• When you schedule work using the dispatcher console or Book Appointments or Candidates global actions, scheduling uses availability
from confirmed shifts. Enhanced Optimization also uses available resources from confirmed shifts.
• Scheduling and Enhanced Optimization ignore job profiles and time slot types (normal or extended) that are defined in shifts.
• Shifts relax time slots for designated work or extended work (overtime). For example, if you assign a time period for emergency work
and create a shift that overlaps, scheduling can assign non-emergency appointments during the shift. Or, if you create a shift for
weekend on-call duties, you can schedule appointments although the shift is during extended hours.
• For shifts without territories, you can apply work rules to narrow the territories in which scheduling uses shift availability. To use shift
availability in the primary service territory, use a Match Territory work rule in your scheduling policy. To use shift availability in the
primary and other territories, use the Working Territories work rule.

Example: Adding Availability with Shifts

Rotating on-call duties are split into two shifts for Saturday morning and afternoon. The shift is associated with the San Francisco territory
and is fully contained in the service territory membership. The shifts are assigned to two workers that have accepted the shift work. The
managed package is installed in this org, so the Gantt displays the workers’ additional availability. When the dispatcher looks for candidates,
scheduling considers availability from the confirmed shifts (1) and from service territory membership (2).

102
Field Service Lightning Manage Service Resources

Manage Service Resources

Service resources are field service technicians that can be assigned to service appointments. Learn
EDITIONS
how to create time sheets and view a service resource’s travel routes and calendar.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Get Started with Time Sheets (Beta)
Before your mobile workers can start logging their hours using time sheets, lay down the The Field Service Lightning
foundation. Enable time sheets on the Field Service Lightning mobile app, set up an approval core features, managed
process, and customize time sheet fields. package, and mobile app
are available in Enterprise,
Create Service Resource Absences for Field Service Performance, Unlimited,
Create resource absences to indicate when a service resource is unavailable to work. During and Developer Editions.
schedule optimization, service resources aren’t assigned to appointments that conflict with Work orders are also
their absences. View and manage absences from the Absences related list on service resource available in Professional
records. Edition.
View a Service Resource’s Daily Travel Route
The scheduling optimizer uses street-level routing to schedule your technician’s day
appropriately. On the day of service, the Field Service Lightning mobile app’s geocoding feature tracks the actual route taken. You
can see both the planned and actual routes together on the resource map view.
View a Service Resource’s Calendar
Resource detail pages include a customizable calendar that shows the resource’s scheduled appointments and absences. The calendar
gives dispatchers a snapshot of the resource’s availability, and helps resources stay on top of their schedule.

103
Field Service Lightning Get Started with Time Sheets (Beta)

Get Started with Time Sheets (Beta)

Before your mobile workers can start logging their hours using time sheets, lay down the foundation.
EDITIONS
Enable time sheets on the Field Service Lightning mobile app, set up an approval process, and
customize time sheet fields. Available in: Salesforce
1. Enable mobile time sheets. Classic and Lightning
Experience
a. From Setup, enter Field Service Mobile Settings in the Quick Find box,
then select Field Service Mobile Settings. The Field Service Lightning
b. Click Edit next to your Field Service Mobile Settings configuration. core features, managed
package, and mobile app
c. Select Enable mobile time sheets. are available in Enterprise,
d. Click Save. Performance, Unlimited,
and Developer Editions.
2. Create an approval process. Work orders are also
available in Professional
a. From Setup, enter Approval Processes in the Quick Find box, then select Approval
Edition.
Processes.
b. Select Time Sheet from the dropdown menu.
USER PERMISSIONS
c. Click Create New Approval Process > Use Jump Start Wizard.
d. Create an approval process with the Jump Start Wizard. To enable time sheets:
• Customize Application
Note: When a mobile worker submits a time sheet, it initiates your approval process. If
you don't have an approval process set up, workers can't submit their time sheets.

3. Customize fields for time sheets.

a. In the Object Manager, enter Time Sheet in the Quick Find box, then select Time Sheet.
b. Select Page Layout > Time Sheet Layout.
c. Under Time Sheet Detail, add or remove fields. Up to four fields can be shown on the Field Service Lightning mobile app.
d. Click Save.

4. Create time sheet templates on page 105.

Considerations for time sheets:
• Users can view up to 100 past time sheets offline on their mobile devices.
• The first field on Time Sheet Detail displays as the header. Three more fields can be displayed as details below the header.
• To resubmit a past time sheet with corrections, users must either use their desktop computer or ask their manager to resubmit it.

Note: As a beta feature, time sheets are a preview and aren’t part of the “Services” under your master subscription agreement
with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available
products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all,
and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t
supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce
reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply
equally to your use of this feature. You can provide feedback and suggestions for time sheets in the Field Service Lightning group
in the Trailblazer Community.

104
Field Service Lightning Get Started with Time Sheets (Beta)

IN THIS SECTION:
Create Time Sheet Templates (Beta)
You can automatically create time sheets from a template so that service resources can track their time and work. Specify the time
period each time sheet covers, such as a week or month, and track specific tasks, travel time, and break time. Time sheets are created
one day before their start date. You can only create time sheets for service resources of the type Technician.

Create Time Sheet Templates (Beta)

You can automatically create time sheets from a template so that service resources can track their
EDITIONS
time and work. Specify the time period each time sheet covers, such as a week or month, and track
specific tasks, travel time, and break time. Time sheets are created one day before their start date. Available in: Lightning
You can only create time sheets for service resources of the type Technician. Experience
1. From Setup, enter Time Sheet Settings in the Quick Find box, then select Time Sheet
The Field Service Lightning
Settings. core features, managed
2. Click New and enter details for the time sheet template. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To create time sheets:

• Create on time sheets
To view time sheet entries:
• Read on time sheets
To create, update, or delete
time sheet entries:
• Edit on time sheets

105
Field Service Lightning Get Started with Time Sheets (Beta)

• For Label, enter a descriptive name for the template so that you can distinguish it from others.
• For API Name, enter an API name for the template, which uses underscores instead of spaces.
• For Start Date, enter the date that you want the time sheet template to take effect. Because the time sheet autocreation job runs
once per day, we recommend setting a start date that is at least 24 hours in the future.
• For Frequency, select the time range that you want each time sheet to cover. New time sheets are automatically created on the
frequency you specify. For example, if you select Daily, a time sheet is created every day. If you select Monthly, each time sheet
covers an entire month, beginning on the start date that you entered.
• For Work Week Start Day, select the day that you want each work week to begin on.
• For Work Week End Day, select the day that you want each work week to end on.
• Enter a description for the time sheet template.
• Mark the time sheet template as Active.

Important: Time sheets are automatically created only if the template is marked Active.

3. Assign the time sheet template to user profiles.

a. Click Assign to Profiles.
b. Select at least one user profile that you want to assign the time sheet template to, and click Change Assignments.
c. Under Time Sheet Setting, select the time sheet template you want the profiles to use, and click Save.

106
Field Service Lightning Get Started with Time Sheets (Beta)

The template name appears next to each profile that you assigned it to.

To confirm that time sheets were created successfully, navigate to Time Sheets in the App Launcher, and create list view filters. If the
autocreation process can’t create a time sheet, it doesn’t retry. If a time sheet isn’t created as expected, you can manually create it.

Important: Editing the frequency of an existing time sheet template isn't recommended. To avoid errors, first deactivate the
existing template. Then create a template with the correct frequency, mark it as active, and assign it to the desired user profiles.
Considerations for time sheet templates:
• If you add a required custom field that uses custom values, time sheets aren't automatically created.
• Using the same work week start day and work week end day results in a work week that is one day long.
• The Twice a month frequency uses days 1–15 as the first half of the month and days 16–31 as the second half of the month.
• Start date defines the day your time sheet begins. So if your time sheet template's start date is on a Tuesday, your work week start
day is Monday, and you set the frequency to every two weeks, the first time sheet starts on Tuesday. The time sheet autocreation
job creates the first batch of time sheets when it runs on Monday. Thereafter, time sheets start on Mondays, and they are automatically
created when the job runs on Sundays.
• Time sheet templates aren't included in updates to the managed package.

Note: As a beta feature, time sheets are a preview and aren’t part of the “Services” under your master subscription agreement
with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available
products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all,
and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t
supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce
reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply
equally to your use of this feature. You can provide feedback and suggestions for time sheets in the Field Service Lightning group
in the Trailblazer Community.

107
Field Service Lightning Create Service Resource Absences for Field Service

Create Service Resource Absences for Field Service

Create resource absences to indicate when a service resource is unavailable to work. During
USER PERMISSIONS
schedule optimization, service resources aren’t assigned to appointments that conflict with
their absences. View and manage absences from the Absences related list on service resource To view, create, or update
records. resource absences:
• Read on service
1. From the Absences related list on a service resource, click New.
resources
2. *Select Non Availability as the record type. The Break record type is used to automatically
Note: Read Only
create breaks during schedule optimization.
users with Read
3. Select an absence type: Vacation, Meeting, Training, or Medical. permission on
service resources
Tip: Add more absence types by updating the Type picklist on the resource absence can create
object in Setup. Don’t use Break as a picklist value; the managed package uses resource
that name. absences.

4. Enter a start and end time and description. To add or edit picklist values:
• Customize Application
5. *Optionally, add a Gantt label. The Gantt label appears on the absence in the Gantt. For
example, Bahamas or Driver Training. (We know which option we’d choose…) To customize the Field
Service Lightning managed
Note: Gantt labels aren’t visible on Break resource absences. package:
• Customize Application
6. Optionally, enter an address, such as a training location. For absences that don’t span an
entire shift—like a morning medical appointment—the absence address is used to
determine travel time to and from adjacent service appointments. Appointments aren’t scheduled during dedicated travel time.
*If the Field Service Lightning managed package isn’t installed, you don’t see options to select a record type or enter a Gantt label.
The Gantt shows breaks to the left of travel to appointments. If a break is planned during travel time, optimization can still schedule the
appointment. The resource can drive, take the break at the specified time, and then complete the travel.
Non Availability absences are shown on the Gantt with a “no entry” icon, while Break absences are shown with a teacup icon. Update
the Gantt Color field on a resource absence to customize its color on the Gantt.

Note: If a service resource of type Crew has resource absences, those absences are considered in scheduling and shown on the
Gantt. Absences associated with individual crew members’ corresponding service resources aren’t considered.

108
Field Service Lightning View a Service Resource’s Daily Travel Route

View a Service Resource’s Daily Travel Route

The scheduling optimizer uses street-level routing to schedule your technician’s day appropriately.
EDITIONS
On the day of service, the Field Service Lightning mobile app’s geocoding feature tracks the actual
route taken. You can see both the planned and actual routes together on the resource map view. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Important: To view travel routes, enable street-level routing.
The Field Service Lightning
core features, managed
To navigate to a service resource’s map, start from the dispatcher console resource list. Click Details
package, and mobile app
in a resource’s action menu, and then click the Map tab. You can also view a service resource’s
are available in Enterprise,
scheduled appointments on the main dispatcher console map by selecting the service resource in
Performance, Unlimited,
the Map Layers settings.
and Developer Editions.
Work orders are also
available in Professional
Edition.

At the top of the map, select which date to show, and choose one or more types of data to display: Route (shown in blue), Actual Route
(shown in pink), and Traffic. The actual route can be shown only if history tracking is set on the service resource’s Last Known Location
field and geolocation tracking is turned on for them.
The truck icon signifies an appointment. The X icon signifies a resource absence with a valid address, meaning its latitude and longitude
can be calculated.

Note: To show or hide resource absences on the map, from the App Launcher, find and open the Field Service Admin app, and
then click Field Service Settings. Then, click Dispatcher Console UI > Gantt Configurations and select or deselect Show
absences on resource map.
On the right-hand side of the map, you can show or hide the route details pane. To zoom in on an appointment, hover over the
appointment number in the pane and click Center on Map.

109
Field Service Lightning View a Service Resource’s Calendar

Note: If a service resource has more than 23 stops in a period of 24 hours (including starting point, ending point, appointments,
and absences), the resource map shows only the first 23 stops on the route and displays an error. This is a Directions API limitation.

View a Service Resource’s Calendar

Resource detail pages include a customizable calendar that shows the resource’s scheduled
EDITIONS
appointments and absences. The calendar gives dispatchers a snapshot of the resource’s availability,
and helps resources stay on top of their schedule. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
To view a service resource’s calendar, navigate to their detail page from the Service Resources tab
The Field Service Lightning
and scroll to the Calendar tab. Click a field on a calendar entry to open the corresponding record
core features, managed
in a new tab.
package, and mobile app
Note: If you don’t see the calendar on resource pages, add the VF079_ResourceCalendar are available in Enterprise,
Visualforce component to the service resource page layout. Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To edit field sets:

• Customize Application
To edit page layouts:
• Customize Application

110
Field Service Lightning View a Service Resource’s Calendar

Here’s how to control which information appears in the calendar.

1. To control which fields appear in calendar entries for service appointments and resource absences, customize field sets.
• The Service Appointment Resource Calendar Display field set controls what information appears on the calendar entry.
• The Service Appointment Resource Calendar Tooltip field set controls what information appears in a tooltip when you hover over
the calendar entry.
• The Resource Absence Resource Calendar field set controls what information appears on a resource absence calendar entry.
• The Absence Resource Calendar Tooltip field set controls what information appears in a tool tip when you hover over the calendar
entry.
For more details, see Customize the Dispatcher Console with Field Sets.

2. To color-code resource absences on the calendar, update the Gantt Color field on resource absences with a 6-digit hex code.
This field lets you represent different types of absences with different colors—for example, lunch breaks in red and internal meetings
in green.

Tip: Use Process Builder to automate the color-coding of resource absences.

111
Field Service Lightning Manage Service Crew Membership

Manage Service Crew Membership

Efficiently manage your service crews to accommodate a fast-changing field service schedule.
EDITIONS
Create crews, find and add members with the right skills, adjust membership dates to match
appointment times, and view all crews’ schedules and members in one place. Available in: Salesforce
While you can manually manage service crew membership from the Service Crew Members related Classic and Lightning
list on service crew records, we recommend using the drag-and-drop crew management tool. Experience

The Field Service Lightning

This is a Field Service Lightning managed package feature.
core features, managed
1. Create your service crews. The crew management tool only shows crews with an active service package, and mobile app
resource of type Crew. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To view service crew

members:
• Read on service crews
AND
Read on service
resources
To create service crews
using the crew
management tool:
• Create on service crews
AND
Create on service
resources
AND
Edit on service territories

To create, update, or delete

service crew members:
• Edit on service crews

112
Field Service Lightning Manage Service Crew Membership

2. Open the crew management tool by clicking the Crew Management tab or opening the Lightning page that contains it.

Note: If you have trouble finding it, ask your admin to follow the steps in Set Up Crew Management and let you know where
the tool is located.

3. In the top-right corner, select a date and number of days to display.

4. In the sidebar, click the map icon to view a list of territories with active service crews. Select territories whose crews you want to see
and click Save. After you select territories, each crew’s schedule and members appear in the chart.
Now that your dates and service territories are selected, it’s time to manage crew membership.
View Crew Details
Hover over a crew name in the chart to see the skills that its members need. To update these skills, navigate to the associated service
resource record of type Crew and update the Skills related list.

113
Field Service Lightning Manage Service Crew Membership

Hover over a service crew membership in the chart to view the membership start and end dates. Crew leaders appear with a star.

View Appointment Details

In any Crew Schedule row, hover over an appointment to view its details. A red flag icon means that the assigned service crew
doesn’t yet comply with the minimum crew size or skill requirements listed on the appointment’s parent record. View skill and crew
size alerts at the bottom of the hover window.

Double-click an appointment to open a window that shows the appointment’s fields and its parent record’s fields and related records.
Find the Right Crew Member
If the territory filter is visible in the sidebar, click the map icon to hide it and show the service resource list. The sidebar shows service
resources who are members of the selected service territories during the dates shown on the chart.
• Click a service resource’s name in the sidebar to view their skills, service territory membership, and service crew membership.
Click the card icon to the right of their name to view the service resource record.
• Select a scheduling policy using the Policy dropdown menu.
• Filter service resources by skill in one of two ways:
– Click the filter icon in the resource list to select skills to filter for.
– Click Match Crew Skills on a crew to show only service resources with the skills listed on the crew’s service resource record
of type Crew.

114
Field Service Lightning Manage Service Crew Membership

• If an appointment shows missing skills or members, right-click the appointment and click Get Candidates to filter the resource
list based on skills, availability, and operating hours. If the crew just needs members, all available resources are shown. If skills
are missing, available service resources with the missing skills are shown first. Select one or more resources and click Assign
Selected to add them to the crew for the appointment’s time frame.

115
Field Service Lightning Manage Service Crew Membership

Add a Service Resource to a Crew

Add service resources to crews by dragging them from the resource list. To add multiple resources at once, select them in the list
before dragging.
• Drag a resource onto a crew’s name to add them to the crew for the dates shown on the chart. A window opens where you can
update crew membership dates and make the resource the crew leader.
• Drag a resource onto another resource’s service crew membership to create an identical crew membership.
• Drag a resource onto an appointment to create a crew membership for the appointment’s time frame.

116
Field Service Lightning Manage Service Appointments

Edit or Delete Crew Membership

Double-click a crew membership in the chart to edit its dates, make the resource the crew leader, or delete the membership.

Manage Service Appointments

Learn how to create, schedule, reschedule, and unschedule service appointments. Tighten up your
EDITIONS
schedule by fixing overlaps, grouping nearby appointments, and filling schedule gaps.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Create Service Appointments for Field Service
Service appointments represent field service visits to customers. While work orders describe The Field Service Lightning
the work to be performed, service appointments provide the scheduling and assignment details. core features, managed
package, and mobile app
Schedule Service Appointments for Field Service
are available in Enterprise,
Schedule service appointments from the record feed or from the appointment list in the Performance, Unlimited,
dispatcher console. You can also create scheduling dependencies between service appointments and Developer Editions.
to organize larger jobs, or schedule an appointment by manually updating its status. Work orders are also
Unschedule Service Appointments available in Professional
Edition.
Unschedule service appointments from the dispatcher console or a service appointment record.
Reschedule Service Appointments
To reschedule service appointments, use the Book Appointment Chatter action or the Reshuffle action in the Gantt.
Fix Scheduling Overlaps
If a service appointment overlaps with other appointments or absences, use the Fix Overlaps feature to harmoniously reschedule
appointments.
Group Nearby Appointments
To minimize travel time or gaps between appointments, use the Group Nearby Appointments action on a service appointment. This
feature unschedules appointments that were scheduled later that day and replaces them with appointments that are close in location
to the source appointment.
Fill Schedule Gaps
To fill gaps in a service resource’s schedule, use the Fill-In Schedule feature. This feature creates a list of appointments for a technician
and finds the optimal schedule.
Customize Service Appointment Chatter Settings
Control whether custom Gantt Chatter posts, dispatch posts, and emergency posts are shared on service appointments or on service
appointment parent records.

117
Field Service Lightning Create Service Appointments for Field Service

Dispatch Service Appointments

Dispatch scheduled service appointments to your mobile workers. You can dispatch appointments from the console, or set up jobs
that automatically dispatch or drip feed the next appointments.

Create Service Appointments for Field Service

Service appointments represent field service visits to customers. While work orders describe the
EDITIONS
work to be performed, service appointments provide the scheduling and assignment details.
Service appointments can be added to work orders, work order line items, opportunities, leads, Available in: Salesforce
accounts, or assets. To create a service appointment: Classic and Lightning
Experience
1. From the Service Appointments tab or the Service Appointments related list on a record, create
a service appointment. The Field Service Lightning
2. Fill out the General Information section. core features, managed
package, and mobile app
a. Add an appointment subject and description. are available in Enterprise,
b. If needed, update the duration. If the parent record is a work order or work order line item, Performance, Unlimited,
the appointment inherits its duration from its parent. and Developer Editions.
Work orders are also
c. Fill out the Earliest Start Permitted and Due Date, which together represent the window available in Professional
during which the appointment must be completed. These fields typically represent terms Edition.
in the customer’s service-level agreement.
d. In the Service Note field, add notes such as an appointment summary or recommendations.
USER PERMISSIONS
Depending on your settings, these notes can appear on customer-facing service reports.
To create service
3. Fill out the Scheduled Times section. appointments:
a. Add scheduled start and end times. If you’re using the Field Service Lightning managed • Create on service
package with schedule optimization, these fields are populated when the appointment is appointments
scheduled. To create assigned
resources:
b. Optionally, define an arrival window, which is the window of time when the technician is
• Edit on service
expected to arrive at the site. This window is typically larger than the scheduled start and
appointments AND Read
end window to allow time for delays and scheduling changes. You may choose to share on service resources
the arrival window start and end with the customer, but keep the scheduled start and end
To update or delete
internal-only.
assigned resources:
4. Assign service resources to the appointment in the Assigned Resources related list. If the parent • Edit on service
record is a work order or account, check the parent for any resource preferences. appointments

Note:
• Service resource who are dispatchers can’t be assigned to service appointments.
• In the Gantt, service appointments are labeled using their appointment number. To
customize a service appointment's label, fill in the Gantt Label field on the appointment
record.
• If an assignment is made during scheduling or optimization—Field Service Lightning
managed package features—assigned resource records are automatically created.
• If an appointment has more than one assigned resource, only the first created assigned
resource is recognized in scheduling and in the dispatcher console. However, if the
appointment is assigned to a service resource of type Crew, assigned resource records

118
Field Service Lightning Create Service Appointments for Field Service

are auto-created for the crew members, and the assignment details are displayed correctly in the dispatcher console.

5. When the technician completes the appointment, have them fill out the Actual Times section to indicate when the appointment
started and ended. In addition, they can enter the minutes it took to travel to the appointment in the Actual Travel Time field on
their assigned resource record.
If Auto-Create Service Appointment is selected on a work type, a service appointment is created when a work order or work order
line item lists that work type. For details, see Create Work Types for Field Service.

IN THIS SECTION:
Guidelines for Creating Service Appointments for Field Service
A service appointment tracks field service work to be performed for a customer, and is typically associated with a work order or work
order line item. Learn how to create and manage service appointments.

Guidelines for Creating Service Appointments for Field Service

A service appointment tracks field service work to be performed for a customer, and is typically
EDITIONS
associated with a work order or work order line item. Learn how to create and manage service
appointments. Available in: Salesforce
View Service Appointments Classic and Lightning
View service appointments in the following places: Experience

• Service Appointments tab The Field Service Lightning

• Service Appointments related list on work orders, work order line items, or service resources core features, managed
package, and mobile app
• Dispatcher console
are available in Enterprise,
Create Service Appointments Performance, Unlimited,
Create service appointments from the Service Appointments tab or related list, or with the Book and Developer Editions.
Appointment, Candidates, and Emergency Chatter actions in a record feed. Work orders are also
available in Professional
Note: On the Service Appointments related list on a service resource record, you can’t Edition.
create appointments, but you can assign the resource to existing appointments.
Delete Service Appointments
If an appointment is canceled, you can delete the appointment or change its status to Canceled. Deleting a parent record, like a
work order, deletes its child service appointments.
Associate Service Appointments with Other Records
Service appointments always have a parent record, which can be a work order, work order line item, opportunity, account, or asset.
The parent record tells you about the nature of the service appointment:
• Service appointments on work orders and work order line items offer a more detailed view of the work being performed. While
work orders and work order line items let you enter general information about a task, service appointments track scheduling
and ownership. If you select Auto-Create Service Appointment on a work type, a child service appointment is added to all
work orders or work order line items that use the work type. In scheduling and optimization, service appointments are scheduled
according to your settings.
• Service appointments on assets represent work being performed on the asset.
• Service appointments on accounts represent work being performed for the account.
• Service appointments on opportunities represent work that is related to the opportunity.
• Service appointments on leads represent work that is related to lead—for example, a site visit to pursue a promising lead.

119
Field Service Lightning Schedule Service Appointments for Field Service

Schedule Service Appointments for Field Service

Schedule service appointments from the record feed or from the appointment list in the dispatcher
EDITIONS
console. You can also create scheduling dependencies between service appointments to organize
larger jobs, or schedule an appointment by manually updating its status. Available in: Salesforce
Classic and Lightning
IN THIS SECTION: Experience

Schedule Appointments from the Record Feed The Field Service Lightning
Use the Book Appointment or Candidates Chatter actions to schedule and reschedule service core features, managed
appointments for work orders, work order line items, accounts, assets, leads, and opportunities, package, and mobile app
or from a service appointment itself. To reflect different visits, you can schedule one or more are available in Enterprise,
service appointments for a record. Performance, Unlimited,
and Developer Editions.
Schedule Appointments from the Dispatcher Console Work orders are also
You can schedule service appointments from the Field Service Lightning dispatcher console available in Professional
by using the mass schedule action or by dragging them onto the Gantt. Edition.
Schedule an Appointment Automatically
Schedule an appointment in a hurry with Auto Schedule—right from the appointment itself.
Auto Schedule finds the best available slot based on your scheduling policy.
Create Scheduling Dependencies Between Service Appointments
To stay on top of complex projects, create scheduling dependencies between related service appointments. For example, ensure
that a particular appointment can’t start until a related appointment is complete.
Schedule Emergency Appointments
Swiftly schedule, dispatch, and track emergency appointments with the help of a real-time map view. The Emergency Chatter action
on a service appointment shows a map view of your closest field resources so that you can dispatch work immediately.
Schedule Higher Priority Appointments over Less Urgent Appointments
Give critical service appointments precedence over lower priority appointments. Scheduling overlaps lower priority appointments
with services that you specify as high-priority.
Update an Appointment’s Status
You can schedule or unschedule an appointment by updating its status. An appointment’s status can be updated from several places
in Salesforce.

120
Field Service Lightning Schedule Service Appointments for Field Service

Schedule Appointments from the Record Feed

Use the Book Appointment or Candidates Chatter actions to schedule and reschedule service
EDITIONS
appointments for work orders, work order line items, accounts, assets, leads, and opportunities, or
from a service appointment itself. To reflect different visits, you can schedule one or more service Available in: Salesforce
appointments for a record. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
Tip: For help scheduling emergency appointments, see Schedule Emergency Appointments. core features, managed
package, and mobile app
Action Used By Options Provided are available in Enterprise,
Performance, Unlimited,
Book Support agents or Arrival windows, which are based on the default and Developer Editions.
Appointment customers. For example: operating hours selected in your appointment Work orders are also
• Agents can use it to booking settings. available in Professional
book an appointment Edition.
Note: If you’ve added customer-specific
for a customer over the operating hours to an entitlement on the
phone related work order, the options provided USER PERMISSIONS
• Customers can use it if are based on those hours.
the action is embedded To schedule an appointment
using the Book Appointment
in your Salesforce
or Candidates action:One of
community these custom permission
sets:
Candidates Typically, only support Appointment time slots, organized by service
• FSL Admin Permissions
agents. resource. The time slots are based purely on
• FSL Agent Permissions
empty space in technician schedules, not arrival
windows, making this action ideal for • FSL Dispatcher
Permissions
appointments where no coordination is needed
with the customer. To view the Change
Scheduling Policy field on
the Book Appointment
1. Open the record that requires an appointment. action:
• Policy Picker In
2. In the Chatter feed, select either Book Appointment or Candidates based on your needs. If Appointment Booking
the action isn’t available, select the page layout and add the quick action. For appointment custom permission
booking, we recommend that you add the action; don’t add the AppointmentBookingVf To view the Change
Visualforce page using Lightning App Builder. Scheduling Policy field on
3. If you’re creating an appointment for a work order or work order line item, leave the work type the Candidates action:
as is. It’s defined on the parent record and can’t be updated from the Chatter action window. • Policy Picker In Get
Candidates custom
The work type serves as a template that provides skill requirements, duration, and other data
permission
used in scheduling the work.
4. Optionally, update the address and service territory, which are typically inherited from the
parent record.
5. To view time slots for yourself only, click Assign to Me. You see this option if you’re associated with a service resource record and
the default scheduling policy includes a Required Resources work rule.
6. If you clicked Book Appointment:
a. To change the earliest start permitted and due date, click Show more options.

121
Field Service Lightning Schedule Service Appointments for Field Service

b. To view a graded list of available arrival windows, click Get Appointments. The list considers all scheduling constraints, such
as the current schedule and work rules, and is graded according to the service objectives. Depending on your appointment
booking settings, arrival windows can be flagged as Ideal or Recommended or shown in yellow to indicate a prime window. To
see how each window ranks against the scheduling policy’s service objectives, click its information icon.
c. To view a wider range of service appointment dates, click Extend Dates.
d. To create the service appointment, select an arrival window. You can then view its details.

7. If you clicked Candidates:

a. Click Get Candidates to view a list of available service resources.
b. Click a resource’s name to view their open time slots, which are scored 0–100 based on how well the slot matches the applied
scheduling policy.
c. To schedule the appointment, select a time slot in a resource’s list and click Schedule to [name].

8. To rerun the search using a different scheduling policy than the default policy, select a policy in the Change Scheduling Policy
field.
Book Appointment Window

Candidates Window

122
Field Service Lightning Schedule Service Appointments for Field Service

Note: Booking from objects other than work orders or work order line items creates a work order, and the service appointment
is created for that work order. For instance, booking an appointment from an asset record creates a related work order and service
appointment.

Schedule Appointments from the Dispatcher Console

You can schedule service appointments from the Field Service Lightning dispatcher console by
EDITIONS
using the mass schedule action or by dragging them onto the Gantt.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Drag an Appointment from the Appointment List to the Gantt The Field Service Lightning
Schedule an appointment by dragging it from the appointment list into any service resource’s row core features, managed
on the Gantt. package, and mobile app
are available in Enterprise,
If the assignment causes a rule violation (for example, if the resource doesn’t possess the required
Performance, Unlimited,
skill), the appointment is marked with a yellow triangle. Hover over the appointment to view its
and Developer Editions.
details and rule violations..
Work orders are also
Note: Rule violations occur only when a service appointment is scheduled using the dragging available in Professional
method. Edition.

Customize the drag settings from the Field Service Admin app.

123
Field Service Lightning Schedule Service Appointments for Field Service

1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Dispatcher Console UI.
3. In the Drag jumps on Gantt field, enter the minutes segment. For example, if you enter 15, you can drag an appointment into slots
starting at 0, 15, 30, and 45 minutes after the hour.
4. Save your changes.

Schedule an Appointment from the Map

Schedule an appointment directly from the dispatcher console map. First, pop out the map by clicking on the Map tab, and then
click an appointment icon (1) to display its details. Click Schedule (2) to schedule the appointment, or drag the shaded appointment
icon (3) from the details window into any service resource’s row on the Gantt. If you use the dragging method, the information above
about rule violations applies.

Schedule an Appointment from the Mini View

Click a service appointment in the appointment list to show a mini view of the appointment. At the bottom of the mini view, click
Schedule. The service appointment is scheduled according to the scheduling policy selected at the top of the appointment list.
If no candidates are available, you can bypass the scheduling policy’s rules and objectives or select a different scheduling policy.

Use the Mass Schedule Action

Select one or more appointments in the appointment list, and click Schedule above the appointment list search field. Appointments
are scheduled in priority order. A progress bar appears in the bottom right corner during the scheduling process.
When scheduling is complete, click View Service Appointments to review the details.

124
Field Service Lightning Schedule Service Appointments for Field Service

Schedule an Appointment Automatically

Schedule an appointment in a hurry with Auto Schedule—right from the appointment itself. Auto
EDITIONS
Schedule finds the best available slot based on your scheduling policy.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
To grade available time slots, Auto Schedule uses rules and objectives in a scheduling policy. In the Experience
Field Service Admin app, specify the default policy in Field Service Settings > Dispatcher Console
The Field Service Lightning
UI > Gantt Configurations. To override the default, add the Scheduling Policy Used field to the
core features, managed
service appointment layout. Before you auto-schedule the appointment, select a scheduling policy
package, and mobile app
in this field.
are available in Enterprise,
1. Customize the service appointment page layout, and add the Auto Schedule field. Optionally, Performance, Unlimited,
add the Scheduling Policy Used field. and Developer Editions.
2. Open the service appointment that you want to schedule, and click Auto Schedule. Optionally, Work orders are also
available in Professional
select a scheduling policy to use instead of the default policy.
Edition.
3. Click Save.
Auto Schedule tries to find the best slot for the appointment. It’s then deselected in the appointment USER PERMISSIONS
record regardless of whether scheduling is successful.
To auto-schedule from a
service appointment: One of
these custom permission
sets:
• FSL Admin Permissions
• FSL Agent Permissions
• FSL Dispatcher
Permissions

Create Scheduling Dependencies Between Service Appointments

To stay on top of complex projects, create scheduling dependencies between related service
EDITIONS
appointments. For example, ensure that a particular appointment can’t start until a related
appointment is complete. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience

The Field Service Lightning

Prepare to Create Dependencies core features, managed
Enable the scheduling dependencies feature, known as complex work, and update page layouts. package, and mobile app
are available in Enterprise,
1. Enable complex work. If it isn’t enabled, you can still create relationships between appointments,
Performance, Unlimited,
but simultaneous scheduling isn’t guaranteed.
and Developer Editions.
a. From the App Launcher, find and open the Field Service Admin app, and then click the Work orders are also
Field Service Settings tab. available in Professional
Edition.
b. Click Scheduling > General Logic.
c. Under Complex Work, select Enable complex work.

125
Field Service Lightning Schedule Service Appointments for Field Service

d. If you want related service appointments to always be scheduled in the same scheduling operation, select Use all-or-none
scheduling for related appointments. This setting prevents two service appointments with a dependency between them
from being scheduled separately. It doesn’t apply to chains of three or more appointments.

2. Customize the service appointment page layout to show complex work features.
a. In the layout editor, open the service appointment page layout.
b. Add a single-column section to the layout. Name it Scheduling Dependencies or something similar.
c. Select Visualforce Pages and drag the vf739_ComplexWork page to the new section.
d. Click the wrench icon on the Visualforce page to display its properties. Set the height in pixels to 600.
e. Remove the following fields from the service appointment page layout. These fields were used before complex work was available,
and aren’t needed. If these fields appear in their own section, remove the section.
• Time Dependency
• Same Resource
• Same Day
• Related Service

f. Save your changes.

3. From the Object Manager in Setup, open the Appointment Dependency object. Under Fields & Relationships, select the
Dependency field. Activate the dependency values that you want to be available for complex work.

Create Dependencies
You can create dependencies between two or more existing service appointments. Each appointment’s parent record must be a work
order.
1. On a service appointment detail page, find the Scheduling Dependencies section.
2. Select two appointments to relate to each other.
3. Select a dependency type:
• Same Start: The appointments must start together.
• Start After Finish: One appointment cannot start until the other is completed.
• Start After Finish and Same Day: One appointment cannot start until the other is completed, and they must be scheduled for
the same day.
• Immediately Follow (beta): The appointments must be scheduled back-to-back on the same day without any interruption, and
they must be scheduled to the same resource.

4. Optionally, require the appointments to be assigned to the same service resource.

5. Click Create Dependency.
For example, suppose a customer calls to report a leaking skylight that has damaged a section of the ceiling. The support agent creates
a work order to address the problem, and adds two service appointments: one to fix the skylight (SA-0064), and one to repair the ceiling
(SA-0063). The skylight must be fixed before the ceiling is repaired, so the agent creates the following dependency.

126
Field Service Lightning Schedule Service Appointments for Field Service

After the agent adds the dependency, it’s visible in a diagram and in a list at the bottom of the Scheduling Dependencies section.

You can now schedule the appointments. Appointments with dependencies can be scheduled in the usual ways—scheduling quick
actions, the dispatcher console, and optimization—or by clicking Schedule Appointments in the Scheduling Dependencies section.

IN THIS SECTION:
Considerations for Scheduling Dependencies
Keep these considerations in mind when you schedule dependencies between service appointments.

127
Field Service Lightning Schedule Service Appointments for Field Service

Considerations for Scheduling Dependencies

Keep these considerations in mind when you schedule dependencies between service appointments.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
Classic and Lightning
General Considerations Experience
When you set up appointments with scheduling dependencies, known as complex work, keep The Field Service Lightning
these points in mind. core features, managed
• Except for consecutive work, you can create dependencies between more than two package, and mobile app
appointments. However, when you schedule a chain of appointments, dependencies are are available in Enterprise,
Performance, Unlimited,
enforced for two appointments at a time, even if you select Use all-or-none scheduling for
and Developer Editions.
related appointments. For a chain of more than two appointments, we can’t guarantee that
Work orders are also
scheduling and optimization will schedule all appointments in the chain. For example, for a
available in Professional
chain of four appointments, the first two appointments might be scheduled but not the third
Edition.
or fourth.
• To view a service appointment’s related appointments, right-click the appointment on the
Gantt and select Show related.
• To control which fields are shown in the search results, modify the Service Appointments List Columns field set.
• Capacity-based resources can’t be assigned to appointments that are part of an appointment chain.
• If a chain of appointments spans multiple service territories, you must select all territories in the optimization request for the
appointments to be scheduled.
• If a multiday service appointment is part of a chain of appointments, its scheduled end date isn’t calculated when the appointment
is scheduled. For this reason, we recommend against creating dependencies between multiday appointments.
• Community dispatchers can’t access this feature.

Consecutive Work Considerations

You can create consecutive work with an Immediately Follow dependency (beta). Be aware of the following considerations
and limitations.
• We prevent the creation of Immediately Follow dependencies for chains of more than two service appointments.
• Enhanced Optimization enforces this dependency for chains of two service appointments. The standard optimization engine doesn’t
support this dependency type.
• Scheduling and optimization don’t support predictive travel, crews, resource efficiencies, reshuffle actions, fixed gaps, or multiday
work with consecutive work appointments.
• Breaks are not supported; scheduling and optimization overlap breaks with consecutive appointments and may result in rule violations.
• The org-wide setting for travel speed is used to calculate travel time between consecutive appointments.
• If you reschedule consecutive appointments, the scheduling logic doesn’t consider the second appointment’s original slot as an
available slot.
• If the first appointment is scheduled successfully but not the second, scheduling and optimization don’t unschedule the first
appointment.

128
Field Service Lightning Schedule Service Appointments for Field Service

Schedule Emergency Appointments

Swiftly schedule, dispatch, and track emergency appointments with the help of a real-time map
EDITIONS
view. The Emergency Chatter action on a service appointment shows a map view of your closest
field resources so that you can dispatch work immediately. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience

The Field Service Lightning

Schedule an Emergency Appointment core features, managed
1. From any standard or custom object record, click the Emergency action in the Chatter feed. If package, and mobile app
you don’t see the action, ask your admin to add it to the page layout. are available in Enterprise,
Performance, Unlimited,
2. Select a work type, address, and service territory, and click Emergency Dispatch to generate
and Developer Editions.
a list of available service resources and display a map of your team. Click a resource on the map
Work orders are also
to see: available in Professional
• Their route to the emergency service and ETA. Edition.
• The data (breadcrumb) that their location is based on. The Last known location validity field
in the emergency booking settings controls the location logic.
• A Dispatch button, which assigns the appointment to them.

3. If you’re having trouble finding a candidate, select a different scheduling policy directly on the map or modify your emergency
booking settings.

Tip:
• If you want a candidate to complete their current appointment before heading to the emergency appointment, change the
dispatcher setting on the map from “as soon as possible” to “after current Service Appointment”. Changing this setting updates
the candidates’ ETA.
• Click Candidates to view a list of all candidates organized by ETA. Hover over a resource name in the list to see options to
dispatch them or view them on the map.
• Quickly spot emergency appointments in the Gantt by looking for the lightning icon.

Customize Emergency Booking Settings

From the App Launcher, find and open the Field Service Admin app, and then click Field Service Settings. Then, click Global Actions >
Emergency Wizard.

Setting Name Description

Emergency scheduling policy The default policy that is used to find resources to assign to an
emergency appointment. We recommend using an Easy policy
with softer rules to ensure that more candidates are returned.

Last known location validity The number of minutes after which a data breadcrumb—like
resource location or geolocation—is no longer valid. For example,
if the breadcrumb validity is 20 minutes and the Last Known
Location of resource X was last updated 30 minutes prior, the
emergency dispatcher calculates the resource’s ETA based on the
location of the last appointment they completed, or (if no
appointments were completed that day) their home base. The

129
Field Service Lightning Schedule Service Appointments for Field Service

Setting Name Description

home base is the resource’s service territory member address, or
if not applicable, their service territory address.

Ideal availability grade The grading of candidates, which is color-coded. In the

Good availability grade breadcrumbs example:
• Resources who can reach the appointment in less than 30
minutes are ideal candidates.
• Resource who can reach the appointment between 30 and 60
minutes are good candidates.
• Resources who can reach the appointment after 60 minutes
are bad candidates.

Emergency search timeframe The amount of time you have to resolve the emergency, not
counting the appointment duration. The Earliest Start
Permitted on the appointment is set to the current time, and
the Due Date is the current time + appointment duration +
Emergency Search Timeframe.
For example, if an appointment requires 1 hour of work and the
Emergency Search Timeframe is 360 minutes (6 hours), the
emergency wizard shows only resources who can travel to and
complete the task in the next 7 hours.

Allow Chatter post In an emergency appointment dispatch, the dispatcher is shown

the option to make a custom Chatter post or not post at all. If this
option isn’t selected, no Chatter post is made.

Emergency Chatter Post Destination Choose whether the Chatter post notifying the assigned resource
about the appointment is added to the appointment’s feed or its
parent record’s feed.

Pin After Dispatch Pin the appointment after it is dispatched.

Note: If the Emergency Chatter action is used for an appointment with a scheduling dependency, the dependency isn’t considered
during scheduling.

130
Field Service Lightning Schedule Service Appointments for Field Service

Schedule Higher Priority Appointments over Less Urgent Appointments

Give critical service appointments precedence over lower priority appointments. Scheduling overlaps
EDITIONS
lower priority appointments with services that you specify as high-priority.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
To assign priorities to work orders or work order line items, use the Scheduling Priority field from Experience
the managed package or create a custom priority field. Field values must range from 1 (highest
The Field Service Lightning
priority) to 10 (lowest priority).
core features, managed
Note: The Scheduling Priority field from the managed package uses priorities assigned to package, and mobile app
work orders and work order line items. By default, these priorities are 1 through 4, where 1 is are available in Enterprise,
Critical and 4 is Low. Performance, Unlimited,
and Developer Editions.
1. In the Field Service Admin app, under Field Service Settings > Scheduling > General Logic,
Work orders are also
select the priority field. For example, under Work order priority field, select Scheduling Priority available in Professional
or a custom priority field. Edition.
2. Customize the service appointment page layout, and add the field Schedule over lower
priority appointment.
USER PERMISSIONS

To set up scheduling
priorities and customize the
service appointment page:
• FSL Admin Permissions
custom permission set
To schedule an appointment
over lower priority
appointments: One of these
custom permission sets:
• FSL Admin Permissions
• FSL Agent Permissions
• FSL Dispatcher
Permissions

131
Field Service Lightning Schedule Service Appointments for Field Service

Example: To schedule an urgent break-fix, create a work order and set its priority to 1. Open the related service appointment,
and click Schedule over lower priority appointment. Then, in the dispatcher console, select the critical break-fix
appointment from the appointment list. You can use any of the scheduling actions, such as Book Appointments or get Candidates.
Scheduling ignores lower priority appointments, even if an overlap results. For example, when you click Candidates, the Gantt
shows available time slots, including slots that overlap lower priority appointments. For an appointment with a priority of 2 (High),
scheduling considers slots that overlap appointments with a priority of 3 (Medium), 4 (Low), or a higher value.

When scheduling considers slots for the appointment, it protects already scheduled appointments that have Schedule over
lower priority appointment set.
After scheduling the appointment, resolve any overlaps. You can create a scheduling recipe to fix them, or use Fix Overlaps or In-Day
optimization.
Although optimization doesn’t use Schedule over lower priority appointment, it does consider the priority field.

132
Field Service Lightning Unschedule Service Appointments

Update an Appointment’s Status

You can schedule or unschedule an appointment by updating its status. An appointment’s status
EDITIONS
can be updated from several places in Salesforce.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
From the Gantt The Field Service Lightning
In the Gantt, select one or more appointments whose status you want to change. To select multiple core features, managed
appointments, hold down Command or Control while clicking the appointments. Then, right-click package, and mobile app
your selection, hover over Change status, and select a new status. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
From a Service Appointment Record Work orders are also
Open a service appointment record or click Details on an appointment from the Gantt. From here, available in Professional
you can change the status in two ways: Edition.

• From the Feed tab, click the Change Status Chatter action and select a status. Only status
values that are permitted in your service appointment life cycle settings are shown.
• Manually update the appointment’s Status field. All status values are shown, but the status change works only if it follows your
service appointment life cycle settings.

From a Scheduled Job

The Auto Dispatch scheduled job allows the automatic dispatch of assigned appointments. It changes the status of the chosen
appointments from Scheduled to Dispatched.
To modify this job, from the App Launcher, find and open the Field Service Admin app, and then click Field Service Settings. Then,
click Dispatch > Scheduled Jobs.

Unschedule Service Appointments

Unschedule service appointments from the dispatcher console or a service appointment record.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
When a service appointment is unscheduled, it is removed from the Gantt and its assigned resources Classic and Lightning
are removed. You can unschedule an appointment in the following ways. Experience
• In the dispatcher console appointment list, select one or more appointments. In the mass The Field Service Lightning
actions menu, select Unschedule. core features, managed
• In the Gantt, right-click an appointment and select Unschedule. To select multiple package, and mobile app
appointments, hold down Control or Command while clicking appointments. are available in Enterprise,
Performance, Unlimited,
• From a service appointment detail page, update the Status field to None.
and Developer Editions.
Work orders are also
available in Professional
Edition.

133
Field Service Lightning Reschedule Service Appointments

Reschedule Service Appointments

To reschedule service appointments, use the Book Appointment Chatter action or the Reshuffle
EDITIONS
action in the Gantt.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
To manually reschedule a service appointment, use the Book Appointment Chatter action. Experience
1. Open the parent record—typically a work order or work order line item—of the service The Field Service Lightning
appointment that you want to reschedule. core features, managed
2. In the Chatter feed, select Book Appointment. package, and mobile app
are available in Enterprise,
3. Update the appointment settings as needed.
Performance, Unlimited,
4. Click Get Appointments to view a list of available slots. and Developer Editions.
Work orders are also
5. Select your new appointment window.
available in Professional
To make space in a full schedule for a high-priority appointment, use the Reshuffle action in the Edition.
Gantt. This action postpones lower-priority appointments.
1. Customize your reshuffle preferences. USER PERMISSIONS
a. From the App Launcher, find and open the Field Service Admin app, and then click the
Field Service Settings tab. To reschedule an
appointment: One of these
b. Click Scheduling > Dynamic Gantt. custom permission sets:
c. Under Reshuffle Assignments, define the time period in which lower-priority appointments • FSL Admin Permissions
can be postponed. When appointments are reshuffled, lower-priority appointments are • FSL Agent Permissions
rescheduled during the time period between their Earliest Start Permitted—or the current • FSL Dispatcher
date, if the Earliest Start Permitted has passed—and this many days later. Permissions
d. Save your change.

2. Reshuffle your schedule to accommodate a high-priority appointment.

a. To open the dispatcher console, from the App Launcher, find and open the Field Service app, and then click Field Service.
b. Find the appointment in the appointment list (or on the Gantt, if it’s already scheduled). Right-click the appointment and select
Reshuffle. This action can reschedule or unschedule lower priority appointments and reschedule higher priority appointments
(though not past their due date).

134
Field Service Lightning Fix Scheduling Overlaps

Fix Scheduling Overlaps

If a service appointment overlaps with other appointments or absences, use the Fix Overlaps feature
EDITIONS
to harmoniously reschedule appointments.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Customize Overlap Settings The Field Service Lightning
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field core features, managed
Service Settings tab. Then, click Scheduling > Dynamic Gantt. package, and mobile app
are available in Enterprise,
2. Under Fix Overlaps, configure the following settings. Performance, Unlimited,
and Developer Editions.
Setting Description Work orders are also
available in Professional
Automatically fix overlaps when an appointment If this option is selected, overlaps are
Edition.
overlaps with another appointment or absence automatically fixed whenever an appointment
overlaps with another appointment or an
absence.

When attempting to fix overlaps • Schedule to original resource only:

Assign rescheduled appointments only to
the original assigned resource.
• Schedule to all resources: Consider all
qualified service resources when
rescheduling appointments.

After unscheduling services reschedule them Choose whether unscheduled appointments

by are rescheduled in order of priority or in the
original schedule’s order.

When unable to find a valid schedule for an • Leave on Gantt and set
appointment In-jeopardy: If an appointment can’t
be rescheduled without breaking work rules,
leave the appointment in its original time
slot with an In Jeopardy flag.
• Unschedule the
appointment(s): If an appointment
can’t be rescheduled without breaking work
rules, unschedule the appointment and
remove it from the Gantt.
• Reshuffle other assignments:
If an appointment can’t be rescheduled
without breaking work rules, use the
Reshuffle action. This action reschedules
appointments to favor high-priority
appointments. To learn more, see
Reschedule Service Appointments.

135
Field Service Lightning Group Nearby Appointments

Considerations
• Fix Overlaps respects the original order of scheduled appointments. The earliest appointment remains the earliest and the last
remains last.
• If an appointment is pinned, Fix Overlaps doesn’t reschedule it. However, appointments with a pinned status can be rescheduled.
• Fix Overlaps reschedules appointments only within the given day. If the operation progresses to use the Reshuffle action, appointments
can be rescheduled to another day.
• Fix Overlaps doesn't run on past service appointments.
• Fix Overlaps isn’t supported for capacity-based resources.
• Fix Overlaps doesn't update service appointment status.
• When a service appointment is scheduled by Fix Overlaps, the appointment’s Schedule Mode is set to Automatic.

Group Nearby Appointments

To minimize travel time or gaps between appointments, use the Group Nearby Appointments
EDITIONS
action on a service appointment. This feature unschedules appointments that were scheduled later
that day and replaces them with appointments that are close in location to the source appointment. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience

The Field Service Lightning

Customize Appointment Grouping Settings core features, managed
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field package, and mobile app
Service Settings tab. Then, click Scheduling > Dynamic Gantt. are available in Enterprise,
Performance, Unlimited,
2. Under Group Nearby Appointments, configure the following settings. and Developer Editions.
Work orders are also
Setting Description available in Professional
Edition.
Service Appointment candidate Boolean field Select any standard or custom checkbox field,
including formula fields. This field must be
selected (set to True) for an appointment to be
a candidate in appointment grouping.

Work Order candidate Boolean field Select any standard or custom checkbox field,
including formula fields. If a service
appointment’s parent record is a work order,
this field must be selected (set to True) for the
appointment to be a candidate in appointment
grouping.

Work Order Line Item candidate Boolean field Select any standard or custom checkbox field,
including formula fields. If a service
appointment’s parent record is a work order line
item, this field must be selected (set to True) for
the appointment to be a candidate in
appointment grouping.

Max appointments to schedule When searching for nearby appointments, the

scheduling engine ends its search after finding

136
Field Service Lightning Group Nearby Appointments

Setting Description
this many candidate appointments. The maximum is 50
appointments.

Max runtime (seconds) The scheduling engine spends this many seconds searching for
nearby service appointments. The maximum is 60 seconds. The
search ends after either the max runtime or max appointments to
schedule is reached.

When attempting to schedule the unscheduled service after the • Schedule to original resource only: Assign rescheduled
nearby services appointments only to the original assigned resource.
• Schedule to all resources: Consider all qualified service
resources when rescheduling appointments.

When unable to arrange schedule • Leave on Gantt and set In-jeopardy: If an

appointment can’t be rescheduled without breaking work
rules, leave the appointment in its original time slot with an In
Jeopardy flag.
• Unschedule the appointment(s): If an
appointment can’t be rescheduled without breaking work
rules, unschedule the appointment and remove it from the
Gantt.
• Reshuffle other assignments: If an appointment
can’t be rescheduled without breaking work rules, use the
Reshuffle action. This action reschedules appointments to favor
high-priority appointments. To learn more, see Reschedule
Service Appointments.

Radius for nearby appointments The radius around the originating service appointment, which
determines the number of appointments affected by Group Nearby
Appointments. The distance unit—kilometers or miles—is set on
the Routing tab in the Scheduling section of Field Service Settings.

After customizing your appointment grouping settings, right-click an appointment on the Gantt and select Group Nearby.

Considerations
• In order to run Group Nearby Appointments successfully, service appointments must have the same address as their parent work
order.
• Group Nearby Appointments uses the parent work orders' latitude and longitude values.
• In Group Nearby Appointments, only unscheduled service appointments can be candidates.
• Group Nearby Appointments only schedules appointments within the given day, which is the first day on the Gantt.
• By default, the Is Fill In Candidate field on service appointments, work orders, and work order line items is selected. This means that
all service appointments are considered as candidates when grouping appointments.
• When a service appointment is scheduled by Group Nearby Appointments, the appointment’s Schedule Mode is set to
Automatic.

137
Field Service Lightning Fill Schedule Gaps

Fill Schedule Gaps

To fill gaps in a service resource’s schedule, use the Fill-In Schedule feature. This feature creates a
EDITIONS
list of appointments for a technician and finds the optimal schedule.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Customize Fill-In Schedule Settings The Field Service Lightning
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field core features, managed
Service Settings tab. Then, click Scheduling > Dynamic Gantt. package, and mobile app
are available in Enterprise,
2. Under Fill-In Schedule, configure the following settings. Performance, Unlimited,
and Developer Editions.
Setting Description Work orders are also
available in Professional
Service Appointment Candidate Boolean field Select any standard or custom checkbox field,
Edition.
including formula fields. This field must be
selected (set to True) for an appointment to be
a candidate in fill-in scheduling.

Work Order Candidate Boolean field Select any standard or custom checkbox field,
including formula fields. If a service
appointment’s parent record is a work order,
this field must be selected (set to True) for the
appointment to be a candidate in fill-in
scheduling.

Work Order Line Item Candidate Boolean field Select any standard or custom checkbox field,
including formula fields. If a service
appointment’s parent record is a work order line
item, this field must be selected (set to True) for
the appointment to be a candidate in fill-in
scheduling.

Order candidate appointments by • Priority: Sort candidates based on their

priority field, which is set in Scheduling >
General Logic . Distance is a secondary
consideration.
• Distance: Sort candidates based on their
proximity to the previous appointment, or
if it’s the first appointment of the day, on
their proximity to the technician’s home
base. After an appointment is scheduled, its
location is used to calculate distance. Priority
is a secondary consideration.

Max appointments to schedule When searching for nearby appointments, the

scheduling engine ends its search after finding
this many candidate appointments. The
maximum is 50 appointments.

138
Field Service Lightning Customize Service Appointment Chatter Settings

Setting Description
Max runtime (seconds) The scheduling engine spends this many seconds searching for
nearby service appointments. The maximum is 60 seconds. The
search ends after either the max runtime or max appointments to
schedule be reached.

Considerations
• Fill-In Schedule only schedules appointments for the given day, which is the first day shown on the Gantt.
• By default, the Is Fill In Candidate field on service appointments, work orders, and work order line items is selected. This means that
all service appointments are considered as candidates when filling in a schedule.
You might want to limit which appointments are considered as candidates. For example, perhaps repair appointments require a
phone booking before a technician is sent to the site. To limit candidate appointments, try one of the following approaches.
– Using Process Builder or an Apex trigger, set the value of the Is Fill In Candidate field to False if specified criteria aren’t met.
– Create a checkbox formula field that evaluates whether a record is a candidate. Then, change the three settings that control
which fields are evaluated when searching for candidates so that your custom field is considered instead of Is Fill In Candidate.

• If candidate appointments are sorted by distance, appointments without a geolocation are sorted last.
• Only unscheduled appointments or appointments that are scheduled on a future date are considered as candidates.
• When a service appointment is scheduled by Fill-In Schedule, the appointment’s Schedule Mode is set to Automatic.

Customize Service Appointment Chatter Settings

Control whether custom Gantt Chatter posts, dispatch posts, and emergency posts are shared on
EDITIONS
service appointments or on service appointment parent records.
The Field Service Lightning mobile app’s Feed tab is supported for work orders and work order line Available in: Salesforce
items, but not for service appointments. This means that app users can’t see posts on a service Classic and Lightning
appointment’s feed unless they know to navigate to the appointment from its associated work Experience
order. Posting Chatter posts to the parent record’s feed boosts their visibility for mobile app users.
The Field Service Lightning
core features, managed
This is a Field Service Lightning managed package feature.
package, and mobile app
are available in Enterprise,
Customize Dispatch Chatter Settings Performance, Unlimited,
and Developer Editions.
When an appointment’s status category changes to Dispatched, the assigned resource is notified Work orders are also
in a Chatter post. Control where these messages are posted. available in Professional
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Edition.
Service Settings tab.
2. Click Dispatch > Scheduled Jobs.
3. In the Dispatch Chatter Post Destination field, select Service Appointment Feed (the default option) or Parent Record Feed.
4. Save your changes.

139
Field Service Lightning Dispatch Service Appointments

Customize Emergency Chatter Settings

When a service resource is assigned to an emergency service appointment, they are notified in a Chatter post. Control where these
messages are posted.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Global Actions > Emergency Wizard.
3. In the Emergency Chatter Post Destination field, select Service Appointment Feed (the default option) or Parent Record Feed.
4. Save your changes.

Customize Gantt Chatter Settings

A dispatchers can write a Chatter message for a service appointment from the Gantt by selecting Chatter > Custom message in the
appointment’s action menu. Control where these messages are posted.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Dispatcher Console UI.
3. In the Gantt Chatter Post Destination field, select Service Appointment Feed (the default option) or Parent Record Feed.
4. Save your changes.

Tip: To turn on in-app notifications for mobile app and Lightning Experience users, see Enable Field Service Lightning.

Dispatch Service Appointments

Dispatch scheduled service appointments to your mobile workers. You can dispatch appointments
EDITIONS
from the console, or set up jobs that automatically dispatch or drip feed the next appointments.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Auto-Dispatch Service Resources
Set up scheduled jobs that dispatch your resources auto-magically. The Field Service Lightning
core features, managed
Drip Feed Service Appointments
package, and mobile app
Dispatch appointments to your mobile workers at a steady pace. When your schedule changes are available in Enterprise,
frequently, drip feed helps to prevent confusion because it waits to dispatch another Performance, Unlimited,
appointment until the current one is complete. and Developer Editions.
Work orders are also
available in Professional
Edition.

140
Field Service Lightning Dispatch Service Appointments

Auto-Dispatch Service Resources

Set up scheduled jobs that dispatch your resources auto-magically.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Classic and Lightning
Service Settings tab. Experience
2. Click Dispatch. The Field Service Lightning
3. Optionally, click Drip Feed and set up drip feed dispatching. Drip feed waits and dispatches core features, managed
another appointment after the current appointment is complete. package, and mobile app
are available in Enterprise,
4. Click Scheduled Jobs.
Performance, Unlimited,
a. Select the option to mention assigned resources when they’re dispatched for an and Developer Editions.
appointment. Work orders are also
available in Professional
b. Select the Chatter feed where the mention should appear.
Edition.
c. Edit the provided Auto Dispatch job, or create a new one.
d. Select territories that the job should use in dispatching service resources to appointments. USER PERMISSIONS
The job dispatches resources based on service territory memberships, not territories of
service appointments. A job considers primary and relocation service territory memberships. To set up a job for
dispatching:One of these
e. Create a schedule when the job runs.
custom permission sets:
f. Set filter criteria that selects which service appointments to consider. • FSL Admin Permissions
g. Set a job horizon; that is, the number of days in advance to dispatch. • FSL Dispatcher
Permissions
h. Enter a username that’s notified when the job runs.
Field Service Lightning replaces this username with the corresponding user’s email.
i. Click Save.

5. Optionally, select the job and click Run now.

When the job runs, it changes the status of the dispatched appointments from Scheduled to Dispatched. If you customize statuses
for the service appointment lifecycle, the job changes status from the Service Appointment is tentatively
scheduled setting to the status for the Service appointment is sent to its resource setting.

Example: Create a job that runs daily at 6AM and dispatches resources in Los Angeles for appointments that are In Jeopardy.
The job dispatches resources with a primary or relocation service territory membership of Los Angeles for the selected In Jeopardy
appointments.

141
Field Service Lightning Manage Your Field Service Inventory

Drip Feed Service Appointments

Dispatch appointments to your mobile workers at a steady pace. When your schedule changes
EDITIONS
frequently, drip feed helps to prevent confusion because it waits to dispatch another appointment
until the current one is complete. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field
The Field Service Lightning
Service Settings tab.
core features, managed
2. Click Dispatch. package, and mobile app
3. Click Drip Feed and turn on drip feed dispatching. are available in Enterprise,
Performance, Unlimited,
4. Set the default number of appointments to drip feed. and Developer Editions.
Tip: When you want a service territory to use a different drip feed rate, set the value in Work orders are also
a field on that territory. A drip feed setting on a service territory overrides the default available in Professional
Edition.
value.
For example, if the value is set to two, drip feed tries to maintain two appointments in each
worker’s queue. When the first appointment completes, drip feed dispatches another. USER PERMISSIONS
5. Click Scheduled Jobs, and create a job that dispatches appointments using your drip feed To set up drip feed
settings. dispatching: One of these
All scheduled jobs respect drip feed settings and don’t dispatch more appointments if doing custom permission sets:
so exceeds the drip feed value. If you disable drip feed, edit scheduled jobs so that dispatching • FSL Admin Permissions
works the way you want. • FSL Dispatcher
Permissions

Manage Your Field Service Inventory

Stay on top of the movement of inventory in your field service operation. Learn how to request and
EDITIONS
transfer products, track consumption, and process customer returns.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Common Inventory Management Tasks
Learn how to perform everyday tasks in field service inventory management. The Field Service Lightning
core features, managed
Track Required Inventory
package, and mobile app
If a work order needs to be completed by a carpenter with a hand saw, don’t assign it to an are available in Enterprise,
electrician with a voltmeter! Add products required to work types, work orders, and work order Performance, Unlimited,
line items to ensure that the assigned service resource arrives with the right equipment. and Developer Editions.
Request Inventory Work orders are also
When your stock gets low or you need a part for a particular work order, create a product request. available in Professional
Edition.
Product requests can be associated with work orders, work order line items, cases, and accounts.
You can specify when and where the parts are needed, and divide the request into line items
that each represent a needed part.

142
Field Service Lightning Common Inventory Management Tasks

Transfer Inventory
To fulfill a product request, create a product transfer. Product transfers track the movement of inventory from one field service location
to another. The inventory numbers at your storage locations update automatically to reflect transfers.
Track Inventory Consumption
Create products consumed to track the use or consumption of items from your inventory.
Track Inventory Shipments
To track product items while they’re in transit between locations, create shipments. Shipments contain information about the
products on board, the shipping carrier, and the expected delivery date.
Track Customer Returns
Create return orders to facilitate the return and repair of items that were sold to customers or supplied to field service technicians.

Common Inventory Management Tasks

Learn how to perform everyday tasks in field service inventory management.
EDITIONS
For more detailed step-by-step instructions, refer to the provided links.
Available in: Salesforce
I Want To... How To Do It Example Classic and Lightning
Experience
Track the quantity Create a product item record To track the number of wheelbarrows
of a particular associated with the product and the stored at Warehouse B, create a The Field Service Lightning
product stored at location, and specify the quantity product item whose Location is core features, managed
a particular stored there. Warehouse B and Product is package, and mobile app
location Wheelbarrow. are available in Enterprise,
Helpful links: Performance, Unlimited,
• Create Product Items to Represent and Developer Editions.
Inventory Work orders are also
available in Professional
Find out what’s in Look at the Product Items related list To find out what is stored in Edition.
a particular on the location record. Warehouse A, look at the Product
location’s Helpful links: Items related list on the Warehouse A
inventory location record.
• Create Inventory Locations for
Field Service

Find out the Look at the Product Items related list To learn the number of wheelbarrows
quantity of a on the product record. in your inventory and their locations,
particular part Helpful links: look at the Product Items related list
across all on the Wheelbarrow product record.
inventory • Create Product Items to Represent
locations Inventory

Review changes Look at the Product Item Transactions To review the use, transfer, and
to the stock of a related list on the product item. restock of extra-large bolts at
particular product Helpful links: Warehouse C, look at the Product Item
at a particular Transactions related list on the
location • Guidelines for Transferring product item whose Product is
Inventory Extra-Large Bolt and Location is
Warehouse C.

143
Field Service Lightning Common Inventory Management Tasks

I Want To... How To Do It Example

Specify that a certain part Create a record in the Products Required related list To let the assigned technicians know that they need
is needed to complete a on the work order. a forklift to complete work order #00046982, create
work order Helpful links: a product required for the Forklift product on the
work order.
• Track Required Inventory

Request more parts from Create a product request to indicate what’s needed. To request a restocking of 20 boxes of nails and 10
another inventory Create a product request line item for each product hammers for your service vehicle, Van A, create a
location when my stock requested. product request for the Van A location. Include one
gets low Helpful links: product request line item for the nails, and another
for the hammers.
• Request Inventory

Transfer parts between 1. Create a product transfer. Make sure to specify To transfer 25 tires from Warehouse A to Warehouse
inventory locations the quantity, source location, destination B, create a product transfer with these settings:
location, and source product item (which • Source Location: Warehouse A
represents the stock that the items are being • Source Product Item: Warehouse A Tires
transferred from).
• Destination Location: Warehouse B
2. Create a shipment to track the transfer’s shipping • Quantity: 25
details.
• Quantity Unit of Measure: Each
3. Mark the product transfer received when the
Create a shipment to track the shipping details for
items arrive.
the tire transfer.
Helpful links:
Select Received on the product transfer when the
• Transfer Inventory tires arrive at Warehouse B.
• Guidelines for Transferring Inventory

Transfer parts from an 1. Create a product request, listing the outside To transfer 20 safety glasses from your safety
outside vendor to an vendor as the account. equipment provider to Service Van A, create a
inventory location product request that lists your outside vendor as the
2. Create a product transfer. Make sure to specify Account. Then, create a product transfer with these
the quantity, destination location, and product. settings:
3. Create a shipment to track the transfer’s shipping • Product: Safety Glasses
details.
• Destination Location: Service Van A
4. Mark the product transfer received when the
• Quantity: 20
items arrive.
• Quantity Unit of Measure: Each
Helpful links:
Because the items are coming from outside of your
• Request Inventory inventory, leave the Source Location and Source
• Transfer Inventory Product Item blank.
• Guidelines for Transferring Inventory Create a shipment to track the shipping details for
the glasses transfer.
Select Received on the product transfer when the
glasses arrive at Service Van A.

144
Field Service Lightning Common Inventory Management Tasks

I Want To... How To Do It Example

Indicate that parts from Create a product consumed record on the related You used 15 bolts from your service van, Service Van
your inventory were work order. A, to complete work order #00046982. To track the
consumed while Helpful links: consumption, create a product consumed record on
completing a work order the work order with these settings:
• Track Inventory Consumption
• Product Item: Service Van A Bolts
• Guidelines for Consuming Inventory
• Quantity Consumed: 15
The product item quantity is automatically reduced
by 15 to reflect that the bolts are no longer in stock.

Track the return of a Create a return order that lists the related case, order, A customer creates a case from the customer
customer product or product. community to return a glass door. To track the return,
Helpful links: create a return order which lists the related Order.
Add a return order line item that lists the
• Track Customer Returns corresponding Order Product for the glass door.
• Guidelines for Tracking Customer Returns
Create a product transfer to track the return of the
product to the warehouse. Upon its arrival, increase
the quantity on the glass door product item by 1.

Track the repair of a 1. Create a work order to repair the product. A customer calls your company to request a repair
customer product of their front gate. Create a work order, and then
2. Create a return order that tracks the return of the create an associated return order that tracks the
product to the repair workshop. return of the gate to the workshop.
3. When the product is repaired, create a product After the gate is repaired, mark the work order
transfer to track the return of the product back complete. Create a product transfer to track the return
to the customer. of the gate from the workshop to the customer.
Helpful links:
• Track Customer Returns
• Guidelines for Tracking Customer Returns

Track the return of Create a return order that lists the unused inventory To prepare for an on-site installation appointment,
unused inventory from in the Product or Product Item field. create a product request for three motors. Upon
my stock back to the Helpful links: arriving at the site, you learn that only two motors
warehouse are needed. To return the unwanted motor to the
• Track Customer Returns main warehouse, create a return order with one line
• Guidelines for Tracking Customer Returns item that lists the motor in the Product field.
After the motor is returned to the warehouse,
increase the quantity of the motor product item by
1.

145
Field Service Lightning Track Required Inventory

Track Required Inventory

If a work order needs to be completed by a carpenter with a hand saw, don’t assign it to an electrician
EDITIONS
with a voltmeter! Add products required to work types, work orders, and work order line items to
ensure that the assigned service resource arrives with the right equipment. Available in: Salesforce
Adding required products to work types saves you time and keeps your business processes consistent. Classic and Lightning
Work orders and work order line items inherit their work type’s required products. Experience

For example, if all light bulb replacement jobs require a ladder and a light bulb, add the ladder and The Field Service Lightning
light bulb as required products to your Light Bulb Replacement work type. When it’s time to create core features, managed
a work order for a customer’s light bulb replacement, applying that work type to the work order package, and mobile app
adds the required products. are available in Enterprise,
Performance, Unlimited,
Here’s how to add a required product to a work order, work order line item, or work type.
and Developer Editions.
1. Navigate to the record that needs required products. Work orders are also
2. In the Products Required related list, click New. available in Professional
Edition.
3. Use the lookup field to select a product.
4. Enter the quantity required.
USER PERMISSIONS
5. Select a quantity unit of measure.
To view products required:
6. Click Save.
• Read on the parent
object (work orders or
work types) AND Read
on products
To create, update, or delete
products required on work
orders or work order line
items:
• Edit on work orders AND
Read on products
To create, update, or delete
products required on work
types:
• Edit on work types AND
Read on products

146
Field Service Lightning Request Inventory

Request Inventory
When your stock gets low or you need a part for a particular work order, create a product request.
EDITIONS
Product requests can be associated with work orders, work order line items, cases, and accounts.
You can specify when and where the parts are needed, and divide the request into line items that Available in: Salesforce
each represent a needed part. Classic and Lightning
Mobile workers can create product requests when they find defective parts in their vehicles or their Experience
stock has run out. Dispatchers or service managers can create product requests on behalf of their
The Field Service Lightning
technicians if they see their stock getting low. And schedulers can create product requests when core features, managed
they schedule work orders that require parts which aren’t normally found in a technician’s vehicle package, and mobile app
stock. are available in Enterprise,
1. From the Product Requests tab or the Product Requests related list on a work order or work Performance, Unlimited,
order line item, click New. and Developer Editions.
Work orders are also
2. If the request is being made for a particular job, select the related work order or work order line available in Professional
item. Edition.
3. Optionally, select the related account or case.
4. Enter the destination location, which is where the parts are needed. USER PERMISSIONS
Tip: Service vehicles can also be locations. Mobile locations like vehicles have Mobile To create product requests:
Location selected on their detail page. • Create on product
requests
5. Enter the address where the parts should be shipped; for example, the mailing address of the
warehouse that is requesting them. To view product request line
items:
6. Select a shipment speed, and enter the Need By Date. • Read on product
7. If the parts are being transferred from another location such as a warehouse, enter the source requests
location. To create, update, or delete
product request line items:
8. Add a description.
• Edit on product requests
9. Assign the product request a status:
• Draft: Finalizing the product request details.
• Submitted: The product request is ready for processing.
• Received: The department in charge of fulfilling the request is working on it.

10. Save your changes.

11. Create one product request line item for each product needed.
a. From the Product Request Line Items related list, click New.
b. Select the product that is needed, and enter a quantity and unit of measure. These values are inherited from the Quantity Unit
of Measure field on products.
c. Fill in the rest of the fields as needed. The parent product request’s shipping and related record information is auto-populated
on its line items.
d. Save your changes.

The product request now appears in the Product Requests related list on the related work order or work order line item. You can also
view and sort line items from all product requests from the Product Request Line Items tab in Salesforce.

147
Field Service Lightning Transfer Inventory

Transfer Inventory
To fulfill a product request, create a product transfer. Product transfers track the movement of
EDITIONS
inventory from one field service location to another. The inventory numbers at your storage locations
update automatically to reflect transfers. Available in: Salesforce
Note: To allow the creation of product transfers for serialized product items (a beta Classic and Lightning
Experience
functionality), contact Salesforce.
Create one product transfer for each product request line item so you can track the status of each The Field Service Lightning
part being requested. The Product Transfers related list on a product request shows all product core features, managed
transfers associated with the request’s line items. In addition, product request line items have their package, and mobile app
own Product Transfers related list that shows related transfers. are available in Enterprise,
Performance, Unlimited,
While product transfers are typically created in response to a product request, they don’t have to and Developer Editions.
be. For example, when a new technician joins your team, you can create a series of product transfers Work orders are also
to track the initial stocking of their service vehicle. available in Professional
1. From the Product Transfers tab or the Product Transfers related list on a product request, product Edition.
request line item, product item, location, or shipment, click New.
2. Enter a source product item or product. USER PERMISSIONS
• If the parts are being transferred from a location within your inventory, such as a warehouse, To create product transfers
enter a source product item. The source product item shows where the parts are being for field service:
transferred from, and updates the quantity at the source location. For example, if you need • Create on product
five hammers to be transferred from Warehouse A to Warehouse B, select the product item transfers
record that tracks the hammers stored at Warehouse A. To mark product transfers
• If the products are being transferred from outside your inventory—for example, if they’re received:
being ordered from a manufacturer—enter a product name. • Edit on product items

3. Enter the quantity being transferred and the Quantity Unit of Measure. Quantity Unit of Measure
picklist values are inherited from the Quantity Unit of Measure field on products.
4. If it’s not already populated, enter the related product request line item.

Tip: Set the status of the related product request line item to Received to indicate that the request is being processed.

5. Use the lookup field to select the shipment on which the product items are being transferred.
6. Enter the destination location, and if applicable, the source location.
7. Enter the expected pickup date.
8. Add a description.
9. After the transferred parts are received, select Received and update the following fields:
• Received By
• Quantity Received
• Status
Once you mark a product transfer received, you can’t undo it.

10. Save your changes.

When a product transfer is marked received, several records are updated or created to keep your inventory numbers accurate. To learn
more, see Guidelines for Transferring Inventory.

148
Field Service Lightning Transfer Inventory

IN THIS SECTION:
Guidelines for Transferring Inventory
Product transfers track the transfer of inventory between locations in field service. Learn how to link product transfers to other
inventory management records, and how they can help you manage inventory in your field service operation.

Guidelines for Transferring Inventory

Product transfers track the transfer of inventory between locations in field service. Learn how to
EDITIONS
link product transfers to other inventory management records, and how they can help you manage
inventory in your field service operation. Available in: Salesforce
Classic and Lightning
Associate Product Transfers with Product Requests Experience

While product transfers are typically created in response to a product request, they don’t have to The Field Service Lightning
be. For example, when a new technician joins your team, you can create a series of product transfers core features, managed
to track the initial stocking of their service vehicle. package, and mobile app
are available in Enterprise,
If the product transfer is fulfilling a product request, create one product transfer for each product Performance, Unlimited,
request line item. This way, you can track the status of each part being requested. The Product and Developer Editions.
Transfers related list on a product request lists all product transfers associated with the request’s Work orders are also
line items. In addition, product request line items have their own Product Transfers related list that available in Professional
shows related transfers. Edition.

Associate Product Transfers with Shipments

To get more visibility into the movement of inventory between locations, create shipments and link them to product transfers. Shipments
contain information about the products on board, the shipping carrier, and the expected delivery date. While shipments are an optional
part of inventory management, they make it easier to stay informed about the coming and going of parts in your inventory.
For example, you create a product request for 50 hammers and 40 boxes of nails at Warehouse C. The product request has two line
items: one for the hammers, and one for the nails. To fulfill the request, your inventory manager creates two product transfers—one for
each line item—that indicate that the hammers and nails should be transferred from Warehouse B. Then, the manager creates a shipment
to track the transfer and enters it in the Shipment field on both product transfers. Now, anyone looking at the product request can see
the related product transfers. They can refer to the related shipment to track the hammers and nails on their inter-warehouse journey.
A shipment can be associated with multiple product transfers, shown in the Product Transfers related list. A shipment’s product transfers
can each be related to different product request line items from one or more product requests.

Update or Delete Product Transfers

If a product transfer hasn’t yet been marked received, you can edit it normally. Received transfers cannot be updated, but you can delete
them if needed. When you delete a transfer:
• The Quantity on Hand of the source and destination product items reverts to the pre-transfer quantity
• Product item transactions with a transaction type of Adjusted are added to the source and destination product items

Transfer Serialized Inventory

For higher-value inventory such as computers, you may decide to create one product item record per item. This lets you record each
item’s serial number on the product item record and track the item’s movement.

149
Field Service Lightning Transfer Inventory

The creation of product transfers for serialized product items is in beta, and is only permitted if you enroll in the beta program. When a
product transfer for a serialized product item is marked received, the product item’s location automatically updates to reflect the transfer.
This functionality has the following limitations:
• The Location field on serialized product items can’t be updated manually.
• When a product transfer associated with a serialized product item is marked received, no product item transaction is created.
• Partial transfers of serialized product items aren’t permitted. A product transfer whose source product item is serialized can be marked
received only if the product transfer’s Quantity Sent and Quantity Received are equal to the product item’s Quantity On Hand.

Mark Product Transfers Received

Selecting Received on a product transfer indicates that the items have been added to the inventory at their destination location. Marking
a product transfer prompts the following actions.
• Product items are updated or created. Product items track the quantity of a particular product at a particular location—for
example, a product item can represent all the hammers at Warehouse A. When a product is transferred from one location to another,
the quantity of the source location product item is reduced to reflect the transfer. In addition, one of two things happens:
– If there’s already a product item that represents the transferred products stored at the destination location, the quantity of that
product item is increased to reflect the transfer.
– If such a product item doesn’t exist (in other words, if it’s the first time that the product is being stored at the location), a product
item is automatically created that reflects the quantity transferred there.
For example, if Service Van B has never contained any hammers, there isn’t a product item record representing the hammers stored
at Service Van B. When hammers are transferred to Service Van B, a product item is created whose quantity reflects the number of
hammers transferred there.
• Product item transactions are created. When you mark a transfer received, a product item transaction with a type of “Transferred”
is created to represent the addition of stock at the destination location. If a source location or source product item is specified, a
second transaction is created to represent the removal of stock from the source location. The first transaction’s quantity is positive
because stock is being added; the second transaction’s quantity is negative. These transactions appear in the Product Item Transactions
related list on the related product transfer, source product item, and destination product item. They let you quickly review past
transactions at your inventory locations.

Example: Warehouse A has 100 hammers in stock. Your new technician, Jessica, has received her service van, and you’ve created
a location to represent the van in Salesforce. You create a product transfer to track the transfer of five hammers from Warehouse
A to Jessica’s van. Since Jessica’s van hasn’t contained hammers before, selecting Received on the transfer causes the following
events.
• The quantity on the existing product item for hammers stored at Warehouse A is reduced from 100 to 95
• A second product item is created with these settings:
– Product: Hammer
– Quantity: 5
– Location: Jessica’s Van

• A product item transaction is created for the hammer product item with a transaction type of Transferred and a quantity of 5

150
Field Service Lightning Track Inventory Consumption

Track Inventory Consumption

Create products consumed to track the use or consumption of items from your inventory.
EDITIONS
When an item leaves your inventory because it was used during a field service appointment, create
a product consumed record so your inventory numbers are adjusted accordingly. You can add Available in: Salesforce
products consumed to work orders or work order line items. Track product consumption at the line Classic and Lightning
item level if you want to know which products were used for each line item’s tasks. Experience

1. In the Products Consumed related list on a work order or work order line item, click New. The Field Service Lightning
2. If applicable, enter a work order line item. The work order is auto-populated. core features, managed
package, and mobile app
3. In the Product Item field, select the product item where the part originated. For example, if 10 are available in Enterprise,
bolts that were stored in Warehouse B were used to complete the work order, select the product Performance, Unlimited,
item that represents all bolts stored in Warehouse B. and Developer Editions.
4. Enter the quantity consumed. Work orders are also
available in Professional
5. To link the consumed product to a price book entry, select a price book entry and enter the Edition.
unit price.

Note: To create a product consumed that lists a price book entry, you need “Use” sharing USER PERMISSIONS
access to price books.
To view products consumed:
6. Add context in the Description field. • Read on work orders
7. Save your changes. To create or delete products
consumed:
Tip: After a product item is consumed, track it as an asset (an installed or purchased product) • Edit on work orders AND
and add product details like a serial number. Read on product items
To update products
IN THIS SECTION: consumed:
• Edit on work orders
Guidelines for Consuming Inventory
When inventory is consumed as part of a work order, logging the consumption kicks off several
behind-the-scenes changes. Learn how product consumption fits into your field service
operation.

Guidelines for Consuming Inventory

When inventory is consumed as part of a work order, logging the consumption kicks off several
EDITIONS
behind-the-scenes changes. Learn how product consumption fits into your field service operation.
Available in: Salesforce
Track Product Consumption Classic and Lightning
Experience
When a technician uses a product during a field visit, they can create a product consumed record
from the Products Consumed related list on the related work order or work order line item. For The Field Service Lightning
example, a work order can have one product consumed record representing the consumption of core features, managed
10 bolts, and another representing the consumption of two batteries. Products consumed are package, and mobile app
typically associated with a product item that represents where the item was stored before use. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

151
Field Service Lightning Track Inventory Shipments

Why to Track Product Consumption

Track product consumption so you know when and why items from your inventory are used and when your stock is running low. When
you create a product consumed record on a work order or work order line item, the quantity listed on the related product item updates
to reflect the consumption.
For example, suppose you have a product item representing the bolts stored in your service van. You use 10 bolts to complete a work
order, so you create a product consumed record on the work order to track the consumed bolts. Creating the product consumed reduces
the quantity of the product item representing bolts in your van by 10.

Note: If you want to track product consumption but don’t need to track the movement of inventory between locations, you can
skip creating locations and product items. Instead, complete the Price Book Entry field on product consumed records to indicate
which product was consumed. However, this approach offers a limited view of your inventory.

Viewing Updates to Product Consumed Records

Product item transactions are auto-generated records that summarize changes made to product items in your org. They appear in the
Product Item Transactions related list on related records. Most actions on products consumed create a product item transaction.
• Creating a product consumed: A product item transaction is created on the product item with a type of Consumed and a negative
quantity equal to the quantity consumed. Because access to product item transactions is determined by product item access, you
need permission to view product items before you can create products consumed.
• Changing the quantity on a product consumed: You may need to change the quantity on a product consumed to indicate that
fewer or more items were consumed. In this case, a product item transaction is created with a type of Adjusted and a negative
quantity equal to the additional quantity consumed. For example, if a technician updates a product consumed to indicate that two
more bolts were used, the new product item transaction’s quantity would be –2.
• Deleting a product consumed: Deleting a product consumed is considered an adjustment. A product item transaction of type
Adjusted is created with a positive quantity equal to the quantity consumed.

Track Inventory Shipments

To track product items while they’re in transit between locations, create shipments. Shipments
EDITIONS
contain information about the products on board, the shipping carrier, and the expected delivery
date. Available in: Salesforce
Link shipments to product transfers so your team always knows the status of part transfers. While Classic and Lightning
shipments are an optional feature, they help you stay informed about the coming and going of Experience
items in your inventory.
The Field Service Lightning
1. From the Shipments tab, click New. core features, managed
package, and mobile app
2. In the General Information section, add details about the shipment’s origin and destination. If
are available in Enterprise,
applicable, select the field service locations where the shipment departs or arrives.
Performance, Unlimited,
3. In the Tracking Information section, add details about the shipping provider and delivery date. and Developer Editions.
4. Add a description explaining what is being shipped. Work orders are also
available in Professional
5. Save your changes. Edition.
6. From the Product Transfers related list, create product transfers to track the movement of
product items that were included in the shipment.
USER PERMISSIONS

To create shipments:
• Create on shipments

152
Field Service Lightning Track Customer Returns

Track Customer Returns

Create return orders to facilitate the return and repair of items that were sold to customers or supplied
EDITIONS
to field service technicians.
1. From the Return Orders tab or the Return Orders related list on a record, click New. Available in: Salesforce
Classic and Lightning
2. Enter an account and contact associated with the return order.
Experience
3. Enter an associated product request. For example, if a technician is returning an unused item,
select the related product request that the product was intended to fulfill. The Field Service Lightning
core features, managed
4. In the Returned By field, select the user returning the items. package, and mobile app
5. Enter a source and destination location, if applicable. For example, if the return order tracks the are available in Enterprise,
return of products from a customer’s facility to your main warehouse, select the warehouse as Performance, Unlimited,
your destination location. and Developer Editions.
Work orders are also
6. Enter a shipment type, address, and the date the returned products are expected to arrive at available in Professional
the destination location. The Ship From Address represents the location of the items at the start Edition.
of the return or repair. For example, if a customer is returning an item, enter the customer’s
address.
USER PERMISSIONS
7. Add notes or context about the return in the Description field.
8. Save your changes. To create return orders:
• Create on return orders
9. In the Return Order Line Items related list, add a line item for each product being returned.
To view return order line
a. Click New. items:
b. To represent the items being returned, fill out one of more of the following fields: Asset, • Read on return orders
Order Product, Product, Product Item, and Product Request Line Item. To create, update, or delete
return order line items:
Tip: If you enter a product item, select the product item associated with the source • Edit on return orders
location of the returned items.

c. Enter a quantity and unit of measure. If a product or product item is selected, the unit of
measure is autopopulated.
d. Select a reason for the return.
e. In the Processing Plan field, indicate what should happen to the returned item.
f. In the Repayment Method field, indicate how the owner should be reimbursed for the return. If the return order is tracking the
return of items from van stock to an inventory location, you’ll probably leave this field blank.
g. If needed, update the source and destination location. These are inherited from the return order, but can be updated.
h. Add notes or context about the returned items in the Description field.
i. Save your changes.

IN THIS SECTION:
Guidelines for Tracking Customer Returns
You can use return orders to track customer returns, customer repairs, or the return of inventory from a technician’s van stock to a
warehouse or supplier. Learn about common return scenarios and how to log them in Salesforce.

153
Field Service Lightning Track Customer Returns

Guidelines for Tracking Customer Returns

You can use return orders to track customer returns, customer repairs, or the return of inventory
EDITIONS
from a technician’s van stock to a warehouse or supplier. Learn about common return scenarios
and how to log them in Salesforce. Available in: Salesforce
Return orders are available in Lightning Experience, Salesforce Classic, the Salesforce mobile app, Classic and Lightning
the Field Service Lightning mobile app for Android and iOS, and communities built using Salesforce Experience
Tabs + Visualforce. Customers can initiate a return from a community, or agents can create return
The Field Service Lightning
orders in response to a customer call or technician request. core features, managed
package, and mobile app
Create Return Orders are available in Enterprise,
Performance, Unlimited,
Create return orders from the Return Orders tab or the Return Orders related list on accounts, and Developer Editions.
contacts, product requests, cases, orders, or locations. Work orders are also
You can associate return orders with product requests, cases, accounts, contacts, orders, work orders, available in Professional
and more. This versatility lets you use return orders to track a wide range of return scenarios. It’s up Edition.
to you to decide how return orders fit into your field service processes. For example, to minimize
processing time, don’t associate return orders with product transfers.
When you create a return order, add return order line items to track the specific items being returned or repaired. Each line item must
list one or more of the following: product, product item, asset, product request line item, and order product. If you select more than one
of these fields on a return order line item, make sure they all link to the same product.

Common Return Order Scenarios

Customer Returns
When a customer wants to return a product, create a return order. Follow these guidelines.
• On the return order:
– If a customer case was created to address the return, select it in the Case field.
– In the Source Location field, select the customer’s site where the product is located at the start of the return. You may need
to leave this field blank if the customer’s site isn’t tracked as a location in Salesforce.
– In the Destination Location field, select the inventory location where the item is returned for restocking, or the workshop
where the item is salvaged or discarded.
– In the Ship From address, enter the customer’s address where the product is at the start of the return.

• On the return order line item:

– To represent the items being returned, fill out one or more of the following fields: product, product item, product request
line item, and order product. For customer returns, you’ll likely use the Asset or Order Product fields.

For example, a customer of a hypothetical robotic arms company, Rockin’ Robotics, purchased a small hydraulic arm by mistake. To
return it, they create a case from the customer community. The assigned agent creates a return order for the customer which lists
the related order and order product. The agent then creates a product transfer to track the return of the arm to the warehouse. Upon
its arrival, the on-site technician updates the quantity on the appropriate product item to indicate that the warehouse has gained
a small hydraulic arm.
Customer Repairs
When a customer wants their product repaired or retrofitted, use a return order to track the repair and return of the product. Follow
these guidelines.
• On the return order:

154
Field Service Lightning Track Customer Returns

– Link the return order to related work orders in the Work Orders or Work Order Line Items related lists. Most repairs involve
a work order that was created for the customer.
– If a customer case was created to address the repair, select it in the Case field
– In the Source Location field, select the customer’s site where the product is at the start of the return. You may leave this field
blank if the customer’s site isn’t tracked as a location in Salesforce.
– In the Ship From address, enter the customer’s address where the product is at the start of the return.
– In the Destination Location field, select the workshop where the product is repaired. You can use product transfers to track
the movement of the product to and from the workshop.

• On the return order line items:

– In the Repayment Method field, if the item will be returned to the customer after repair, select Return.
– To represent the items being repaired, fill out one or more of the following fields: product, product item, product request
line item, and order product. For customer repairs, you’ll likely use the Asset or Order Product fields.

For example, a Rockin’ Robotics customer wants their eight-year-old hydraulic arm retrofitted to use the most current technology.
They call Rockin’ Robotics and the support agent creates a work order to have the arm retrofitted. The agent then associates the
work order with a return order that tracks the return of the arm to the Rockin’ Robotics Workshop. After the arm is retrofitted, the
work order is marked complete and a product transfer is created to track the return of the arm from the workshop to the satisfied
customer.
Technician Returns
When a product is requested for a field service job but ends up going unused for any reason, use a return order to track the return
of the product to the supplier or an inventory location. Follow these guidelines.
• On the return order:
– In the Product Request field, select the product request that the product was intended to fulfill. You can also associate the
return order line items with the product request’s line items.
– In the Account field, select the account that the product was intended for.
– In the Source Location field, select the product’s location at the time of the creation of the return order. For example, a
technician’s service vehicle.
– In the Destination Location field, select the product’s intended destination. For example, an inventory location such as a
warehouse, or a supplier’s site.
– In the Ship From address, enter the starting address of the return.

• On the return order line items:

– If the return order lists a product request, select the relevant product request line item in the Product Request Line Item field.
– If the return doesn’t involve reimbursement (which is likely), set the Repayment Method to None.
– In the Processing Plan field, select Restock if the item is returning to your inventory
– To represent the items being returned, fill out one or more of the following fields: product, product item, product request
line item, and order product. For technician returns, you’ll likely use the Product Request Line Item, Product, or Product Item
fields. If you select a product item, choose the product item that is associated with the product’s source location.

• If needed, create an associated product transfer to track the transfer of the product from its current location back to your inventory.
For example, to prepare for an on-site installation appointment, a Rockin’ Robotics technician creates a product request for three
large hydraulic arms. Upon arriving at the site, the technician learns that only two arms are needed. To return the unwanted arm to
the main warehouse, the technician creates a return order with one line item that lists the arm in the Product field. After the arm is
returned to the warehouse, the warehouse product item can be updated to reflect the change in inventory numbers.

155
Field Service Lightning Manage Service Reports

Note: While you can track the return of products to your inventory using only a product transfer, return orders let you add
information about why the product is being returned.

Manage Service Reports

Make your customers happy with service reports delivered to their inboxes. Technicians and
EDITIONS
dispatchers can create reports for work orders, work order line items, or service appointments and
email them directly to the customer. Use standard templates or create variations of your own. Available in: Salesforce
Classic and Lightning
IN THIS SECTION: Experience

Create Service Report Templates The Field Service Lightning

A service report is a PDF that summarizes a work order or service appointment that your core features, managed
customers and team members can sign. To control what shows up in your service reports, package, and mobile app
create service report templates. are available in Enterprise,
Performance, Unlimited,
Create Service Reports and Developer Editions.
Create service reports to give your customers summaries of the work that your field service Work orders are also
team performed. available in Professional
Edition.

Create Service Report Templates

A service report is a PDF that summarizes a work order or service appointment that your customers
EDITIONS
and team members can sign. To control what shows up in your service reports, create service report
templates. Available in: Salesforce
Users generate a service report for a record by clicking Create Service Report on the record. A Classic and Lightning
record’s service reports appear in the Service Report related list. If you assign a template to a work Experience
order, work order line item, or work type using the Service Report Template lookup field, the record’s
The Field Service Lightning
service reports always use that template. If a record doesn’t list a service report template, users are core features, managed
prompted to select from a list of active templates when they create a service report. package, and mobile app
Important: To avoid errors when service reports are generated, don't deactivate the default are available in Enterprise,
Performance, Unlimited,
service report template.
and Developer Editions.
There is an issue with service report templates when they are saved in IE: the header can Work orders are also
overlap the body in reports generated from these templates. Use Chrome or Firefox to save available in Professional
service report templates instead. Edition.

1. If you want your team to collect signatures on service reports using the Field Service Lightning
mobile app, create picklist values for the Signature Type field on digital signatures. Signature USER PERMISSIONS
types represent the role of the person signing a report.
To edit page layouts and
a. Navigate to the Setup page. picklist values:
• In Salesforce Classic, from Setup, enter Digital Signatures in the Quick Find • Customize Application
box, then select Fields under Digital Signatures. To create service report
templates:
• In Lightning Experience, go to Digital Signature in the Object Manager, then click Fields
• View Setup and
and Relationships.
Configuration
b. Click Signature Type.

156
Field Service Lightning Create Service Report Templates

c. From the Signature Type Picklist Values related list, add up to 1,000 values to the picklist. For tips on creating signature types,
see Guidelines for Using Signatures on Service Reports.

2. Add the Create Service Report button to page layouts for the following objects:
• Work orders
• Work order line items
• Service appointments

3. Create a service report template.

a. From Setup, enter Service Report in the Quick Find box, then click Service Report Templates under Field Service.
b. Click New, or click Edit next to a report template you’d like to adjust. You already have one active template named Standard.
c. If you are creating a template, select an existing template as its base and give it a name.
d. In the Related Templates dropdown menu at the top of the template editor, select a sub-template.

Each template comes with four sub-templates, which allow it to be used for service reports on multiple types of records:
• Service Appointment for Work Order
• Service Appointment for Work Order Line Item
• Work Order
• Work Order Line Item
The Related Templates field shows the sub-template that you’re currently editing. We recommend customizing all four
sub-templates for each template so you’re confident that your service reports contain the right information. Save your changes
after you modify each sub-template.

e. Drag fields, sections, and related lists onto your layout.

f. Click Save.

Note: When you preview the report template, it shows the System Administrator profile view. The data shown is simulated,
except for images and rich text. If the person creating the service report doesn’t have Read permission on objects or fields
in the service report template, those fields don’t appear on the report they create.

g. (Recommended) Select a new sub-template in the Related Templates field, and customize its layout. Repeat until you’ve reviewed
the layout of all four sub-templates.
h. Click Activate next to the template name on the Service Report Templates home page.

IN THIS SECTION:
Guidelines for Creating Service Report Templates
Service report templates in field service determine the type and order of data in service reports. Learn how to customize your service
report templates to suit your needs.
Guidelines for Using Signatures on Service Reports
Field service technicians can capture signatures from customers and partners on service reports. On the service report template, you
define the number and type of signatures allowed.

157
Field Service Lightning Create Service Report Templates

Guidelines for Creating Service Report Templates

Service report templates in field service determine the type and order of data in service reports.
EDITIONS
Learn how to customize your service report templates to suit your needs.
Available in: Salesforce
Adding Fields Classic and Lightning
Experience
Service reports can contain fields from multiple objects. To add a field, select the object in the
top-left section of the editor, then locate and drag the field onto your layout. The Field Service Lightning
core features, managed
Use the Section element to organize fields on your layout. Your template comes with several default package, and mobile app
sections, which you can modify, rename, or delete. Click the wrench icon in a section to change are available in Enterprise,
the number of columns, edit or hide the title, and more. Performance, Unlimited,
and Developer Editions.
Work orders are also
Adding Related Lists
available in Professional
To add a related list to your template, drag the List element onto the layout. Enter a title, select the Edition.
object, and select fields to display in the related list.
Filter a Related List
To hide unwanted records from a related list on generated service reports, create a filter. For example, filter the Work Order Line
Items related list on work order service reports so it only shows completed line items.
Related list filters on service report templates work just like regular list view filters. You can create up to five filters per related list.
1. From the service report template editor, check the Related Templates field to make sure that you’re editing the desired
sub-template.
2. On the related list you want to filter, click the wrench icon and select the Filters tab.
3. To define the filter, select a checkbox or picklist field, and choose an operator.
4. To select one or more values click the lookup icon, or enter values manually, separated by commas. Only records that list a
selected value in the filter field appear in service reports that use the template. (Deactivated picklist values don’t appear in the
lookup, but you can enter them manually.)
5. Click OK and save your changes. The filter you created is reflected in service reports that use your template.

Note:
• The Status field on contract line items isn’t available for filtering.
• The Filters tab isn’t available in Internet Explorer 8.
• If the user generating the service report doesn’t have access to a field used to filter the related list, the filtering doesn’t
occur.

Sort a Related List

To customize the order of records in a related list, sort the list by any number or date field. For example, order the records in the
Work Order Line Items related list from earliest to latest completion date.
1. From the service report template editor, check the Related Templates field to make sure that you’re editing the desired
sub-template.
2. On the related list you want to filter, click the wrench icon and select the Sorting tab.
3. Select a field to sort by, and choose ascending or descending order.
4. Click OK and save your changes. The sorting logic you added is reflected in service reports that use your template.

158
Field Service Lightning Create Service Report Templates

Note: If the user generating the service report doesn’t have access to the field used to sort the related list, the sorting doesn’t
occur.

Adding Signatures
To let technicians collect signatures on a service report, drag the Signature element onto your layout. You can add up to 20 signature
blocks to a sub-template. Every signature block needs a different signature type. To learn more about signatures, see Guidelines for Using
Signatures on Service Reports.

Adding Other Design Elements

• To add your company logo to service reports, drag the Text/Image Field element onto the layout and upload your logo. A 220-px
wide logo is optimal, wider images are cropped. If the uploaded logo is wider than 220 px, resize the image by dragging its sizing
hands in the Text/Image Field element. Images can be added to the header, footer, and body of a service report template.
• To customize the footer and add page numbers, click the wrench icon in the footer section. For example, add the Work Order Number
field.
• To add space between fields or sections in the template, use the Blank Space field. Each Blank Space field adds 5 pixels of vertical
space to the report PDF.

Guidelines for Using Signatures on Service Reports

Field service technicians can capture signatures from customers and partners on service reports.
EDITIONS
On the service report template, you define the number and type of signatures allowed.
Available in: Salesforce
Set Up Signature Types Classic and Lightning
Experience
The Signature Type field specifies the role of the person signing a service report. The type ensures
that the right person signs your service reports. The Field Service Lightning
core features, managed
For example, when your company performs preventive maintenance, you want both the customer package, and mobile app
and the technician to sign the final service report. The signatures confirm that both parties agree are available in Enterprise,
on the work that was completed. Performance, Unlimited,
Your org comes with one signature type called Default. A service report template can contain only and Developer Editions.
one signature per type. If you want to collect more than one signature on a service report, you can Work orders are also
add more signature types. In Setup, edit the Signature Type picklist field on the Digital Signature available in Professional
object. Create at least one value for each role that can sign a service report. For example, Technician, Edition.
Customer, Supervisor, and Supplier. If you expect multiple people in one role—for example, all
technicians who are at the appointment—to sign a service report, create numbered types: Technician
1, Technician 2, and so forth.

Note: You can create up to 1,000 signature types. You can’t delete a signature type, but you can deactivate it. When a signature
type is deactivated, it can’t be added to a new service report template. However, the signature type still appears in the service
report templates that include it.

Add Signature Blocks to Service Report Templates

A signature block on a service report template contains one signature.
To add a signature block to a service report template, navigate to the Service Report Templates page in Setup. Open a service report
template and drag the Signature element to the template layout. Modify the signature block’s settings as needed. The Type field is

159
Field Service Lightning Create Service Report Templates

required. Make sure to add the Signature field, which designates the signature space. You can change the title to reflect who is signing,
or hide the title and field labels.

You can add up to 20 signature blocks to a service report template. Because each signature block must use a different signature type,
you can’t drag extra signature blocks onto a template until you’ve created corresponding Signature Type values. Double-click a signature
block’s title to view its settings.

Note: Signature blocks can’t use multiple columns.

Capture Signatures for Service Reports

Signatures are captured from the Field Service Lightning mobile app. A captured signature isn’t reused in a future version of the report.
For example, a technician generates a service report for an appointment, and the customer signs it. The technician then updates the
service notes to add a recommendation. When the technician regenerates the service report, the customer’s signature doesn’t appear
on the new report.
If you want to reuse signatures across all service report versions, contact Salesforce.

Find Signed Service Reports

To easily find the service reports that contain signatures, add the Signed checkbox to the Service Reports related list on work orders,
work order line items, or service appointments. If a service report contains one or more signatures, this checkbox is automatically selected.

Note: After the service report is created, the signatures collected during the service event are deleted. See Create Service Reports
on page 161 for more details.

160
Field Service Lightning Create Service Reports

Create Service Reports

Create service reports to give your customers summaries of the work that your field service team
EDITIONS
performed.
1. From a work order, work order line item, or service appointment, click Create Service Report Available in: Salesforce
in the action dropdown menu. Classic and Lightning
Experience
Tip: If you don’t see this action, ask your Salesforce admin to add it to the page layout.
Service reports can’t be created for service appointments whose parent record is an The Field Service Lightning
account, asset, lead, or opportunity. core features, managed
package, and mobile app
2. Use the lookup to find the template you’d like to use. are available in Enterprise,
Performance, Unlimited,
3. Click Create PDF.
and Developer Editions.
The service report preview displays. Work orders are also
available in Professional
4. To save the service report to the record, click Create Service Report. To save the report to the
Edition.
record and send a copy to the customer, click Create and Send Service Report. Then, fill out
the email fields and click Send.
The service report is saved in the Service Reports related list on the record. USER PERMISSIONS

Note: After the service report is created, the signatures collected during the service event To create service reports:
are deleted. Use the saved service report to provide a proof of signature. • Edit on the parent object
(work orders, work order
Service reports are translated in the language selected in the Service Report Language field on the line items, or service
associated work order. If that field is blank, they use the default language of the person generating appointments)
the report. To email a service report:
• View on the parent
Note: If you don’t have Read permission on an object or field in the service report template, object AND Send Email
it doesn’t appear in the service report that you create.

Optimize Your Field Service Schedule

Use schedule optimization to formulate the optimal schedule for your team and customers. Schedule
EDITIONS
optimization helps you comply with service-level agreements and minimize travel time, overtime,
costs, and no-shows. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience

The Field Service Lightning

IN THIS SECTION:
core features, managed
What’s Schedule Optimization? package, and mobile app
Manually constructing an efficient field service schedule can drive even the most serene are available in Enterprise,
administrator to madness. Field Service Lightning’s schedule optimization tool does the work Performance, Unlimited,
for you by generating an optimal schedule according to your priorities and constraints. and Developer Editions.
Work orders are also
Create and Manage Scheduling Policies
available in Professional
A scheduling policy is a set of rules and objectives that guides the schedule optimizer in its Edition.
decisions. Use scheduling policies to promote or de-emphasize factors like business priorities,
travel time, and customer preferences. Whenever you optimize your team’s schedule, you can
select a guiding scheduling policy.

161
Field Service Lightning What’s Schedule Optimization?

Create and Manage Work Rules

Work rules refine the list of candidates for a service appointment by rejecting service resources that violate any rule. Add work rules
to any scheduling policy to guide schedule optimization.
Create and Manage Service Objectives
Add service objectives to a scheduling policy to indicate your scheduling goals. You can weight each objective to indicate its
importance. During schedule optimization, each appointment assignment receives a score from 0 to 100 for every service objective
based on how fully the objective was met.
Set Up and Run Optimization Jobs
Optimize your team’s schedule for one or more service territories across a specified range of days. You can configure the optimization
to run regularly—for example, every night—or run it manually as needed.
Optimize Today’s Schedule
Navigate last-minute schedule upsets by rapidly optimizing your team’s schedule for one or more service territories on the day of
service.
Optimize a Single Resource’s Schedule
When last-minute developments occur like canceled jobs, lateness, or emergencies, optimize an individual service resource’s schedule
to design the best schedule for them.
Create Scheduling Recipes for Common Events
Tackle common scheduling challenges with simple optimization “recipes” that address what happens to your schedule after
appointment cancellations, time changes, and overlaps. Cover all scenarios by creating multiple recipes for each category.
Monitor Optimization Requests
Keep an eye on all schedule optimization requests from the Gantt or the Optimization Requests custom tab.
Create Relevance Groups
A relevance group is a group of service appointments or service territory members that require their own work rules or service
objectives. For example, use relevance groups to enforce your company policy on breaks and travel time for full-time versus part-time
employees.

What’s Schedule Optimization?

Manually constructing an efficient field service schedule can drive even the most serene administrator
EDITIONS
to madness. Field Service Lightning’s schedule optimization tool does the work for you by generating
an optimal schedule according to your priorities and constraints. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Here’s an example of how schedule optimization can boost your efficiency.
The Field Service Lightning
core features, managed
Before Optimization After Optimization
package, and mobile app
62 scheduled hours 69.5 scheduled hours are available in Enterprise,
Performance, Unlimited,
24 minutes average travel 15 minutes average travel and Developer Editions.
51 scheduled appointments 56 scheduled appointments Work orders are also
available in Professional
Edition.

Optimization Options
Define the scope of optimization to include an entire service territory’s schedule or just a single resource’s schedule.

162
Field Service Lightning What’s Schedule Optimization?

• Global optimization—Optimize your team’s schedule for one or more service territories across a specified range of days. You can
configure this type of optimization to run regularly—for example, every evening. Or, you can run it manually as needed. Global
optimization is the most thorough and powerful type of optimization, and therefore takes the most time to complete.
• In-day optimization: Navigate last-minute schedule upsets by rapidly optimizing your team’s schedule for one or more service
territories on the day of service.
• Resource optimization—Optimize an individual service resource’s schedule on the day of service.

Terms to Know
Schedule optimization is based on several custom components that help you fine-tune your scheduling operations.

Component Description
Scheduling policy A set of rules and objectives that guide the schedule optimizer.
Use a scheduling policy to promote or de-emphasize factors such
as business priorities, travel time, and customer preferences. When
you optimize your team’s schedule, you can select a guiding
scheduling policy.

Work rule A rule that refines the list of candidates for a service appointment
by rejecting service resources that don’t match the rule. For
example, the Match Skill rule ensures that service appointments
are assigned only to service resources with the required skills. A
scheduling policy can have one or more work rules.

Service objective A scheduling goal or target. You can weight service objectives to
prioritize one over another. Every appointment assignment has a
score for each service objective. The score indicates how fully the
objective was met. The highest-scoring assignments are preferred.
A scheduling policy can have one or more service objectives.

Relevance group A subset of service resources or service appointments. Use

relevance group to apply work rules or service objectives to certain
resources—for example, full-time resources only—or service
appointments. You can create modified versions of work rules and
service objectives for each group and assign them to the group
using Visualforce components.

For a given time horizon, optimization grades assignments based on service objectives, and compares overall scores for different schedule
iterations. When the optimization is completed, it chooses the schedule with the highest score, and assigns appointments accordingly.
Optimization can move appointments that were previously scheduled. For example, optimization can reassign an appointment when
it finds a slot with a better grade or when it tries to fix an overlap. If an optimization unschedules an appointment and can’t find another
suitable slot, the appointment remains unscheduled after the optimization is completed.

Tip: Not sure where to start? Create a scheduling recipe to address common scheduling challenges, like appointment cancellations
or overlaps.

163
Field Service Lightning Create and Manage Scheduling Policies

Create and Manage Scheduling Policies

A scheduling policy is a set of rules and objectives that guides the schedule optimizer in its decisions.
EDITIONS
Use scheduling policies to promote or de-emphasize factors like business priorities, travel time, and
customer preferences. Whenever you optimize your team’s schedule, you can select a guiding Available in: Salesforce
scheduling policy. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
Scheduling policies are made up of two elements:
core features, managed
• Work rules refine the list of candidates for a service appointment by rejecting service resources package, and mobile app
that violate any rule. are available in Enterprise,
• Service objectives represent the policy’s purpose. You can weight each objective to indicate Performance, Unlimited,
its importance. and Developer Editions.
Work orders are also
available in Professional
Standard Scheduling Policies Edition.

Field Service Lightning includes four standard scheduling policies. You can customize these policies
or create your own.

Scheduling Policy Description

Customer First Balances great customer service with travel minimization. Appointments are
graded first by the customer’s selection of a preferred employee and then by
the ability to schedule the appointment as soon as possible. Travel minimization
is the second priority.

High Intensity Typically used in times of high service volumes, like a storm scenario, where you
need employee productivity is higher priority than customer preferences.

Soft Boundaries Identical to the Customer First policy, but allows the sharing of employees
between territories to enhance service coverage.

Emergency Used with the Emergency Chatter action to dispatch emergency service
appointments.

Manage Scheduling Policies

Create and manage scheduling policies from Guided Setup or the Scheduling Policies tab. To open Guided Setup, from the App Launcher,
find and open the Field Service Admin app. Click Field Service Settings > Go to Guided Setup > Customize Scheduling Policies.
Check your page layout settings before you begin; some fields may need to be added to your layout.
Outside of Guided Setup, you can view a policy’s work rules and weighted service objectives in its related lists.

164
Field Service Lightning Create and Manage Scheduling Policies

Note: Every scheduling policy automatically includes a Due Date work rule and Earliest Start Permitted work rule. In addition,
scheduling policies must include a Service Resource Availability work rule for resource absences to be respected during scheduling.

Apply a Scheduling Policy

You can apply a scheduling policy to your scheduling process in several ways.

Action Steps
Select a policy for scheduled optimization jobs From the App Launcher, find and open the Field Service Admin app, and then
click the Field Service Settings tab. Then, click Optimization > Scheduled
Jobs. Update the Scheduling Policy field on any scheduled job to list your
preferred policy.

Select a default scheduling policy for scheduling from From the App Launcher, find and open the Field Service Admin app, and then
the dispatcher console click the Field Service Settings tab. Click Dispatcher Console UI and update
the Default scheduling policy field.

Select a default scheduling policy for the Book From the App Launcher, find and open the Field Service Admin app, and then
Appointment and Candidates actions click the Field Service Settings tab. Click Global Actions > Appointment
Booking and update the Default scheduling policy field.

Select a policy in the dispatcher console appointment The Policy field in the appointment list shows the default dispatcher console
list scheduling policy, but can be updated before a dispatcher optimizes the
schedule.

Note: To automatically schedule a service appointment, select a scheduling policy using the Scheduling Policy Used field. Then
select the checkbox for Auto Schedule. If the Scheduling Policy Used field is blank, Field Service Lightning uses your org's default
scheduling policy.

165
Field Service Lightning Create and Manage Scheduling Policies

Scheduling Policy Fields

Scheduling policies have the following fields. Some may need to be added to your page layouts.

Field Name Description

Commit Mode Choose what happens if a user makes a potentially conflicting
change to the schedule while optimization is in progress. This field
applies to resource schedule optimization and in-day optimization,
and isn’t considered in global optimization. The field has two
options:
• Always Commit (default)—If a user tries to make a
potentially conflicting change to the schedule while
optimization is in progress, warn the user that their change
may conflict with the optimization results, but let them opt to
complete the change. If the conflicting change is made by
automation or a user outside of the dispatcher console, no
warning is displayed.
• Rollback—If a potentially conflicting change is made to
the schedule for the dates being optimized—with a buffer day
before and after—don’t complete the optimization. This choice
is a conservative scheduling option that helps you avoid all
possible conflicts.
For example, if you begin a scheduled job to optimize April
2–5, any change made to the April 1–6 schedule causes the
optimization to be rolled back. Changes include creating,
updating, and deleting resource absences and service
appointments.

Description Description of the policy.

Fix Overlaps (Checkbox) If this option is selected, any existing appointment

overlaps are addressed during in-day or global optimization. The
way the overlap is addressed depends on:
• The start time and priority of the overlapping appointments.
• Whether either appointment has a pinned status. To choose
which appointments are pinned (excluded from rescheduling)
during optimization, from the Field Service Settings tab, click
Optimization > Logic.
If Fix Overlaps isn’t selected, overlaps are left as is.

In-Day Optimization (Checkbox) If this option is selected, the scheduling policy uses
in-day optimization rather than global optimization.

Scheduling Policy Name Name of the policy.

166
Field Service Lightning Create and Manage Work Rules

Create and Manage Work Rules

Work rules refine the list of candidates for a service appointment by rejecting service resources that
EDITIONS
violate any rule. Add work rules to any scheduling policy to guide schedule optimization.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager Experience
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the
The Field Service Lightning
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules
core features, managed
related list on a scheduling policy.
package, and mobile app
Note: If a user doesn’t see a particular work rule type, they may need profile-based access are available in Enterprise,
to it. Navigate to the user’s profile in Setup. Under Custom Record Type Settings, click Edit Performance, Unlimited,
next to Work Rules and move the record type to Selected Record Types. and Developer Editions.
Work orders are also
available in Professional
IN THIS SECTION: Edition.
Work Rule Type: Count Rule
Use a Count work rule type to restrict appointment scheduling based on assignments, hours
worked, or a custom value. It’s a great way to prevent overloading your workers or their vehicles.
Work Rule Type: Excluded Resources
Sometimes, customers have a poor experience with a service resource and request not to work with them in the future. The Excluded
Resources work rule type ensures that if a service resource is listed as an Excluded resource preference on an appointment’s work
order, they won’t be assigned to it.
Work Rule Type: Extended Match
Use the Extended Match work rule type to schedule service appointments using custom criteria. It uses a junction, or linking, object
to match a field on the Service Appointment object to a related list on the Service Resource object.
Work Rule Type: Match Boolean
The Match Boolean work rule type enforces scheduling preferences based on a checkbox (Boolean) field on service resources.
Work Rule Type: Match Fields
The Match Fields work rule type matches a field on service appointments with a field on service resources. It’s a great way to enforce
requirements based on custom fields.
Work Rule Type: Match Skills
The Match Skills work rule type matches a service appointment’s parent record’s skill requirements with a service resource’s assigned
skills. It can also be used to enforce skill level requirements.
Work Rule Type: Match Territory
The Match Territory work rule type ensures that a service appointment is assigned only to service resources who are Primary or
Relocation members of the appointment’s service territory.
Work Rule Type: Match Time Rule
The Match Time Rule work rule type limits the scheduling time frame based on an appointment’s date and time properties. For
example, the Due Date work rule ensures that the appointment’s scheduled end is before its due date.
Work Rule Type: Maximum Travel from Home
The Maximum Travel from Home work rule type lets you set the maximum distance or travel time between a service resource’s home
base and any appointment assigned to the resource. It’s a useful way to minimize technicians’ travel time.

167
Field Service Lightning Create and Manage Work Rules

Work Rule Type: Required Resources

The Required Resources work rule type ensures that a service appointment’s parent record’s resource preferences of type Required
are respected. If an account or work order lists a particular service resource as required, a Required Resources work rule ensures that
the related service appointments are assigned to that resource.
Work Rule Type: Service Appointment Visiting Hours
The Service Appointment Visiting Hours work rule type enforces your customers’ operating hours. For example, if an account’s
operating hours are weekdays between 8:00 AM and noon, appointments for that customer are scheduled only within those hours.
Work Rule Type: Service Crew Resources Availability
The Service Crew Resources Availability work rule type ensures that a service resource of type Crew is assigned to an appointment
only if the crew complies with the appointment’s parent record’s minimum crew size.
Work Rule Type: Service Resource Availability
The Service Resource Availability work rule type ensures that a service resource is available to perform a service appointment. Every
scheduling policy needs a work rule of this type, or resource absences won’t be respected during scheduling.
Work Rule Type: TimeSlot Designated Work
Often, field service businesses reserve parts of the day for specific types of work. The TimeSlot Designated Work work rule type
ensures that if a time slot is reserved for a specific type of work, only appointments of that type are scheduled in the time slot.
Work Rule Type: Working Territories
Sometimes, service resources need to be available to take on work in more than one service territory. The Working Territories work
rule type enforces primary and secondary service territory memberships.

Work Rule Type: Count Rule

Use a Count work rule type to restrict appointment scheduling based on assignments, hours worked,
EDITIONS
or a custom value. It’s a great way to prevent overloading your workers or their vehicles.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
A work rule of this type contains the following settings. Experience

The Field Service Lightning

Field Description
core features, managed
Time Resolution Time span for the count. Currently, the package, and mobile app
resolution is daily. are available in Enterprise,
Performance, Unlimited,
Count Type What the rule counts: assignments, durations, and Developer Editions.
or a custom field value. Work orders are also
available in Professional
Count Object Object used in the count. If the rule counts
Edition.
assignments or durations, the object is a service
appointment. If the rule counts a custom value,
select the object that has the custom field:
service appointment, work order, or work order
line item.

Custom Field Custom field name.

Default Limit Default count limit.

Resource Property API name of a numeric custom field on a service

resource. This field represents the limit on

168
Field Service Lightning Create and Manage Work Rules

Field Description
service resources. If this field is null, we use the default limit.

Create a count work rule from the Work Rules tab.

Tip: To create work rules, you need the FSL Admin custom permission set. If the Count work rule isn’t listed as a work rule type,
update the FSL custom permission sets.
Enter the fields manually, or use the Count Rule custom Lightning component helper.

Note: To add a custom Lightning component to a record page in Lightning Experience, you must have My Domain set up.

Add the work rule to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or the Scheduling Policy
Work Rule related list.
Scheduling and optimization consider resources for assignments as long as assignments don’t result in overstepping the limit.
When a manual schedule change causes a limit to be exceeded, the Gantt shows rule violations on all appointments that contribute to
the count. Violations include rule names, so use meaningful names.
Considerations
• You can add up to four rules that count custom field values. You can also add more rules that count assignments and durations.
• The Start of Day is midnight even if it’s customized to a different value.
• Multiday work and complex work aren’t supported with Count work rules.
• Count work rules don’t consider service resources that are part of a crew. You can set up count rules for crews, but not for the
resources in crews.
• Count work rules ignore capacity-based resources.

Example: A dispatcher wants to create schedules that respect how many solar panels workers can deliver and install. A custom
field on work orders represents the panel quantity for each installation. Because workers drive different vehicles, a resource property
indicates how many panels a worker can transport. To set limits for large versus small trucks, you can add workers to relevance
groups based on truck size and create rules using those groups.

Work Rule Type: Excluded Resources

Sometimes, customers have a poor experience with a service resource and request not to work
EDITIONS
with them in the future. The Excluded Resources work rule type ensures that if a service resource
is listed as an Excluded resource preference on an appointment’s work order, they won’t be assigned Available in: Salesforce
to it. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
Use this work rule type to enforce customer resource preferences, such as those resulting from a
core features, managed
complaint. Other work rules can exclude service resources based on skills, availability, and proximity.
package, and mobile app
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager are available in Enterprise,
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the Performance, Unlimited,
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules and Developer Editions.
related list on a scheduling policy. Work orders are also
available in Professional
Edition.

169
Field Service Lightning Create and Manage Work Rules

Work Rule Type: Extended Match

Use the Extended Match work rule type to schedule service appointments using custom criteria. It uses a junction, or linking, object to
match a field on the Service Appointment object to a related list on the Service Resource object.

This is a Field Service Lightning managed package feature.

Because you can use an Extended Match work rule to match appointments to resources using your own customizations, writing a rule
requires some prior setup. Before you get started, create a data model or make sure that you have an existing data model with the
appropriate fields. We suggest using Schema Builder.
You can apply Extended Match work rules when scheduling appointments. To use them with optimization, turn on Enhanced Optimization
on page 73.
A work rule of this type contains the following settings.

Field Description
Service Appointment Matching Field The service appointment lookup field value that you're matching.
The field must be of the type Lookup.

Linking Object The junction object used to link service resources to the object
that the service appointment matching field references.

Linking Object Reference Field The reference field on the linking object that is matched with the
Service Appointment Matching Field.

Time-Phased Indicates whether the work rule applies only to a certain time
period.

Start Date Field Name The Date-Time field name on the Linking Object that represents
the start time. This field is required when you select Time-Phased.

End Date Field Name The Date-Time field name on the Linking Object that represents
the end time. This field is required when you select Time-Phased.

After you create the data model for your work rule, finish setting it up by creating a work rule from the Work Rules tab. Enter the fields
manually, or use the Extended Match Rule custom Lightning Component helper.

Note: To add a custom Lightning Component to a record page in Lightning Experience, you must have My Domain set up.

Time-phased Extended Match work rules can consume up to 80 records on a service resource during the selected time period. Work
rules that aren't time-phased can consume up to 200 records.
You can add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the Scheduling
Policy Work Rules related list on a scheduling policy. A policy can have up to two Extended Match work rules.

Example: If your mobile workers support specific ZIP codes, use an Extended Match work rule to assign them appointments
within their area. Create a ZIP Code lookup field on the Service Appointment object. Then create a ZIP Code Coverage linking
object, add the ZIP Code field, and attach it to the Service Resource object as a related list. Use the Extended Match Rule Lightning
Component to create a work rule.
The ZIP Code Coverage example has this data model.

170
Field Service Lightning Create and Manage Work Rules

Note: In this example, if a service appointment has an empty ZIP Code field, the work rule returns all Service Resources.
Define other work rules in your policy, such as Match Skills or Match Territory, that can narrow resources when there’s no
ZIP code on the appointment.

Work Rule Type: Match Boolean

The Match Boolean work rule type enforces scheduling preferences based on a checkbox (Boolean)
EDITIONS
field on service resources.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Work rules of this type contain two key settings. Experience

The Field Service Lightning

Field Name Description
core features, managed
Resource Property The API name of the checkbox field on service package, and mobile app
resources that defines the scheduling are available in Enterprise,
requirement. For example, IsActive. Performance, Unlimited,
and Developer Editions.
Value is True If selected, the Resource Property must be True Work orders are also
(selected) for a service resource to be assigned available in Professional
to a service appointment. If not selected, the Edition.
Resource Property must be false (deselected)
for a resource to be assigned to an appointment.

To control which checkbox fields are available as resource properties:

• Add the API name of any checkbox field as a picklist value in the Resource Property field on the Work Rule custom object in Setup.
• Make sure that the value has been enabled for the record type.
Field Service Lightning includes a standard Match Boolean work rule named Active Resources. This work rule:
• Assures that only active service resources are considered for scheduling.
• Lets you preserve historical data on the Gantt. When a service resource leaves your company, their assignment data remains.

171
Field Service Lightning Create and Manage Work Rules

A scheduling policy can contain up to 10 Match Boolean work rules.

Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager in Setup and select the Work Rule
custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the
Scheduling Policy Work Rules related list on a scheduling policy.

Work Rule Type: Match Fields

The Match Fields work rule type matches a field on service appointments with a field on service
EDITIONS
resources. It’s a great way to enforce requirements based on custom fields.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Work rules of this type contain three key settings. Experience

The Field Service Lightning

Field Name Description
core features, managed
Service Property The API name of the field on service package, and mobile app
appointments that helps define the scheduling are available in Enterprise,
requirement. All primitive data types are Performance, Unlimited,
supported. and Developer Editions.
Work orders are also
Boolean Operator The required relationship between the Service available in Professional
Property and the Resource Property. For Edition.
example, if =, a service appointment’s Service
Property value must equal a service resource’s
Resource Property value for the resource to be
assigned to the appointment.

Resource Property The API name of the field on service resources

that helps define the scheduling requirement.
All primitive data types are supported.

To control which fields are available as resource and service properties:

• Add the API name of any field as a picklist value in the Resource Property or Service Property fields on the Work Rule custom object
in Setup.
• Make sure that the value has been enabled for the record type.

Important: Match Fields work rules aren’t supported for schedule optimization.

172
Field Service Lightning Create and Manage Work Rules

Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager in Setup and select the Work Rule
custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the
Scheduling Policy Work Rules related list on a scheduling policy.

Work Rule Type: Match Skills

The Match Skills work rule type matches a service appointment’s parent record’s skill requirements
EDITIONS
with a service resource’s assigned skills. It can also be used to enforce skill level requirements.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Work rules of this type have one key field. Experience

The Field Service Lightning

Field Name Description
core features, managed
Match Skill Level If selected, service resources whose skill level is lower than the level listed on package, and mobile app
an appointment’s parent record’s Skill Requirement record aren’t considered are available in Enterprise,
as candidates. Performance, Unlimited,
and Developer Editions.
Work orders are also
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager available in Professional
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the Edition.
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules
related list on a scheduling policy.

Work Rule Type: Match Territory

The Match Territory work rule type ensures that a service appointment is assigned only to service
EDITIONS
resources who are Primary or Relocation members of the appointment’s service territory.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
This rule compares the Service Territory field value on service appointments with the Service Territory Experience
field value on service territory member records.
The Field Service Lightning
Note: A scheduling policy can’t include both a Working Territories work rule and a Match core features, managed
Territory work rule. package, and mobile app
are available in Enterprise,
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager
Performance, Unlimited,
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the
and Developer Editions.
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules
Work orders are also
related list on a scheduling policy. available in Professional
Edition.

173
Field Service Lightning Create and Manage Work Rules

Work Rule Type: Match Time Rule

The Match Time Rule work rule type limits the scheduling time frame based on an appointment’s
EDITIONS
date and time properties. For example, the Due Date work rule ensures that the appointment’s
scheduled end is before its due date. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Work rules of this type contain the following settings.
The Field Service Lightning
core features, managed
Field Name Description
package, and mobile app
Service Schedule Time Property Indicates whether the rule controls the service are available in Enterprise,
appointment’s scheduled start time or Performance, Unlimited,
scheduled end time. Custom date/time fields and Developer Editions.
aren’t supported. Work orders are also
available in Professional
Service Time Operator The required relationship between the Service Edition.
Schedule Time Property and the Service Time
Property. For example, if you select Equal, a
service appointment’s Service Schedule Time
Property value must equal the appointment’s
Service Time Property value.

Service Time Property The service appointment field that defines the
work rule requirement. There are four options.
• EarliestStartTime and DueDate together
represent the total time frame during which
an appointment must start and complete.
• The ArrivalWindowStart and EndTime
together represent the arrival window time
frame promised to the customer.
Custom date/time fields aren’t supported.

Pass Empty Values If the values of either of the Service Time

Properties are empty, ignore this rule.

Field Service Lightning includes four standard Match Time Rule work rules.
• Earliest Start Permitted: Ensures that a service appointment’s Scheduled Start is equal to or later than the Earliest Start Permitted.
This work rule is included in every standard scheduling policy.
• Due Date: Ensures a service appointment’s Scheduled End is equal to or earlier than the Due Date. This work rule is included in every
standard scheduling policy.
• Scheduled Start: Ensures that a service appointment’s Scheduled Start is equal to or later than the Arrival Window Start.
• Scheduled End: Ensures that a service appointment’s Scheduled Start is equal to or earlier than the Arrival Window End.
An appointment’s Scheduled Start is based on the travel time recorded for previous appointments. The Scheduled End is calculated by
adding the Duration to the Scheduled Start.

174
Field Service Lightning Create and Manage Work Rules

Work rules that impose time constraints limit your optimization flexibility. When you create Match Time Rule work rules, consider the
commitments that you’ve made to customers and your goals regarding wait time.
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager in Setup and select the Work Rule
custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the
Scheduling Policy Work Rules related list on a scheduling policy.

Work Rule Type: Maximum Travel from Home

The Maximum Travel from Home work rule type lets you set the maximum distance or travel time
EDITIONS
between a service resource’s home base and any appointment assigned to the resource. It’s a useful
way to minimize technicians’ travel time. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Important: To calculate maximum travel time or distance, Field Service Lightning uses aerial
The Field Service Lightning
routing (as the crow flies). core features, managed
Work rules of this type are particularly useful if your service territories are functional rather than package, and mobile app
geographical. are available in Enterprise,
Performance, Unlimited,
Work rules of this type contain the following settings.
and Developer Editions.
Work orders are also
Field Description available in Professional
Maximum Travel From Home Type Indicates whether the work rule enforces a Edition.
maximum travel time or maximum distance.

Maximum Travel From Home The maximum, which is measured in minutes

for travel time and miles or kilometers for
distance. The miles or kilometers preference is
set in the Field Service Admin app.

Relevance Groups Available only if relevance groups are

implemented. Relevance groups let you apply
the work rule to a subset of service resources.
For example, use relevance groups to enforce
these policies:
• Don’t assign resources to maintenance
appointments that are more than 20 miles
from their home base.

175
Field Service Lightning Create and Manage Work Rules

Field Description
• Don’t assign highly qualified workers to appointments that are
more than 20 miles from their home base.

If a service resource’s home base (address) isn’t specified, the resource isn’t a candidate for any service appointment. If a service appointment
lacks geocoordinates (calculated from an address), it can be assigned to any service resource with a home base.

Work Rule Type: Required Resources

The Required Resources work rule type ensures that a service appointment’s parent record’s resource
EDITIONS
preferences of type Required are respected. If an account or work order lists a particular service
resource as required, a Required Resources work rule ensures that the related service appointments Available in: Salesforce
are assigned to that resource. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
Required Resources work rules are a useful way to preserve one-on-one customer-provider
core features, managed
relationships, such as home healthcare. These work rules are highly restrictive, because they limit
package, and mobile app
the pool of potential assigned resources to consider only those who are listed as required in the
are available in Enterprise,
Resource Preferences related list on the related work order or account.
Performance, Unlimited,
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager and Developer Editions.
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the Work orders are also
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules available in Professional
related list on a scheduling policy. Edition.

Work Rule Type: Service Appointment Visiting Hours

The Service Appointment Visiting Hours work rule type enforces your customers’ operating hours.
EDITIONS
For example, if an account’s operating hours are weekdays between 8:00 AM and noon,
appointments for that customer are scheduled only within those hours. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
To define a customer’s preferred hours of service, create operating hours for them from the Operating
The Field Service Lightning
Hours tab. Select the hours in the Visiting Hours field on the account. Work orders created for the
core features, managed
account use the account’s operating hours, and service appointments use their work order’s
package, and mobile app
operating hours.
are available in Enterprise,
Operating hours use the time zone of the service appointment they’re attached to. The service Performance, Unlimited,
appointment inherits its location’s time zone. If the location has no time zone specified, GMT is and Developer Editions.
used. Work orders are also
available in Professional
Note: Dispatchers can still manually schedule appointments outside a customer’s operating Edition.
hours, but they’re alerted that they’re doing so.
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page
in Guided Setup or from the Scheduling Policy Work Rules related list on a scheduling policy.

176
Field Service Lightning Create and Manage Work Rules

Work Rule Type: Service Crew Resources Availability

The Service Crew Resources Availability work rule type ensures that a service resource of type Crew
EDITIONS
is assigned to an appointment only if the crew complies with the appointment’s parent record’s
minimum crew size. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
If the Minimum Crew Size field on work orders, work order line items, and work types is completed,
The Field Service Lightning
this work rule type comes into play. You can configure the rule to compare this Minimum Crew
core features, managed
Size with either of the following:
package, and mobile app
• Crew Size field on the service crew record are available in Enterprise,
• Actual number of allocated service crew members at the time of assignment Performance, Unlimited,
and Developer Editions.
For example, if a work order’s Minimum Crew size is 4 and a scheduling policy is applied with a
Work orders are also
work rule of this type, the appointment won’t be assigned to a crew with fewer than four members. available in Professional
Note: For tips on scheduling service crews, see Considerations for Scheduling Service Crews. Edition.

Service Crew Resources Availability work rules have the following setting.

Field Name Description

Consider Service Crew Membership Select this option if you want to check the actual number of service
crew members, rather than the crew size listed on the service crew
record.

Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager in Setup and select the Work Rule
custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the
Scheduling Policy Work Rules related list on a scheduling policy.

Work Rule Type: Service Resource Availability

The Service Resource Availability work rule type ensures that a service resource is available to perform
EDITIONS
a service appointment. Every scheduling policy needs a work rule of this type, or resource absences
won’t be respected during scheduling. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
It’s common to apply scheduling rules differently to different service resources. For example, you
The Field Service Lightning
may have different policies on breaks, overtime, or before- and after-work travel time for full-time
core features, managed
versus part-time employees. Service Resource Availability work rules let you capture these differences.
package, and mobile app
Work rules of this type consider the following factors. are available in Enterprise,
• The service resource’s operating hours, which are defined on their service territory member Performance, Unlimited,
record or—if no hours are specified there—on their service territory record and Developer Editions.
Work orders are also
• Travel time available in Professional
• The scheduled start and end time of other scheduled appointments Edition.
Service Resource Availability work rules have the following settings.

177
Field Service Lightning Create and Manage Work Rules

Field Name Description

Fixed Gap Enforce a minimum amount of break time between service appointments. This setting is useful for
remote consultants. For example, you may want to provide twenty minutes between appointments
for record-keeping.

Note: If a fixed gap is defined, travel time is not taken into consideration during scheduling.
However, travel time is still displayed on the Gantt.

Minimum Gap (minutes) The minimum number of minutes between service appointments. The Minimum Gap value applies
only if Fixed Gap is selected.

Break Start The preferred time at which a service resource can take their break. If you don’t want to use breaks,
leave this field empty. Breaks are inserted in the schedule between appointments. Breaks are scheduled
to start as close as possible to the Break Start time without compromising the ability to start and
complete appointments.
For example, if technicians can take their lunch any time after 12:30 PM, enter 12:30.

Break Duration The length of the fixed break.

Overtime Allow service appointments to be scheduled during operating hours of the Extended type. You may
need to add this field to the layout.

Travel From Home (minutes) The number of minutes that the resource has available for travel before the start of the work day (at
the resource's expense). If this field is empty, any amount of travel before the start of the work day is
valid.

Travel To Home (minutes) The number of minutes that the resource has available for travel after the end of the work day (at the
resource's expense). If this field is empty, any amount of travel after the end of the work day is valid.

Important: To create a Service Resource Availability work rule that creates breaks and calculates travel time, enable the Calculate
travel and breaks setting in Field Service Settings.
Fill out the travel fields according to where service resources are expected to be at the beginning and end of their periods of availability.
• On-site: If a service resource is expected to begin work on-site at the beginning of their availability (for example, if they start work
at 9 AM), travel must occur before that time. In this case, fill out the Travel To and From Home fields or leave them blank to allow
unlimited travel time.
• Start driving: If a service resource is expected to start traveling at the beginning of their availability, set the Travel To and From
Home fields to zero.

Note: During the scheduling of capacity-based service resources, Service Resource Availability work rules fail if one of the following
happens.
• The number of scheduled working hours exceeds the resource’s capacity
• The number of scheduled work items exceeds the resource’s capacity
• A capacity record was deleted or updated after the related service resource was assigned to a service appointment

Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager in Setup and select the Work Rule
custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page in Guided Setup or from the
Scheduling Policy Work Rules related list on a scheduling policy.

178
Field Service Lightning Create and Manage Work Rules

Work Rule Type: TimeSlot Designated Work

Often, field service businesses reserve parts of the day for specific types of work. The TimeSlot
EDITIONS
Designated Work work rule type ensures that if a time slot is reserved for a specific type of work,
only appointments of that type are scheduled in the time slot. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Time slots reservations are based on service appointment checkbox fields. To learn how to reserve
The Field Service Lightning
time slots for specific types of appointments, see Reserve Time Slots for Designated Types of Work.
core features, managed
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager package, and mobile app
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the are available in Enterprise,
Customize Scheduling Policies page in Guided Setup or from the Scheduling Policy Work Rules Performance, Unlimited,
related list on a scheduling policy. and Developer Editions.
Work orders are also
available in Professional
Edition.

Work Rule Type: Working Territories

Sometimes, service resources need to be available to take on work in more than one service territory.
EDITIONS
The Working Territories work rule type enforces primary and secondary service territory memberships.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Service resources can have only one primary service territory, but multiple secondary territories. By Experience
default, the Working Territories rule considers only secondary territories. If you want the optimizer
The Field Service Lightning
to consider the primary territory as well, select Working Location Enable Primary on the work
core features, managed
rule.
package, and mobile app
A scheduling policy can’t include both a Working Territories work rule and a Match Territory work are available in Enterprise,
rule. To choose between them, consider the number of service resources and service territories in Performance, Unlimited,
your field service operation, and how often service resources are called to work in different territories. and Developer Editions.
If service resources frequently move between service territories, use a Working Territories work rule. Work orders are also
available in Professional
Use relevance groups to differentiate between service resources if some resources move less than
Edition.
others.
Create work rules from the Work Rules tab. To view or add work rule fields, open the Object Manager
in Setup and select the Work Rule custom object. Add work rules to a scheduling policy from the Customize Scheduling Policies page
in Guided Setup or from the Scheduling Policy Work Rules related list on a scheduling policy.

179
Field Service Lightning Create and Manage Service Objectives

Create and Manage Service Objectives

Add service objectives to a scheduling policy to indicate your scheduling goals. You can weight
EDITIONS
each objective to indicate its importance. During schedule optimization, each appointment
assignment receives a score from 0 to 100 for every service objective based on how fully the objective Available in: Salesforce
was met. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
Create and manage service objectives from the Service Objectives tab. Add service objectives to a
core features, managed
scheduling policy from the Customize Scheduling Policies page in Guided Setup or the Scheduling
package, and mobile app
Policy Objectives related list on a policy.
are available in Enterprise,
When you create a service objective, select a record type to define the category that the objective Performance, Unlimited,
falls into. The following categories are available. and Developer Editions.
Work orders are also
Objective Type Description available in Professional
Edition.
ASAP Measures the ability to schedule an appointment as soon as possible.
The latest scheduling option receives a score of zero, and the soonest
option receives a score of 100. If multiple appointments are
evaluated simultaneously, the score is based on a range of 0–30
days in the future.

Tip: An ASAP objective can contradict other objectives. For

example, scheduling an appointment as soon as possible
can result in more travel time. Weight your objectives
accordingly.

Minimize Overtime Measures the use of overtime hours. The objective’s score compares
the number of overtime hours with the service appointment’s
estimated duration. For example, if an hour-long appointment is
scheduled entirely on overtime, its score is zero. If half of the
scheduled time is overtime, its score is 50.

Minimize Travel Measures the travel time required for a service appointment.
In optimization operations—global optimization, resource schedule
optimization, in-day optimization, and the Reshuffle action—each
scheduling option is scored with the assumption that travel time
ranges from zero to 120 minutes. For example, an option with a
travel time of 120 minutes receives a score of zero, and an option
with a travel time of 60 minutes receives a score of 50. You can ask
Salesforce to customize this range.
In non-optimization scheduling operations—such as the Book
Appointment, Candidates, Schedule, Fill-In Schedule, and Group
Nearby Appointments actions—this objective’s score is relative to
the travel times available. For example, if an appointment has three
scheduling options, here’s how the options are scored.
• Option 1: Schedule it after an appointment at the same site.
The travel time is zero minutes, so the objective score is 100.

180
Field Service Lightning Create and Manage Service Objectives

Objective Type Description

• Option 2: Schedule it after an appointment in a neighboring city. The travel time is 60
minutes, and because it’s the appointment’s maximum potential travel time, the objective
score is zero.
• Option 3: Schedule it after an appointment in a site located 30 minutes away. Because
it’s exactly in the middle of the previous options, the objective score is 50.

Preferred Resource Measures adherence to a work order’s resource preferences of type Preferred. The objective’s
score is 100 if an appointment is assigned to the parent work order’s preferred resource, and
zero if not. (Excluded and Required resource preferences are enforced using work rules.)

Resource Priority Ranks appointments based on their assigned resource’s priority, which is defined in the Priority
field on service resources. The lower the resource priority, the higher the objective’s score.

Skill Level Measures assigned resources’ adherence to a work order’s skill requirements. When creating
an objective of this type, select whether to favor least- or most-qualified service resources:
• Least qualified: Favors the least qualified valid candidate. This option lets you dispatch a
resource who is “good enough” to complete an appointment. For example, if a work order
requires the Drilling skill at level 50, a resource with a Drilling skill level of 55 is favored
over a resource with a Drilling skill level of 80.
• Most qualified: Favors the most qualified valid candidate.

Tip: Use this option with relevance groups to assign your most qualified resources
only to work orders for high-priority accounts.

If a work order has multiple skill requirements, the objective evaluates all skills and calculates
an average score.

181
Field Service Lightning Set Up and Run Optimization Jobs

Set Up and Run Optimization Jobs

Optimize your team’s schedule for one or more service territories across a specified range of days.
EDITIONS
You can configure the optimization to run regularly—for example, every night—or run it manually
as needed. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
To run an optimization manually from the dispatcher console, in the appointment list action menu,
The Field Service Lightning
select Optimize. Define the service territories, scheduling policy, and other information. Or, follow
core features, managed
these instructions to set up a scheduled job.
package, and mobile app
1. Optionally, exclude service appointments with certain statuses from being changed during are available in Enterprise,
schedule optimization. Performance, Unlimited,
a. From the App Launcher, find and open the Field Service Admin app, and then click Field and Developer Editions.
Service Settings > Optimization > Logic. Work orders are also
available in Professional
b. Under Global Optimization, select the service appointment statuses to exclude from schedule Edition.
optimization.
c. Save your changes. The settings apply to optimizations that you run manually or in a USER PERMISSIONS
scheduled job.
To optimize from the
2. On the Logic tab, click the Scheduled Jobs tab. dispatcher console:One of
3. Click New Job, and define the optimization scope. these custom permission
sets:
a. Select the territories to optimize. We recommend including no more than 100 territories
• FSL Admin Permissions
in a job.
• FSL Dispatcher
b. (Optional) If you selected multiple territories, select Optimize in stages underneath the Permissions
territory list. In the Territories Per Stage field, enter the number of territories to optimize at
a time. These settings help you stay within the scheduled jobs queue maximum of 100 To create a scheduled job:
• FSL Admin Permissions
items, and don’t affect optimization time. We recommend keeping this number low to
custom permission set
avoid reaching optimization limits.
c. For the time horizon, enter the number of days to optimize.
d. To specify the type of appointments that are optimized, select a filter. Only appointments that meet the criteria are optimized.
e. Select a scheduling policy to guide the optimization.
f. Enter an email address where you want optimization updates to be sent.
g. Select the frequency and schedule.
h. If your optimization is ready to be run, click Active.
i. Save your changes.

182
Field Service Lightning Set Up and Run Optimization Jobs

Note: Optimization applies only to service appointments whose parent appointment is a work order or work order line item.

Global optimization doesn’t reschedule appointments that have rule violations. Unschedule those appointments and reschedule them.

183
Field Service Lightning Optimize Today’s Schedule

Optimize Today’s Schedule

Navigate last-minute schedule upsets by rapidly optimizing your team’s schedule for one or more
EDITIONS
service territories on the day of service.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Schedule optimization in Field Service Lightning comes in a few different flavors. While global Experience
optimization is the most powerful and thorough option, the quicker, more lightweight in-day
The Field Service Lightning
optimization is ideal for finalizing the schedule on the morning of service. You can use in-day
core features, managed
optimization to optimize multiple days of the schedule, but it’s best suited for addressing last-minute
package, and mobile app
issues.
are available in Enterprise,
In-day optimization is available only if Enhanced Optimization is turned on. Performance, Unlimited,
1. Optionally, exclude service appointments with certain statuses from being changed during and Developer Editions.
in-day optimization. Work orders are also
available in Professional
a. From the App Launcher, find and open the Field Service Admin app, and then click Field Edition.
Service Settings > Optimization > Logic.
b. At the bottom of the page, select service appointment statuses to exclude from in-day USER PERMISSIONS
optimization. These preferences also apply to resource schedule optimization.
Service appointments with a selected status aren’t scheduled, unscheduled, or rescheduled To configure scheduling
during in-day optimization. We recommend leaving the Dispatch status deselected so policies:
dispatched work can be moved if a previous job runs late or emergency work is needed. • Custom permission set:
FSL Admin Permissions
2. To configure a scheduling policy to use in-day optimization rather than the default global To run in-day optimization:
optimization, select In-Day Optimization on the policy. You may need to add this field to the One of these custom
scheduling policy page layout. permission sets:
• FSL Admin Permissions
• FSL Dispatcher
Permissions

184
Field Service Lightning Optimize a Single Resource’s Schedule

Optimize a Single Resource’s Schedule

When last-minute developments occur like canceled jobs, lateness, or emergencies, optimize an
EDITIONS
individual service resource’s schedule to design the best schedule for them.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
1. Optionally, exclude service appointments with certain statuses from being changed during Experience
resource schedule optimization.
The Field Service Lightning
a. From the App Launcher, find and open the Field Service Admin app, and then click Field core features, managed
Service Settings > Optimization > Logic. package, and mobile app
b. At the bottom of the page, select service appointment statuses to exclude from resource are available in Enterprise,
schedule optimization. These preferences also apply to in-day optimization. Performance, Unlimited,
and Developer Editions.
Service appointments with a selected status aren’t scheduled, unscheduled, or rescheduled
Work orders are also
during resource schedule optimization. We recommend leaving the Dispatch status available in Professional
deselected so dispatched work can be moved if a previous job runs late or emergency work Edition.
is needed.

2. Optimize any service resource’s schedule. USER PERMISSIONS

a. From the dispatcher console, click the action menu of the resource whose schedule you To see Resource Schedule
want to optimize. Optimization on the Gantt:
b. Click Resource Schedule Optimization. • Resource Schedule
Optimization custom
c. Define the scope of your optimization. Service appointments are scheduled only within the permission
dates you select, but candidate service appointments can come from outside the time
frame. When selecting a category in Keep these appointments scheduled, keep in mind
that resource schedule optimization fails if more than 50 appointments must remain scheduled. The optimization can move
and reschedule the kept appointments.
d. Click Optimize.

You can also set up scheduling preferences to automatically run resource schedule optimization in response to common scheduling
events, like appointment overlaps or cancellations. To learn how, see Create Scheduling Recipes for Common Events.

Note:
• Complex work information that’s not fully available in the optimization data is considered excluded from resource schedule
optimization. For example, a partial chain of a scheduling dependency is excluded.
• Resource schedule optimizations can’t run in parallel for the same service resource on the same time interval.
• You can’t run resource schedule optimization on capacity-based resources.

185
Field Service Lightning Create Scheduling Recipes for Common Events

Create Scheduling Recipes for Common Events

Tackle common scheduling challenges with simple optimization “recipes” that address what happens
EDITIONS
to your schedule after appointment cancellations, time changes, and overlaps. Cover all scenarios
by creating multiple recipes for each category. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
Scheduling recipes are an Enhanced Optimization feature. They use resource schedule optimization,
The Field Service Lightning
which means that only the affected service resource’s schedule is optimized.
core features, managed
1. From the App Launcher, find and open the Field Service Admin app. package, and mobile app
2. Click the Field Service Settings tab, and then click Automated Scheduling. are available in Enterprise,
Performance, Unlimited,
3. In the New Recipe menu, select a category. We’ve provided some example recipes to get you and Developer Editions.
started. You can activate them or create your own. Work orders are also
4. Customize your recipe’s settings. Then, activate and save it. Inactive recipes aren’t enforced. available in Professional
Edition.
• The Status Categories field lets you limit which appointments the recipe applies to. For
example, if you select only the Scheduled value on a recipe for shortened appointments,
the recipe runs only if an appointment’s status is in the Scheduled status category when USER PERMISSIONS
the appointment is shortened. Excluding the Canceled status category, the appointment’s
status must also be a pinned status, which is set in Field Service Settings > Optimization > To create a scheduling
recipe:
Logic.
• Custom permission set:
• The Initiating User Permission Set field lets you decide which users can trigger the recipe. FSL Admin Permissions
For example, if you’re creating a recipe for canceled appointments, select Community to
run the recipe only for appointments canceled by a community user (typically, a customer).
The values in this field correspond to the permission sets provided by the managed package.

Initiating User Permission Set Value Corresponding Permission Set

Resource FSL Resource

Dispatcher FSL Dispatcher

FSL Community Dispatcher

Agent FSL Agent

Admin FSL Admin

Community FSL Self Service

5. To change the priority order of recipes within a category, click on the Automated Scheduling home page. Drag the recipes into
the desired order and click Save.

186
Field Service Lightning Create Scheduling Recipes for Common Events

Example: Here’s a recipe that controls what happens to the assigned resource’s schedule when a solar appointment in the San
Francisco service territory ends early and results in 60 unused minutes on the schedule.

Considerations for scheduling recipes:

• You can create up to 75 active recipes per category, and up to 1000 active recipes per org.
• For Shortened Appointment scenarios, scheduling recipes only try to fill one white space per day for each service resource.
• For Shortened Appointment, Late-End Overlap, and Emergency Overlap scenarios, scheduling recipes are only triggered if the
service appointment's status has been selected as a pinned status for In-Day Optimization. We recommend leaving the Dispatch
status deselected so dispatched work can be moved if a previous job runs late or emergency work is needed.
• If you have access to 2,000 or more service territories, the appointment list shows only selected territories. Use the search bar
to find territories that aren't selected.

187
Field Service Lightning Monitor Optimization Requests

Monitor Optimization Requests

Keep an eye on all schedule optimization requests from the Gantt or the Optimization Requests
EDITIONS
custom tab.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
From the Optimization Requests tab Experience
Create a custom tab for the Optimization Request object, and customize the list view to show
The Field Service Lightning
useful fields like Status, Start, Finish, and Failure Reason. Click any request to view its details.
core features, managed
Tip: Add the Failure Details field and Notes and Attachments related list to the package, and mobile app
optimization request page layout. These page elements give you a fuller view of the are available in Enterprise,
request. Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To cancel optimization
requests:
• Abort Optimization
Request custom
permission

From the Gantt

Click the lightbulb icon at the top of the Gantt to view the status of recent optimization requests. When a global optimization request
is in progress, you can see a percentage-based progress bar and the option to cancel the request.

188
Field Service Lightning Monitor Optimization Requests

In-day optimization progress appears below the Gantt’s time axis.

A percentage-based progress bar isn’t available for resource schedule optimization requests, but the resource’s row in the Gantt
changes color to indicate that optimization is in progress.

Why did my request fail?

Salesforce sometimes cancels optimization requests to protect the integrity of your schedule. Here are the most common reasons
a request fails.
• If a request stays in the same status for longer than the configured limit, it’s canceled. The limit varies depending on the status
and the type of optimization.
• If optimization runs longer than your org's session timeout value, it gets stuck in the "In Progress" status. The optimization job
fails, resulting in an error when it tries to deliver the results to your Salesforce org.
To avoid failed optimizations, increase your session timeout value to at least 2 hours, or select a quicker optimization run time.

189
Field Service Lightning Create Relevance Groups

• Scheduled optimization jobs can generate one or more JSON files. The request fails if a JSON file contains more than 6 million
characters.
To check whether an optimization job exceeded this limit, go to the Optimization Requests tab. Open the request associated
with the failed job, and click the value in the Optimization Data field. In the Notes and Attachments related list, open each JSON
file and check its character total.
If the Optimization Data field is empty, check the Error field for details. If the Error field is empty, contact Salesforce to learn more
about the failure.

• If simultaneous conflicting updates are made to the schedule while a request is open, the request is canceled. For example, this
can happen when you add or update appointments or resource absences that fall into the date range and service territory being
optimized.
• Resource schedule optimization fails if more than 50 service appointments are required to remain scheduled during the
optimization. To change which appointments must remain scheduled, select a different category in Keep these appointment
scheduled when you run the optimization. For example, if In Jeopardy is selected and more than 50 appointments are in jeopardy
for the selected time period, the request fails.
To review limits and limitations related to schedule optimization, see Field Service Lightning Limits and Limitations.

Create Relevance Groups

A relevance group is a group of service appointments or service territory members that require
EDITIONS
their own work rules or service objectives. For example, use relevance groups to enforce your
company policy on breaks and travel time for full-time versus part-time employees. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
You can base a relevance group on any standard or custom Boolean (true or false) field for service
The Field Service Lightning
appointments or service territory members. When you create a work rule or service objective, select
core features, managed
a field to limit the scope of the rule or objective.
package, and mobile app
To use relevance groups, add the relevance group Visualforce pages to your work rule and service are available in Enterprise,
objective page layouts. Performance, Unlimited,
1. In the layout editor, open a work rule or service objective page layout—for example, the Match and Developer Editions.
Boolean work rule page. Work orders are also
available in Professional
2. Select Visualforce pages, and drag one of the following pages onto the detail page layout. Edition.
We recommend giving it its own section for clarity.
• Work rules: Vf001GroupOnWorkRules
• Service objectives: Vf002GroupOnObjectives

3. Save your changes.

You can apply a work rule or service objective to a subset of service territory members or service appointments. Select the limiting
Boolean field on the work rule or service objective detail page.

Note: Relevance groups can use primary service territory memberships and relocation service territory memberships. Secondary
service territory memberships aren't supported.

190
Field Service Lightning Create Relevance Groups

Example: Use relevance groups to define different limits on travel from home for part-time and full-time employees.
1. Add the appropriate Visualforce page to the Maximum Travel From Home work rule page layout.
2. On the service territory member object, create two checkbox fields:
• Part-Time
• Full-Time: A formula field that updates to false when Part-Time is true

3. Create a Maximum Travel From Home work rule that reflects your travel time policy for part-time employees. For Service
Territory Member, select Part-Time.
4. Create another Maximum Travel From Home work rule that reflects your travel time policy for full-time employees. For Service
Territory Member, select Full-Time.
5. Add both rules to a scheduling policy. When the policy is applied, part-time and full-time employees are evaluated based on
the requirements outlined in the respective work rules.
Relevance groups must be mutually exclusive. If two work rules with relevance groups overlap, the more restrictive rule is used. If
Service Resource Availability work rules use relevance groups, any rule overlaps will lead to an error.

191
Field Service Lightning Work in the Dispatcher Console

Work in the Dispatcher Console

The Field Service Lightning dispatcher console is the main working space for dispatchers. It features
EDITIONS
a dynamic map and a highly customizable Gantt chart showing upcoming appointments, active
team members, and more. To reach the dispatcher console, from the App Launcher, find and open Available in: Salesforce
the Field Service app, and then click the Field Service tab. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
The dispatcher console is supported on desktop only. For the best dispatcher console experience,
core features, managed
we recommend using a screen resolution of 1920 x 1080 pixels, or a minimum of 1366 x 768 pixels,
package, and mobile app
at 100% zoom.
are available in Enterprise,
Performance, Unlimited,
IN THIS SECTION: and Developer Editions.
Work orders are also
Customize the Dispatcher Console
available in Professional
Make the dispatcher console work for you! Adjust the time frame and contents of the
Edition.
appointment list and Gantt, customize each section’s layout, create custom actions for
dispatchers, and create custom appointment list filters.
Work in the Dispatcher Console Appointment List
The service appointment list on the left side of the dispatcher console contains a list of service appointments. You can filter, sort,
and search within the list, and perform actions on selected appointments.
Work in the Dispatcher Console Gantt
The Gantt is located on the right side of the dispatcher console and contains the resource list, the schedule view, and additional
features.
Work in the Dispatcher Console Map
The dispatcher console map gives dispatchers a dynamic bird’s-eye view of their mobile workforce. Learn how to customize the
map view and draw territories directly on the map.

Customize the Dispatcher Console

Make the dispatcher console work for you! Adjust the time frame and contents of the appointment
EDITIONS
list and Gantt, customize each section’s layout, create custom actions for dispatchers, and create
custom appointment list filters. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience

The Field Service Lightning

IN THIS SECTION:
core features, managed
Control Which Appointments Appear in the Dispatcher Console package, and mobile app
Dispatchers can view and filter service appointments in the appointment list and in the Gantt are available in Enterprise,
chart. Learn how to control which appointments appear in these sections of the dispatcher Performance, Unlimited,
console. and Developer Editions.
Work orders are also
Customize the Dispatcher Console with Field Sets
available in Professional
Use field sets to control which fields appear in different sections of the Field Service Lightning Edition.
dispatcher console. For example, choose which fields appear as columns in the appointment
list.

192
Field Service Lightning Customize the Dispatcher Console

Create Custom Actions for the Dispatcher Console

Put the right actions at your dispatchers’ fingertips by adding custom actions to the dispatcher console. Custom actions can either
call an Apex class or open a Visualforce page, and can be run on records in several areas of the dispatcher console. To keep the
dispatcher console tidy, actions are shown in dropdown action lists with icons.
Create Custom Appointment List Filters
Create custom filters to control which appointments appear in the dispatcher console service appointment list. Base your filters on
service appointment fields and add custom logic. Dispatchers can create private filters or share them with others.
Create Custom Appointment Icons
Add custom icons to service appointments on the Gantt, map, and appointment list so dispatchers can quickly identify appointment
characteristics. For example, use a custom icon to indicate that an appointment is for a VIP or first-time customer.

Control Which Appointments Appear in the Dispatcher Console

Dispatchers can view and filter service appointments in the appointment list and in the Gantt chart.
EDITIONS
Learn how to control which appointments appear in these sections of the dispatcher console.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Control the Time Frame The Field Service Lightning
core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

These settings control the Gantt time frame.

• Gantt filter (1):
– On the Hours tab, choose which hours of the day are shown on the Gantt, and adjust settings for the Long-Term view.
– On the Utilization tab, specify how many days are shown when the Utilization view is applied.

193
Field Service Lightning Customize the Dispatcher Console

• Gantt resolution dropdown (2): Select how many days to show on the Gantt at once. Customize the Utilization view from the
Gantt filter’s Utilization tab, and the Long-Term view from the Gantt filter’s Hours tab. You need the Longterm View custom permission
to select the Long-Term view.
• Date and calendar toggles (3): Toggle between days and months.
These settings control the appointment list time frame.
• Horizon date (4): The appointment list only lists appointments with a date field that falls before the horizon.
• Match Gantt Dates field (5): If you select Match Gantt Dates, the horizon date updates to match the dates shown on the Gantt.
• Scheduling window limit (6): Click the gear icon and select Dispatch Console Settings to define the scheduling window limit,
which represents the number of days before the horizon date. The appointment list only lists appointments with a date field that
falls in that span of days before the horizon date.

Note: If a custom filter is applied, the appointment list time frame is controlled by the horizon date and the custom filter settings.
Custom filters let you specify the number of days before and after the horizon, and that time frame is used to define which
appointments are shown.

Control Which Appointments Are Shown

The date field dropdown menu in the dispatcher console control which appointments are visible in the appointment list. If the value of
any of the selected date fields on an appointment falls within the specified time frame, the appointment appears in the appointment
list.

If an appointment’s dates for any selected fields among the first six don’t fall within the Gantt time frame, use the Gantt Display Date to
show the appointment on the Gantt. When a service appointment’s Gantt Display Date falls within the Gantt time frame, the appointment
is visible on the Gantt. For example, if a maintenance appointment must be completed within the next six months, you may want to
see it on the Gantt every day as a reminder.

Tip: Set up a process in Lightning Process Builder to automatically configure an important appointment’s Gantt Display Date to
today’s date, updated daily.
In addition, several types of filters let you refine which appointments are shown in the dispatcher console:
• The appointment list search, which filters the list to show only appointments that match your search criteria
• The resource list search in the Gantt, which filters the resource list to show only service resources that match your search criteria
• The Resources and Skills tabs in the Gantt filter, which filter the resource list to show only service resources that match your criteria
• The territory filter, reached from the map icon in the appointment list (6), which filters the Gantt and appointment list according to
your criteria
• Any custom appointment list filters in place

194
Field Service Lightning Customize the Dispatcher Console

Customize the Dispatcher Console with Field Sets

Use field sets to control which fields appear in different sections of the Field Service Lightning
EDITIONS
dispatcher console. For example, choose which fields appear as columns in the appointment list.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
To manage a field set, from the Object Manager, find the object whose field set you want to edit—for Experience
example, Service Resource. Then, click Field Sets.
The Field Service Lightning
Field sets support the following field types: Number, Text, Date, Date/Time, Currency, and Reference core features, managed
(lookup fields). The Field Service Lightning managed package also provides additional field sets not package, and mobile app
included in this article. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Service Appointment Field Sets Work orders are also
available in Professional
Field Set Description Location in Dispatcher Console Edition.
Capacity Controls the columns
Service on the dialog screen
Columns shown when a user
double-clicks a
capacity record on
the Gantt. This field
set supports up to 9
fields.

Crew Controls which fields

Management are shown when a
user double-clicks a
service appointment
from the Crew
Schedule row in the
Crew Management
Gantt.

195
Field Service Lightning Customize the Dispatcher Console

Field Set Description Location in Dispatcher Console

Crew Controls which fields are
Management shown when a user hover
Tooltip over an appointment in the
Crew Management Gantt.

Note: Lookup fields

and fields without
values aren't displayed.
The Required Skills
field is always shown.

Designated Controls which fields are

Work Fields available when a user is
creating a designated time
slot from the time slots editor
Visualforce page on the
operating hours record.

Gantt Filter Controls the Additional

Criteria fields shown when
creating a custom Gantt filter.

196
Field Service Lightning Customize the Dispatcher Console

Field Set Description Location in Dispatcher Console

Service Controls the mini layout
Appointment displayed when the user clicks
Expanded an appointment in the
appointment list. The mini
layout supports up to 12
fields.

Service Controls the fields that appear

Appointment in the appointment list as
List Columns columns. The appointment
list supports up to six
columns. You can include
Gantt or custom icon fields in
columns.

Note: Custom
appointment list filters
include appointment
list column settings. If
such a filter is applied,
it overrides this field
set.

Service Controls the fields that appear

Appointment when a user hovers on the
List Preview appointment information
icon.

197
Field Service Lightning Customize the Dispatcher Console

Field Set Description Location in Dispatcher Console

Service Controls the fields displayed
Appointment on the tooltip when a user
Resource hovers over an appointment
Calendar on the service resource.
Tooltip

Service Appt Controls the fields displayed

Resource on appointments on the
Calendar service resource calendar
Display Visualforce page.

198
Field Service Lightning Customize the Dispatcher Console

Field Set Description Location in Dispatcher Console

Service Info Controls the layout of the
Window Map dialog screen displayed when
the user double-clicks an
appointment on the map.

Service Controls the layout of the

Lightbox dialog screen displayed when
the user double-clicks an
appointment on the Gantt.

Service Controls which fields are

Lightbox displayed under Address
Address when a user double-clicks a
service appointment in the
Gantt.

199
Field Service Lightning Customize the Dispatcher Console

Field Set Description Location in Dispatcher Console

Service Controls which fields are
Lightbox Time displayed under Date & Time
when a user double-clicks a
service appointment in the
Gantt.

Service Tooltip Controls the tooltip layout

Gantt shown when hovering over
an appointment on the Gantt.
This field set supports up to
10 fields.

Service Resource Field Sets

Field Set Description Placement in Dispatcher Console

Crew Controls the fields shown
Management when a user double-clicks a
Resource service resource in the Crew
Lightbox Management Gantt.

200
Field Service Lightning Customize the Dispatcher Console

Field Set Description Placement in Dispatcher Console

Emergency Controls the fields displayed
Fields for a service resource in the
Emergency Chatter action.

Get Controls the fields shown

Candidates when expanding a resource
Resource row on the Candidates
Details Chatter action.

201
Field Service Lightning Customize the Dispatcher Console

Field Set Description Placement in Dispatcher Console

Resource Controls the available fields
Gantt Filter in Gantt Resource Filters.
The fields are shown in
these sections:
• Sort by
• Checkbox filters (if the
field is of type
Checkbox)
• One of the following
properties picklist (if the
field is of type Picklist)

Resource Controls the layout of the

Lightbox dialog screen displayed
when the user double-clicks
a service resource in the
Gantt.

202
Field Service Lightning Customize the Dispatcher Console

Gantt Lightbox

Field Set Description Placement in Dispatcher Console

Account Controls the layout of the
dialog screen displayed
when a user double-clicks
an appointment on the
Gantt and clicks the
Account tab.

Work Order Controls the layout of the

dialog screen displayed
when the user
double-clicks an
appointment on the Gantt,
and then clicks the Work
Order tab. Applies only to
service appointments
whose parent record is a
work order.

Work Order Line Controls the layout of the

Item dialog screen displayed
when the user
double-clicks an
appointment on the Gantt,
and then clicks the WOLI
tab. Applies only to service
appointments whose
parent record is a work
order line item.

203
Field Service Lightning Customize the Dispatcher Console

Resource Absence Field Sets

Field Set Description Placement in Dispatcher Console

Resource Absence Calendar Controls the
Tooltip fields displayed
on the tooltip
when the user
hovers over an
absence on the
service resource
calendar
Visualforce page
on a service
resource record.

Resource Absence Lightbox Controls the

layout of the
dialog screen
displayed when
a user
double-clicks a
resource absence
on the Gantt.

Resource Absence Controls the

Resource Calendar fields displayed
on absences on
the service
resource
calendar
Visualforce page.

204
Field Service Lightning Customize the Dispatcher Console

Create Custom Actions for the Dispatcher Console

Put the right actions at your dispatchers’ fingertips by adding custom actions to the dispatcher
EDITIONS
console. Custom actions can either call an Apex class or open a Visualforce page, and can be run
on records in several areas of the dispatcher console. To keep the dispatcher console tidy, actions Available in: Salesforce
are shown in dropdown action lists with icons. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
You can add custom actions to several areas in the dispatcher console:
core features, managed
• Individual or multiple appointments in the appointment list package, and mobile app
• Individual or multiple appointments in the Gantt are available in Enterprise,
Performance, Unlimited,
• Individual service resources or resource absences in the Gantt
and Developer Editions.
• Polygons on the map (the action runs on the appointments within a polygon) Work orders are also
For example, create an action that does one of the following things: available in Professional
Edition.
• Calls an Apex class that reassigns all selected service appointments to a different service resource
• Opens a Visualforce page where the dispatcher can update the Earliest Start Permitted on all
appointments within a polygon—for example, if the polygon represents a flood in the service USER PERMISSIONS
territory
To define, edit, delete, set
1. Decide what you want your action to do and where it appears on the Gantt. security, set version settings,
and run tests for Apex
2. Create an Apex class or Visualforce page to connect to an action. classes:
Apex classes or Visualforce pages intended for custom dispatcher console actions must be • Author Apex
configured a certain way. For details, see Code Samples: Custom Dispatcher Console Actions.
To create and edit
3. Create and assign a custom permission to limit who sees the action, or select an existing Visualforce pages:
permission to use. • Customize Application
To create custom
4. From the App Launcher, find and open the Field Service Admin app. Click the Field Service
permissions:
Settings tab, and then click Dispatcher Console UI > Custom Actions.
• Manage Custom
5. In the left-hand column, select an action category to define the location and breadth of the Permissions
action. To add custom actions to the
6. Click New Action and enter your details. dispatcher console:
• FSL Admin permission
• Label in Dispatcher Console: Enter the action label that dispatchers see in the dispatcher set
console.
• Action Type: Select Apex Class or Visualforce.
• Apex Class: If you selected Apex Class as the type, select the Apex class that you want the action to call.
• Visualforce Page: If you selected Visualforce as the type, select the Visualforce page that you want the action to open.
• Required Custom Permission: Select the custom permission that users must have to see the action.
• Icon: Select an icon to display next to the action label.

7. Click Save.
8. Optionally, reorder the actions in the action category you selected. Custom actions appear in this order in an action list after standard
actions.
When you create or edit a custom action, the Gantt must be refreshed for the changes to take effect.

205
Field Service Lightning Customize the Dispatcher Console

Create Custom Appointment List Filters

USER PERMISSIONS EDITIONS

To configure the Field Service Lightning Customize Application Available in: Salesforce
managed package: Classic and Lightning
Experience
To assign a permission set license: Manage Users
The Field Service Lightning
To create a permission set: Manage Profiles and Permission Sets
core features, managed
To create, edit, and delete custom filters: FSL Dispatcher or FSL Admin Permissions package, and mobile app
are available in Enterprise,
AND
Performance, Unlimited,
Create Filter custom permission and Developer Editions.
Work orders are also
To share personal custom filters and edit FSL Dispatcher or FSL Admin Permissions available in Professional
and hide public custom filters: AND Edition.

Create Filter custom permission

AND
Publish Filter custom permission

Create custom filters to control which appointments appear in the dispatcher console service appointment list. Base your filters on
service appointment fields and add custom logic. Dispatchers can create private filters or share them with others.

This is a Field Service Lightning managed package feature.

1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab. Click Dispatcher
Console UI and select Enable Custom Filters.

Note: The custom filters feature replaces the appointment list’s original custom list view functionality. Enabling custom filters
removes any existing custom list views.

2. To open the dispatcher console, from the App Launcher, find and open the Field Service app.
3. To the right of the filter dropdown menu, click the New icon.
4. Add a filter name and description.
5. Choose whether the filter displays appointments based on the number of days before and after the horizon date, or appointments
currently shown on the Gantt (similar to the Gantt standard filter).

Note: The horizon date related to the selected date properties and the Earliest Start Permitted, Due Date, Arrival Window
Start, Arrival Window End, Scheduled Start, and Scheduled End fields.
• Standard filters let you set the scheduling window limit and the number of days up to and including the selected horizon
date. The default value is 14 days.
• Custom filters let you specify how many days to display before and after the horizon date.

6. Add criteria to your filter.

Note: The Gantt Filter field set on the service appointment object controls which fields are shown. Standard and custom
service appointment fields are supported.

206
Field Service Lightning Customize the Dispatcher Console

7. To filter appointments that are causing rule violations, add the Rule Violations criteria to your filter. To exclude rule violators, add
Rule Violations Equals False. To include rule violators, add Rule Violations Equals True.
8. Adjust filter logic.

Tip: To dynamically consider date and time fields, use formula fields. For example, Due date in 2 days Equals True.

9. Under Fields to Display, select fields to show in the appointment list when the filter is applied.
10. To publish or share your filter, select Make this filter available for all users.
When a custom filter is made public, it is shared with the All Internal Users public group.

11. Click Save.

12. To hide a public custom filter, click the down arrow next to the filter and select Hide.

Note: Admins can expose hidden filters by editing the custom filter record itself and setting Hidden to false.

Considerations
• The maximum number of days before and after the horizon date is 30 days.
• To avoid performance issues, we recommend keeping the number of fields on the Gantt Filter page layout below 15.
• All users have access to the standard filters provided with the managed package, but you can hide them. Remove the appropriate
custom permission from the user profile or assigned permission set.
• If only certain users need access to a custom filter, share the custom filter record with the public group or users. For example, if only
San Francisco dispatchers need access to the “Bay Area Emergency Work” custom filter, create a private custom filter. Then, share
“Bay Area Emergency Work” with the San Francisco public group using standard sharing.

207
Field Service Lightning Customize the Dispatcher Console

Create Custom Appointment Icons

Add custom icons to service appointments on the Gantt, map, and appointment list so dispatchers
EDITIONS
can quickly identify appointment characteristics. For example, use a custom icon to indicate that
an appointment is for a VIP or first-time customer. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
The Gantt is chock-full of information. Icons are a great way to share information without cluttering
The Field Service Lightning
your screen. While icons are set at the individual appointment level, you can set up triggers to
core features, managed
populate the Gantt Icon field on appointments of a certain type.
package, and mobile app
1. Add the Gantt Icon field to service appointment page layouts. are available in Enterprise,
2. Navigate to the service appointment that needs the icon. Performance, Unlimited,
and Developer Editions.
3. In the Gantt Icon field, enter an icon URL. The URL must end in an image suffix, such as .png or Work orders are also
.gif. We scale the image to 16 x 16 pixels, so square images look best. available in Professional
4. Save your changes. Dispatchers can see the icon on the appointment in the Gantt and the Edition.
dispatcher console map. Images with a transparent background appear with a white background.
In the appointment list, you can also include columns that show Gantt or custom icons. For example, USER PERMISSIONS
set up a formula field that selects an icon image. Add the fields to show in the Service Appointment
List Columns field set. To create a custom Gantt
icon: One of the following:
Example: Add an ice cream icon to an appointment that’s next to your favorite ice cream • Custom permission set:
shop. Find a URL that leads to an ice cream icon, and paste the link into the appointment’s FSL Admin Permissions
Gantt icon field. (Of course, we recommend scheduling a snack break after the appointment.) • Custom permission set:
FSL Dispatcher
Permissions
• Read and Edit on service
appointments

208
Field Service Lightning Work in the Dispatcher Console Appointment List

Work in the Dispatcher Console Appointment List

The service appointment list on the left side of the dispatcher console contains a list of service
EDITIONS
appointments. You can filter, sort, and search within the list, and perform actions on selected
appointments. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
From within the appointment list, you can:
The Field Service Lightning
• View the scheduling policy that’s currently applied, and apply a new one core features, managed
• Select the date fields that are considered when filtering appointments to show on the Gantt package, and mobile app
• Customize the Gantt’s time frame by adjusting its horizon or opting to make the appointment are available in Enterprise,
Performance, Unlimited,
list match the Gantt’s date range
and Developer Editions.
• Schedule and dispatch service appointments Work orders are also
• Optimize your schedule available in Professional
• Flag and unflag appointments Edition.

• Filter the appointment list based on a search query or appointment status

• Filter the appointment list by service territory
• Show icons and appointment details to communicate information quickly
• Customize the dispatcher console settings by clicking the gear icon in the top right-hand corner of the list

Search the Appointment List

To search within the appointment list, enter two or more characters in the search field. Separate multiple keywords with a comma, which
applies an OR condition to the search.
When you enter a query, the list updates to show only service appointments with at least one matching property. If no appointments
match your query, click Search All Recordsin the body of the list to search all appointments in your org. From the resulting list of
appointments, you can force-add an appointment to the list that doesn’t match the Gantt loading criteria. The Search All Records
action only supports search queries of a complete service appointment number or record ID.
These service appointment fields are scanned in searches:
• Service Appointment Number
• Gantt Label
• Account Name
• Assigned Resource Name
• Service Appointment ID
• Service Territory Name
• SA Status
• Fields in the Service Appointments List Columns field set that is of the following types: text, text area, lookup name, and picklist

Filter the Appointment List

Filters, similar to list views, control which service appointments are shown in the appointment list. The list is also filtered based on the
horizon, selected date fields, and search values.
Apply a filter by selecting one from the filter dropdown menu in the appointment list (1). Select appointments using different filters.
Click the link to see the selected list (2)

209
Field Service Lightning Work in the Dispatcher Console Appointment List

You can choose from the following filters. All users have access to these filters. The filters consider the status category, which maps all
standard and custom status values to categories corresponding to the default status values. Conditions have an OR statement between
them.

Filter Name Definition

Todo Service appointments that are awaiting an action from the
dispatcher. It includes appointments that match one of these
criteria:
• The status category is None
• The appointment has rule violations
• The appointment is In Jeopardy and is not Canceled or
Completed

All Service Appointments All service appointments in the org.

Selected Service appointments that the user selected in the appointment

list.

Flagged Service appointments that the user marked as flagged. Flags aren’t
saved when the dispatcher console is reloaded.

Recent Service appointments that were recently interacted with via

scheduling, dragging, Chatter posts, status changes, the Get
Candidates action, the Show on Gantt action, and the Open Details
action.

Note: Recent service appointments aren’t saved when the

dispatcher console is reloaded.

Unscheduled Service appointments that don’t have an assigned resource and

aren’t canceled.

Rules Violating Service appointments that have rule violations and aren’t canceled.

In Jeopardy Service appointments that are marked In Jeopardy and aren’t

canceled.

Scheduled Service appointments with an assigned resource.

210
Field Service Lightning Work in the Dispatcher Console Appointment List

Filter Name Definition

Gantt Service appointments that are currently shown on the Gantt, which
means they have one or more assigned resources and fall within
the defined time frame.

Contractors Service appointments that are scheduled to capacity-based

resources.

Canceled Service appointments whose status category is Canceled.

Tip:
• Create custom filters for the appointment list.
• To filter the appointment list by territory, click the gear icon in the appointment list and select Territory filtering.

Mass-Edit Appointments
To modify multiple appointments in the appointment list, select the desired appointments. Then, open the Actions menu and select an
action:

Action Definition
Schedule Execute an automatic scheduling process for the selected
appointments.

Dispatch Dispatch the selected appointments.

Change Status Change the status of the selected appointments.

Flag / Unflag Add or remove a flag for the selected appointments. You can use
the flag for filtering later.

Unschedule Unschedule the selected appointments, or define the relevant time

range and service territories of the appointments that must be
unscheduled.

Optimize Optimize the selected appointments. You’re given the option to

select a scheduling policy and filter the selected appointments
before running the optimization.

To customize the list of actions, from the App Launcher, find and open the Field Service Admin app. Click Field Service Settings >
Dispatcher Console UI > Gantt Configurations, and scroll to the section where you can reorder, add, or remove actions.

Tip: To limit dispatchers’ mass-edit options, remove the Bulk Dispatch, Bulk Optimize, Bulk Schedule, or Bulk Unschedule custom
permissions from their user profiles.
If you create custom dispatcher console actions in the Service List category, those actions appear below the built-in actions in the action
list.

211
Field Service Lightning Work in the Dispatcher Console Appointment List

Customize the Appointment List

Field sets control the fields and field order of the appointment list layout. For help, see Customize the Dispatcher Console with Field
Sets.
To use background shading in the appointment list, click the gear icon in the top-right corner and select Dispatch Console Settings.
In the Appointment List Color-Coding field, select an option:

Color-Coding Setting Definition

Default Apply a white background to appointments in the list

Full Shading Apply a flat background color

Horizontal Gradient Apply a gradient background color

Note:
• By default, an appointment’s color on the Gantt and appointment list is based on its status. However, Gantt palettes and the
Gantt Color field on service appointments override the default color scheme.
• Regardless of the appointment list color-coding setting, appointments with rule violations are highlighted in the appointment
list in yellow and in-jeopardy appointments are highlighted in red.

Highlight Filtered Appointments on the Gantt

Quickly spot the appointments shown in the appointment list on the Gantt. Select an appointment list filter or enter a search term, and
then click Highlight in the appointment list. All appointments and absences not shown in the list appear faded on the Gantt. Click the
X icon to remove the highlighting.

212
Field Service Lightning Work in the Dispatcher Console Gantt

Work in the Dispatcher Console Gantt

The Gantt is located on the right side of the dispatcher console and contains the resource list, the
EDITIONS
schedule view, and additional features.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
IN THIS SECTION:
The Field Service Lightning
Filter the Gantt core features, managed
Customize the Gantt’s contents by filtering it based on service resource settings, skills, utilization, package, and mobile app
hours, and other features. are available in Enterprise,
Performance, Unlimited,
Filter the Gantt by Service Territory
and Developer Editions.
The Gantt territory filter controls which appointments are shown in the Gantt and appointment Work orders are also
list. In a field service operation with numerous service territories, the faster you can control available in Professional
which territories are shown, the better! Edition.
Gantt Keyboard Shortcuts
Use keyboard shortcuts to work faster in the dispatcher console.
View Resource Utilization
To make smarter scheduling and hiring decisions, view your service resources’ individual utilization percentages. You can see each
resource’s utilization percentage for a particular day or over multiple days, and sort resources in the Gantt by utilization.
Color-Code the Gantt
Help dispatchers compare service appointments in the dispatcher console Gantt and map at a glance by creating custom color
palettes based on a service appointment field. For example, create a palette that displays appointments in a custom color spectrum
based on the proximity of the due date.
View Service Crews on the Gantt
Control how service crews are displayed on the Gantt in the Field Service Lightning dispatcher console.
View Resource Absences on the Gantt and Map
To make things easier for your dispatchers, hide unapproved absences on the Gantt and show resource absences on the dispatcher
console map.
View Appointment KPIs on the Gantt
Assess the health of your field service operation at a glance with the help of the Gantt KPI (Key Performance Indicator) bar.
Check Rule Violations on the Gantt
Rule violations occur when a service appointment doesn’t follow predefined scheduling rules. Examples of rule violations include
travel time conflicts and appointments that are not scheduled between their Earliest Start Permitted and Due Date.
Turn On Gantt Live Updates
Choose to have the Gantt auto-refresh at a specified frequency so dispatchers don’t have to rely on timed updates. Gantt Live Updates
relies on the Salesforce Streaming API.

213
Field Service Lightning Work in the Dispatcher Console Gantt

Filter the Gantt

Customize the Gantt’s contents by filtering it based on service resource settings, skills, utilization,
EDITIONS
hours, and other features.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
To open your filter settings, click the filter icon in the top left-hand corner of the Gantt. By default, Experience
the Gantt is sorted by service resource name.
The Field Service Lightning
core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Filter Tab Description

Hours Select a range of hours to show. The date resolution determines the Gantt time interval and how
available hours appear. For example, when you select a date resolution of 3 Days, the Gantt shows
resource availability across 4-hour intervals; it displays intervals with full or partial availability that are
within filtered hours. For In-Day, the Gantt shows half-hour intervals and ignores the filter for which
hours to show.
You can turn on options to display or highlight weekends. For views that are less than weekly, the
Gantt always shows weekend days. When you turn on the option to show weekends, the Gantt
displays weekend days for date resolutions of weekly or longer.

Note: A setting In Field Service Settings > Dispatcher Console UI lets you configure
Sunday or Monday as the start of the week.
At the bottom of the tab, you can customize the Long-Term view:
• Choose whether to show only multiday appointments

214
Field Service Lightning Work in the Dispatcher Console Gantt

Filter Tab Description

• Enter the number of months to display (up to 6)
• Hide appointments and absences under a certain length
(To reach the long-term view, select Long-Term in the top-right corner of the Gantt. You need the
Longterm View custom permission to access it.)

Resources Specify which service resources are shown and in what order. Select Show working resources only
in the filter box to show only resources that are assigned to appointments in the dates shown on
the Gantt. To add more filterable fields to the Resources tab, update the Resource Gantt Filter field
set.

Skills Select skills that resources must possess to be shown on the Gantt. Change the Filter Logic to OR to
display resources with one or more of the selected skills. The Skills filter supports up to 2,000 skills.

Note: When the Gantt’s resource skill filter runs, only 50 skills are considered for each service
resource. This means that service resources with more than 50 skills may not appear when
you filter for a skill that they possess. This limit applies only to the Gantt resource skill filter;
the Candidates action finds all resources with the skills you need.
The Skills filter resets when you refresh the dispatcher console.

Utilization Select the factors that are considered when calculating resource utilization, and control the days
shown in the utilization view. (To reach the utilization view, select Utilization in the top-right corner
of the Gantt.)

Palettes Create, manage, and apply palettes to color-code service appointments on the Gantt and map. Click
the icon in the top-right corner to open the palette editor.

Filter the Gantt by Service Territory

The Gantt territory filter controls which appointments are shown in the Gantt and appointment
EDITIONS
list. In a field service operation with numerous service territories, the faster you can control which
territories are shown, the better! Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
To filter the Gantt by service territory, click the territory filtering icon at the top of the appointment
The Field Service Lightning
list.
core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

215
Field Service Lightning Work in the Dispatcher Console Gantt

Then, select territories whose service resources and service appointments you want to see.
• Optionally, select Show service appointments not associated with a territory. These appointments can then be scheduled
within any of the selected service territories.
• If your organization contains many territories, click the star next to a frequently used service territory to add it to your favorites. Click
the Favorites tab to view your favorites.
• Hover over a territory and click Switch to deselect all territories and select only that territory.
• Click Save to apply the filter and return to the appointment list.

Note: Service territories without assigned resources are shown on the appointment list but not on the Gantt. If you have access
to 2,000 or more service territories, the appointment list shows only selected territories. Use the search bar to find territories that
aren't selected.

View Secondary Service Territory Memberships on the Gantt

If service resources are assigned to more than one territory, you can choose to show secondary service territory memberships on the
Gantt.
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
2. Click Dispatcher Console UI > Gantt Configurations.
3. Select Show secondary Service Territory Members on Gantt chart, and save your changes.
4. From Setup, enter Permission Sets in the Quick Find box. Select Permission Sets under Users.
5. Click FSL Dispatcher Permissions.
6. In the Apps section, click Custom Permissions.
7. Click Edit.
8. Add the FSL.View Resource on secondary STM custom permission to the FSL Dispatcher permission set.
9. Click Save.
If you show secondary territory memberships on the Gantt, keep these considerations in mind.
• When the Candidates action is used, secondary territory members are flagged with a green icon.
• When service appointments are dragged onto the Gantt, the time slots are filled on both of the service resource’s rows.
• Territory utilization calculation doesn’t consider secondary territory members.
• When Gantt visibility is back on time zones, only secondary territory memberships with the same time zone are visible. If the primary
territory is filtered out, the secondary territory memberships are still visible.

216
Field Service Lightning Work in the Dispatcher Console Gantt

Gantt Keyboard Shortcuts

Use keyboard shortcuts to work faster in the dispatcher console.
EDITIONS
Command Description Keyboard Shortcut Available in: Salesforce
Flag or unflag a service Flagged appointments appear Select service appointment, Classic and Lightning
appointment with a flag icon on the Gantt. then F Experience

The Field Service Lightning

Open parent work order or Opens the record in the Work Select service appointment,
core features, managed
work order line item record Orders tab, outside of the then W
package, and mobile app
Gantt.
are available in Enterprise,
Open service appointment Opens the record in the Service Select service appointment, Performance, Unlimited,
record Appointments tab, outside of then S and Developer Editions.
the Gantt. Work orders are also
available in Professional
Open service appointment Opens a lightbox over the Select service appointment, Edition.
details Gantt with tabs containing then Enter
details about the appointment
and its parent record, related
records, map, and more.

Close service appointment Closes the lightbox. Esc

lightbox

Move a scheduled service You can drag an appointment Windows: Select service
appointment to a new spot in to a different spot in its appointment+Ctrl+drag
the schedule, allowing for assigned resource’s schedule macOS: Select service
travel time or to another resource’s row to appointment+Cmd+drag
reassign it. When an
appointment is dragged, it
snaps to the closest valid time
slot based on your Gantt drag
jump setting and on the
calculated travel time between
adjacent appointments or
absences. Configure your drag
jump setting in the Field
Service Admin app (Field
Service Settings >
Dispatcher Console UI).

Show today on the Gantt If the Gantt is configured to T

show multiple days, today is
the first day shown.

Switch to In Day view Changes the Gantt resolution 0 (zero)

to In Day.

Switch to Daily view Changes the Gantt resolution 1

to Daily.

217
Field Service Lightning Work in the Dispatcher Console Gantt

Command Description Keyboard Shortcut

Switch to 2 Days view Changes the Gantt resolution to 2 Days. 2

Switch to 3 Days view Changes the Gantt resolution to 3 Days. 3

Switch to Weekly view Changes the Gantt resolution to Weekly. 7

Switch to Multiday view Changes the Gantt resolution to Multiday. M

Switch to Utilization view Changes the Gantt resolution to Utilization. U

Scroll one day back For example, if you’re viewing the August Left Arrow
6 schedule, this shortcut switches the Gantt
to August 5.

Scroll one day forward For example, if you’re viewing the August Right Arrow
6 schedule, this shortcut switches the Gantt
to August 7.

Scroll one time period back For example, if you’re in the Weekly view, Shift+Left Arrow
this shortcut switches the Gantt to the
previous week.

Scroll one time period forward For example, if you’re in the 2 Days view, Shift+Right Arrow
this shortcut switches the Gantt to the next
two days.

Scroll up in schedule Scrolls up one row in the Gantt without Up Arrow

changing the dates shown.

Scroll down in schedule Scrolls down one row in the Gantt without Down Arrow
changing the dates shown.

View Resource Utilization

To make smarter scheduling and hiring decisions, view your service resources’ individual utilization
EDITIONS
percentages. You can see each resource’s utilization percentage for a particular day or over multiple
days, and sort resources in the Gantt by utilization. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
A service resource’s utilization is calculated by comparing their total operating hours to the number
The Field Service Lightning
of hours they’re scheduled to work. Utilization is calculated only for non-capacity-based service
core features, managed
resources.
package, and mobile app
are available in Enterprise,
Calculate Utilization Performance, Unlimited,
and Developer Editions.
To determine which factors are considered when calculating a resource’s utilization, click the Gantt
Work orders are also
filter icon and click the Utilization tab. Deselect factors that you don’t want to be used in the available in Professional
calculation. Edition.
When all factors are selected, utilization is calculated using the following equation: (Service
Appointments + Absences + Breaks + Travel Time) / (Overtime Hours + *Normal Hours*)

218
Field Service Lightning Work in the Dispatcher Console Gantt

• SA = Scheduled service appointments

• Absences = Resource absences of type Absence
• Breaks = Resource absences of type Break
• Overtime Hours = Time slots of type Extended in the resource’s operating hours for its primary service territory
• Normal Hours = Time slots of type Normal in the resource’s operating hours for its primary service territory
For example, if a resource’s operating hours add up to 20 hours per week and they’re scheduled to work 10 hours in a particular week,
their average utilization for the week is 50%.

View Utilization on the Gantt

The Gantt provides a bird’s-eye view of your team’s utilization percentages. To turn on the utilization view, select Utilization in the
Gantt resolution field in the top-right corner.

From the utilization resource view, you can:

• View each resource’s average utilization over the days in the utilization view
• View a resource’s utilization for a particular day
• Click an event name to view its details
• Flag service appointments
• Click the date on the vertical axis to switch to the date’s daily view
Here’s how to customize the utilization display settings.
Change the number of days in the utilization view
The utilization view can show 1–31 days. To switch from the default of 31 days, click the Gantt filter icon, then click Utilization and
enter your preferred number of days (1). Each resource’s Average Utilization (2), shown beneath their name in the resource list, is
an average of their daily utilization percentage across the days shown in the utilization view.
Sort the resource list by average utilization
Sorting resources by their average utilization helps you identify which resources need more or fewer appointments. Click the Gantt
filter icon, then click Resources. In the Sort by field, select Average Utilization.
Customize the utilization-based color code
Resources in the resource list are shown in green, yellow, or red depending on their utilization percentage. To define the limits for
these three colors, from the App Launcher, find and open the Field Service Admin app. Click Field Service Settings > Dispatcher

219
Field Service Lightning Work in the Dispatcher Console Gantt

Console UI > Gantt Configurations. Under Utilization Views, enter the number of hours that indicate High Utilization (default:
150), Medium Utilization (default: 100), and Extensive Travel (default: 33). In the utilization view:
• Resources whose schedules are below Medium Utilization appear in green.
• Resources whose schedules are between High and Medium Utilization appear in yellow.
• Resources whose schedules are above High Utilization appear in red.
• Resources whose percentage of travel is larger than the value you specify are considered Extensive Travel candidates, and appear
with an automobile icon.
Show each territory’s average daily utilization
Control when utilization information is shown for territories on the Gantt. From the App Launcher, find and open the Field Service
Admin app, and then click Field Service Settings > Dispatcher Console UI > Gantt Configurations. Select Show utilization
on the Gantt to show each territory's average daily utilization on the Gantt for all Gantt resolutions. If this option isn't selected,
utilization information is shown only when the Gantt resolution is set to Utilization.
If a service resource is capacity-based with a defined capacity, their utilization percentage isn’t shown in the Gantt. However, their row
in the Gantt displays an icon that shows how close they are to reaching their capacity.

220
Field Service Lightning Work in the Dispatcher Console Gantt

Color-Code the Gantt

Help dispatchers compare service appointments in the dispatcher console Gantt and map at a
EDITIONS
glance by creating custom color palettes based on a service appointment field. For example, create
a palette that displays appointments in a custom color spectrum based on the proximity of the due Available in: Salesforce
date. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
You can base a palette on any service appointment field of the following types: checkbox, picklist,
core features, managed
date, date-time, number, percent, or currency. Use the Due Date Approaching palette to color-code
package, and mobile app
appointments based on how close they are to the due date. Create and manage palettes directly
are available in Enterprise,
from the Gantt.
Performance, Unlimited,
1. From the App Launcher, find and open the Field Service app. Click the Field Service tab to and Developer Editions.
open the dispatcher console. Work orders are also
available in Professional
2. Click the filter icon at the top of the Gantt, and then click the Palettes tab.
Edition.
3. Click the icon in the top-right corner to open the palette editor, and click New Palette.
4. Enter a name and description. USER PERMISSIONS
5. Select which service appointment field to base the palette on.
To create, edit, and delete
6. Define the color spectrum. We recommend creating a high-contrast spectrum to accommodate Gantt palettes:
color-blind users. • Gantt Palettes Edit
• For picklist fields, assign a color to each picklist value. custom permission

• For checkbox fields, select two colors signifying checked and unchecked. To view the Palettes tab in
the Gantt and apply a
• For numeric or date-based fields, choose how many colors to use, a minimum and maximum palette:
color, a color if no value is specified, and a corresponding minimum and maximum value. • Gantt Palettes View
The palette editor then creates a spectrum for you. custom permission

7. Select Active to make the palette available to dispatchers.

8. Save your palette.
9. Apply a palette from the Palettes tab in the Gantt filter.
a. Select a palette in the dropdown list, and click Apply Palette. The list shows the 10 last modified active palettes in the org.
Applying a palette changes the background color of appointments on the Gantt and adds an appropriately colored horizontal
bar above appointments on the map.
b. After a palette is applied, you can click Use Default Palette to return to the default color scheme.

The default color scheme—used when no palette is applied—color-codes appointments by status. You can’t update the default color
scheme or replace it with a custom palette. Reloading the Gantt or changing which service appointments are shown in the appointment
list reverts it to the default color scheme.
The Gantt Color field on service appointments and service crews overrides the default color scheme. If you don’t like the default color
scheme, create a process in Lightning Process Builder that populates the Gantt Color field based on your preferred service appointment
field.
Users with the Gantt Palettes View permission can see all palettes created in your org. To control palette access, set sharing on the Gantt
Palette object to Private. Then, use sharing rules to share each palette with the appropriate users.

221
Field Service Lightning Work in the Dispatcher Console Gantt

Tip: Create multiple palettes to address different scheduling questions. For example, use custom fields to create palettes that do
the following:
• Highlight appointments for VIP customers
• Color-code appointments based on service cost
• Color-code appointments based on the priority level of their parent work order

View Service Crews on the Gantt

Control how service crews are displayed on the Gantt in the Field Service Lightning dispatcher
EDITIONS
console.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Show One Crew The Field Service Lightning
In the resource list, click Show Crew on a service resource of type Crew to leave only the Crew and core features, managed
its members on the Gantt and hide other resources. Click Hide Crew View to return to the regular package, and mobile app
display. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

The Gantt displays each service crew member’s Gantt Label value. If the field is blank on a service crew member record, it defaults to
the service crew name + “Crew Member.” For example, Alpha Team Crew Member.

222
Field Service Lightning Work in the Dispatcher Console Gantt

Show or Hide Crews

To customize the way crews are shown on the Gantt, click the Gantt filter icon. Click the Resources tab, and then select one of the
following values in the Crews filtering field.

• Show all: Do not filter based on crew properties.

• Hide Service Crew Members: Show only service resources of type Crew and service resources of type Technician who are not
allocated to crews in the time frame open on the Gantt.
• Show Crews and their Service Crew Members: Show only service resources of type Crew and service resources of type Technician
who are allocated to those crews in the time frame open on the Gantt.
• Show only Crews: Show only service resources of type Crew.
• Hide Crews and Service Crew Members: Show only service resources of type Technician that are not allocated to a crew in the
time frame open on the Gantt.

Customize Crew Color

Optionally, display a service crew in a particular color on the Gantt by entering a hex code in the Gantt Color field on the crew. For
example, set the Gantt color to green (#008000) for all service crews that use a company vehicle. Crews without a defined Gantt color
appear in purple.
Here, we’ve entered #ff0000 in the Gantt Color field for the Vipers crew, and haven’t specified a color for the Diamondbacks crew.

223
Field Service Lightning Work in the Dispatcher Console Gantt

View Resource Absences on the Gantt and Map

To make things easier for your dispatchers, hide unapproved absences on the Gantt and show
EDITIONS
resource absences on the dispatcher console map.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
1. Hide unapproved absences on the Gantt. Experience
When approval confirmation is enabled, only approved absences can block a technician’s
The Field Service Lightning
availability and appear on the Gantt. Unapproved absences aren’t considered in scheduling or core features, managed
shown on the Gantt. package, and mobile app
Note: If the Multiday view is selected, resource absences don't appear on the Gantt. are available in Enterprise,
Performance, Unlimited,
a. Create an approval process for absences that checks the FSL__Approved__c field. and Developer Editions.
Work orders are also
b. To avoid confusion, approve all existing absences.
available in Professional
c. From the App Launcher, find and open the Field Service Admin app, and then click the Edition.
Field Service Settings tab.
d. Click Scheduling > General Logic and select Activate approval confirmation on USER PERMISSIONS
resource absences.
To customize the Field
e. Save your changes. Service Lightning managed
package:
2. Show resource absences on the map.
• Customize Application
Absences are shown on the dispatcher console map with a purple icon and the planned route
to and from the absence address. If this option isn’t selected, absence length is added to the
travel time of adjacent service appointments, which can be confusing for dispatchers.

224
Field Service Lightning Work in the Dispatcher Console Gantt

Note: A resource absence must be properly geocoded by data integration rules—meaning it needs a latitude and longitude—to
appear on the map.
a. From the App Launcher, find and open the Field Service Admin app, and then click the Field Service Settings tab.
b. Click Dispatcher Console UI > Gantt Configurations and select Show absences on resource map.

3. Save your changes.

View Appointment KPIs on the Gantt

Assess the health of your field service operation at a glance with the help of the Gantt KPI (Key
EDITIONS
Performance Indicator) bar.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
The KPI bar includes five indicators and can be found in the top-right corner of the Gantt. Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

The indicators are, from left to right:

225
Field Service Lightning Work in the Dispatcher Console Gantt

• Total scheduled time (workload) of all loaded service territories

• Average travel time per service appointment of all service appointments shown on the Gantt
• Number of completed service appointments out of all service appointments shown on the Gantt
• Number of service appointments on the Gantt with rule violations
• Number of service appointments on the Gantt that are In Jeopardy

Check Rule Violations on the Gantt

Rule violations occur when a service appointment doesn’t follow predefined scheduling rules.
EDITIONS
Examples of rule violations include travel time conflicts and appointments that are not scheduled
between their Earliest Start Permitted and Due Date. Available in: Salesforce
Classic and Lightning
This is a Field Service Lightning managed package feature.
Experience
The scheduling policy selected at the top of the appointment list controls which rules are applied.
The Field Service Lightning
If a rule violation occurs, the service appointment appears on the Gantt with a yellow triangle. Hover
core features, managed
over the appointment to view its details and violated rules.
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

When automatic scheduling is used—with the Schedule or Candidates action—rule violations don’t occur. Field Service Lightning
automatically formulates schedules that don’t violate rules, so rule violations occur only as a result of manual scheduling.

226
Field Service Lightning Work in the Dispatcher Console Gantt

Turn On Gantt Live Updates

Choose to have the Gantt auto-refresh at a specified frequency so dispatchers don’t have to rely
EDITIONS
on timed updates. Gantt Live Updates relies on the Salesforce Streaming API.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Important: Gantt Live Updates has the following limitations: Experience

• Dispatchers without the Streaming API custom permission get timed updates on the The Field Service Lightning
Gantt, as defined in your settings. core features, managed
• Live updates aren’t available to community dispatchers. package, and mobile app
are available in Enterprise,
• Gantt Live Update access isn’t automatically available to all admins, and too many live Performance, Unlimited,
update requests can cause the Gantt to crash. and Developer Editions.
• Gantt Live Updates are subject to org limits for event delivery and PushTopic Streaming Work orders are also
Allocations. available in Professional
Edition.
1. Update sharing settings so dispatchers receive notifications only about the data they have
access to.
USER PERMISSIONS
a. From the App Launcher, find and open the Field Service Admin app, and then click the
Field Service Settings tab. To configure the Field Service
Lightning managed
b. Click Dispatcher Console UI > Updating the Gantt.
package:
c. Under Live Updates, check that each object’s sharing setting is Private. If not, update the • Customize Application
object’s sharing setting to Private in Salesforce Setup.
To view live updates on the
Gantt:
2. On the same Updating the Gantt page, click Update push topics. Push topics are used to
• Streaming API custom
send event notifications on specified objects, fields, and criteria. Field Service Lightning creates
permission
push topics for the following objects.
• Service resource
• Resource absence
• Service appointment
• Assigned resource
• Service resource capacity
• FSL operation
• Optimization request

3. Select Gantt updates are enabled org wide.

4. Select Allow admins to use Gantt updates.
5. Save your changes.

227
Field Service Lightning Work in the Dispatcher Console Map

Work in the Dispatcher Console Map

The dispatcher console map gives dispatchers a dynamic bird’s-eye view of their mobile workforce.
EDITIONS
Learn how to customize the map view and draw territories directly on the map.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Note: Because Google Maps is restricted in China, Field Service Lightning features that Experience
depend on Google Maps don’t work there. To minimize errors and customize access for users
The Field Service Lightning
in China, see Disable Google Maps-based Field Service Lightning features for China users. core features, managed
package, and mobile app
IN THIS SECTION: are available in Enterprise,
Performance, Unlimited,
Customize the Map
and Developer Editions.
Control the information shown on the dispatcher console map. By default, the map shows Work orders are also
markers for all service resources whose appointments are loaded in the Gantt or appointment available in Professional
list. Edition.
Customize Icons and Colors for Reports
Give your reports contrast on the Gantt map by customizing their icons and colors. You can
map any tabular report that has geolocation fields.
Enable Map Polygons
Set up and configure map polygons so you can draw your own territories directly on the map.
Create and Manage Map Polygons
Draw your own territories directly on the map, then link them to your service territories. Polygons make it easy to mass-update all
appointments within a specific geographic area.
Import Service Territory Polygons in KML
Map polygons represent the physical boundaries of a service territory in Field Service Lightning. While you can draw a polygon on
the dispatcher console map, you can also import one in KML (Keyhole Markup Language). For example, cities may provide public
KML files so you can create service territories whose boundaries correspond exactly to the city borders.

Customize the Map

Control the information shown on the dispatcher console map. By default, the map shows markers
EDITIONS
for all service resources whose appointments are loaded in the Gantt or appointment list.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

228
Field Service Lightning Work in the Dispatcher Console Map

To navigate to the dispatcher console map, from the App Launcher, find and open the Field Service app, and then click Field Service.
Then, click the Map tab. To pop out the map and drag it anywhere within the dispatcher console, hover over the Map tab from the Gantt
and click .

Note: The dispatcher console map may appear different than the map displayed on service territory member detail pages because
of a difference in geocoding granularity. As a rule, the dispatcher console map is more accurate.

Choose What Information is Shown

Click Map Layers, which opens on the Markers tab. Select the information to display for selected service resources:
• Live Positions: When a service resource updates a service appointment’s status from their mobile device, their coordinates are
automatically recorded. Live Position shows the latest coordinates saved in the system.
• Homebase: The selected service resource’s home base, set on their detail page.
• Service Appointments: All service appointments that are assigned to the selected service resource and shown in the appointment
list.
• Service Territories: The resource’s service territories.

Choose Which Service Resources are Shown

Click Map Layers, then click the Service Resources tab. Use the search to select one or more service resources whose information you
want displayed on the map.

Display Report Data

Click Map Layers, then click the Reports tab. Select reports containing geolocation fields that you want to be displayed on the map.
This way, you can view location-based standard or custom objects as separate map layers.
Only tabular reports in the Field Service Reports folder appear in the Reports tab. By default, the markers’ icons on the map are styled as
the object type in the first column in the report. Up to 10 additional columns are visible inside the marker’s info window.
Up to 500 total report markers can be displayed on the Gantt map at one time. If a report has more than 500 markers, consider adding
more filters.

229
Field Service Lightning Work in the Dispatcher Console Map

Manage Map Polygons

Click Map Layers, then click the Polygons tab. Choose which polygons are displayed, customize their color-coding, and create new
polygons. You can also create and manage polygons from the Map Polygons tab in your Salesforce environment.

View Traffic Conditions

Click Traffic at the top of the map to show traffic conditions.

Customize Icons and Colors for Reports

Give your reports contrast on the Gantt map by customizing their icons and colors. You can map
EDITIONS
any tabular report that has geolocation fields.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
1. From the App Launcher, find and open the Field Service Admin app, and then click the Field Experience
Service Settings tab.
The Field Service Lightning
2. Click Dispatcher Console UI > Map. Under Report Styles, select a report. core features, managed
3. Select a color and an icon for the report, then click Add Report. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

USER PERMISSIONS

To configure the Field Service

Lightning managed
package:
• Customize Application
To customize icons and
colors for reports:
• FSL Admin Permissions

4. Click Save.

230
Field Service Lightning Work in the Dispatcher Console Map

5. From the App Launcher, find and open the Field Service app. To open the dispatcher console, click the Field Service tab.
6. Click Map > Map Layers > Reports.
7. Select a report and click Add Layer.

If you decide not to use customized icons and colors for your reports, they are mapped using the default style for that object type.

231
Field Service Lightning Work in the Dispatcher Console Map

Enable Map Polygons

Set up and configure map polygons so you can draw your own territories directly on the map.
EDITIONS
This is a Field Service Lightning managed package feature.
Available in: Salesforce
1. From Setup, enter Permission Sets in the Quick Find box, then select Permission Sets Classic and Lightning
under Users. Experience
2. Click FSL Dispatcher Permissions. The Field Service Lightning
3. In the Apps section, click Custom Permissions. core features, managed
package, and mobile app
4. Click Edit.
are available in Enterprise,
5. Add the following available custom permissions to the enabled custom permissions. Performance, Unlimited,
and Developer Editions.
• FSL.Polygons - create\update
Work orders are also
• FSL.Polygons - view available in Professional
Edition.
6. Click Save.

Tip: To give access to a selection of your users, create custom permission sets and assign
USER PERMISSIONS
these permissions to those users.
To configure the Field Service
7. Create a tab for the Map Polygon custom object. Lightning managed
8. From the App Launcher, find and open the Field Service Admin app, and then click the Field package:
Service Settings tab. • Customize Application

9. Click Service Appointment Life Cycle > Creation.

10. Select Use polygons to assign service territories.
11. Set the territory classification policy to Highest.
When there are parent-child relationships between service territories (for example, San Francisco and California), the service
appointment is assigned to the highest territory in the hierarchy (California). Select Lower if you want appointments to be assigned
to the lowest territory (San Francisco). Service appointments are never assigned to middle-tier territories.

Create and Manage Map Polygons

Draw your own territories directly on the map, then link them to your service territories. Polygons
EDITIONS
make it easy to mass-update all appointments within a specific geographic area.
Available in: Salesforce
This is a Field Service Lightning managed package feature.
Classic and Lightning
Experience
Create and Update Polygons The Field Service Lightning
After map polygons are enabled, you can draw polygons straight on the dispatcher console map core features, managed
or import them in KML (Keyhole Markup Language) format. package, and mobile app
are available in Enterprise,
1. To open the dispatcher console, from the App Launcher, find and open the Field Service app,
Performance, Unlimited,
and then click Field Service.
and Developer Editions.
2. Click the Map tab, and then click Map Layers. Work orders are also
3. Select Polygons. available in Professional
Edition.
4. Click New.

232
Field Service Lightning Work in the Dispatcher Console Map

5. Name your polygon and select a color.

6. Select a service territory.

Note: The service territory field is used during appointment scheduling. When a new service appointment is created, the
Service Territory field auto-populates based on the appointment’s address. When a service appointment address changes and
its Service Territory field is empty, the address is matched to a polygon and that polygon’s territory.

7. Draw your polygon on the map.

8. Click Save.
To import a polygon in KML—for example, a public KML file for a county or city—click the Map Polygons custom object tab in Salesforce
and click New. Add a name, color, description, and service territory. In the KML Details field, add your KML text.
Update polygons from the Map Polygons tab or the Polygons map layer.

Take Mass Actions on Polygons

From the dispatcher console map view, you can mass-edit all service appointments within a polygon. Right-click a polygon and select
one of the following actions.
• Schedule / Unschedule / Dispatch: Schedule, unschedule, or dispatch all service appointments within the polygon in the current
view.
• In Jeopardy: Set the In Jeopardy field to True for every service appointment within the polygon.
• Delete Polygon: Delete the polygon.
• Cut Intersections: Select a polygon and cut its intersections with other polygons. Select multiple polygons, then click Go to trim
the polygons so they no longer intersect.

Tip: Create custom actions to add to the actions list on polygons. For details, see Create Custom Actions for the Dispatcher Console.

Limits and Considerations

• A polygon can contain up to 3,200 coordinates.
• If your org contains more than 200 polygons, you may experience dispatcher console performance issues. To avoid these issues, set
the sharing of the Map Polygon object to Private and use sharing to expose only the relevant polygons to dispatchers.
• If a service appointment’s geolocation matches more than one polygon, the appointment is assigned to either the highest or
lowest-level territory in the hierarchy depending on your settings.
• When creating polygons, don’t create overlaps unless there are parent-child relationships between the corresponding service
territories (for instance, San Francisco and California). Service appointments are never assigned to middle-tier territories.
• If two or more polygons overlap and there's no hierarchy in place, service appointments are assigned to the first polygon that was
created.

233
Field Service Lightning Work in the Dispatcher Console Map

Import Service Territory Polygons in KML

Map polygons represent the physical boundaries of a service territory in Field Service Lightning.
EDITIONS
While you can draw a polygon on the dispatcher console map, you can also import one in KML
(Keyhole Markup Language). For example, cities may provide public KML files so you can create Available in: Salesforce
service territories whose boundaries correspond exactly to the city borders. Classic and Lightning
Experience
This is a Field Service Lightning managed package feature.
The Field Service Lightning
To import a polygon in KML, click the Map Polygons custom object tab in Salesforce and click New.
core features, managed
Add a name, color, description, and service territory. In the KML Details field, add your KML text.
package, and mobile app
Make sure that each set of coordinates has its own line.
are available in Enterprise,
Example: Performance, Unlimited,
and Developer Editions.
<?xml version="1.0" encoding="UTF-8"?> Work orders are also
<kml xmlns="http://www.opengis.net/kml/2.2"> available in Professional
<Style id="myPolygonStyle"> Edition.
<LineStyle>
<width>1</width>
</LineStyle>
<PolyStyle>
<color>8047A043</color>
</PolyStyle>
</Style>
<Placemark>
<name>myPolygon</name>
<styleUrl>#myPolygonStyle</styleUrl>
<Polygon>
<outerBoundaryIs>
<LinearRing>
<coordinates>-122.44257817993167,37.80710430993863,0
-122.4278153015137,37.804391739106606,0
-122.4113358093262,37.80737556154185,0
-122.40412603149417,37.80629054915071,0
-122.38867650756839,37.78974213500372,0
-122.38764653930667,37.74821914921608,0
-122.45390783081058,37.74523293816564,0
-122.4604309631348,37.78865686357955,0
-122.44257817993167,37.80710430993863,0</coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
</Placemark>
</kml>

234
Field Service Lightning Field Service Lightning Object Fields

Field Service Lightning Object Fields

Learn about the fields available on Field Service Lightning standard objects.
EDITIONS
Note: If you have your own field service terminology, remember that you can rename an
object’s tab and labels. In Setup, select Rename Tabs and Labels, and enter your own term Available in: Salesforce
for the object you’d like to rename. Classic and Lightning
Experience

IN THIS SECTION: The Field Service Lightning

core features, managed
Field Service Lightning Objects package, and mobile app
When you enable Field Service Lightning, you gain access to a suite of standard Salesforce are available in Enterprise,
objects. The Field Service Lightning managed package also includes custom objects that support Performance, Unlimited,
its scheduling and optimization features. and Developer Editions.
Linked Article Fields Work orders are also
available in Professional
A linked article is a Knowledge article that is attached to a work order, work order line item, or
Edition.
work type. Linked articles have the following fields. Some fields may not be visible or editable
depending on your page layout and field-level security settings.
Location Fields for Field Service
Locations, addresses, and associated locations have the following fields. Some fields may not be visible or editable depending on
your page layout and field-level security settings.
Maintenance Plan Fields
Maintenance plans and maintenance assets have the following fields. Some fields may not be visible or editable depending on your
page layout and field-level security settings.
Operating Hours Fields for Field Service
Operating hours and time slots have the following fields. Some fields may not be visible or editable depending on your page layout
and field-level security settings.
Product Request and Transfer Fields
Product requests, product request line items, product transfers, and shipments have the following fields. Some fields might not be
visible or editable depending on your page layout and field-level security settings.
Product Item and Inventory Fields
Product items, product item transactions, products required, and products consumed have the following fields. Some fields might
not be visible or editable depending on your page layout and field-level security settings.
Return Order Fields
Return orders and return order line items have the following fields. Some fields may not be visible or editable depending on your
page layout and field-level security settings.
Service Appointment Fields for Field Service
Service appointments have the following fields. Some fields may not be visible or editable depending on your page layout and
field-level security settings.
Service Crew Fields
Service crews and service crew members have the following fields. Depending on your page layout and field-level security settings,
you may not be able to view or update some of them.
Service Report Fields
Service reports and digital signatures on service reports have the following fields. Some fields may not be visible or editable depending
on your page layout and field-level security settings.

235
Field Service Lightning Field Service Lightning Objects

Service Resource Fields for Field Service

Service resources, resource absences, resource capacity records, assigned resources, and resource preferences have the following
fields. Some fields may not be visible or editable depending on your page layout and field-level security settings.
Service Territory Fields for Field Service
Service territories, service territory members, and service territory locations have the following fields. Some fields may not be visible
or editable depending on your page layout and field-level security settings.
Shift Fields for Field Service
Shifts have the following fields. Some fields may not be visible or editable depending on your page layout and field-level security
settings.
Skill Fields for Field Service
Skills represent certifications and areas of expertise in your field service workforce. Skills, service resource skills, and skill requirements
have the following fields. Some fields may not be visible or editable depending on your page layout and field-level security settings.
Time Sheet Fields
Time sheets and time sheet entries have the following fields. Some fields may not be visible or editable depending on your page
layout and field-level security settings.
Work Order Fields for Field Service
Work orders have the following fields. Some fields may not be visible or editable depending on your page layout and field-level
security settings.
Work Order Line Item Fields for Field Service
Work order line items have the following fields. Some fields may not be visible or editable depending on your page layout and
field-level security settings.
Work Type Fields for Field Service
Work types have the following fields. Some fields may not be visible or editable depending on your page layout and field-level
security settings.

Field Service Lightning Objects

When you enable Field Service Lightning, you gain access to a suite of standard Salesforce objects.
EDITIONS
The Field Service Lightning managed package also includes custom objects that support its
scheduling and optimization features. Available in: Salesforce
Note: This list doesn’t include sharing, feed, or history objects. Classic and Lightning
Experience

The Field Service Lightning

Standard Objects core features, managed
package, and mobile app
Object Name Definition Tab in are available in Enterprise,
Salesforce? Performance, Unlimited,
and Developer Editions.
Address An address associated with a location. Work orders are also
available in Professional
App Extension A link between the Field Service Lightning mobile
Edition.
app and other mobile apps.

Assigned Resource A service resource that is assigned to a service

appointment.

236
Field Service Lightning Field Service Lightning Objects

Object Name Definition Tab in

Salesforce?
Associated Location A location linked to a specific account.

Digital Signature A captured signature from a field service customer or technician.

Expense An expense such as tools or travel costs linked to a work order.

Field Service Mobile Settings A collection of settings related to the Field Service Lightning mobile
app.

Job Profile A set of skills used to match service resources to shifts.

Linked Article A knowledge article version that is attached to a work order, work order
line item, or work type.

Location A warehouse, site, van, or plant, usually where inventory is stored or

used.

Maintenance Asset An asset associated with a particular maintenance plan. The plan’s
work orders list the asset associated with it.

Maintenance Plan A plan for preventive maintenance on assets. Work orders are generated
for all maintenance visits.

Mobile Settings Assignment The assignment of a field service mobile settings configuration to a
user profile.

Operating Hours Field service hours that you can define for service territories, service
territory members, and accounts.

Product Consumed A product from your inventory that was used to complete a work order
or work order line item.

Product Item A portion of your inventory stored at a particular location. Every product
item is linked to a product and a location.

Product Item Transaction Represents the restocking, consumption, or stock adjustment of a

product item.

Product Request A request for inventory.

Product Request Line Item A subdivision of a product request, associated with a particular product.

Product Required A product that is required for the completion of a work order or work
order line item.

Product Transfer The transfer of inventory from one location to another.

Resource Absence A time period in which a service resource is unavailable to work.

Resource Preference The designation of a service resource as preferred, required, or excluded

on specific accounts or work orders.

Return Order The return or repair of inventory or products.

Return Order Line Item A subdivision of a return order.

237
Field Service Lightning Field Service Lightning Objects

Object Name Definition Tab in

Salesforce?
Service Appointment An appointment to perform field service work for customers.

Service Appointment Status Corresponds to the Status field on service appointments.

Service Crew A group of service resources that can be assigned to field service work
as a unit.

Service Crew Member A service resource that belongs to a service crew.

Service Report A customer-facing report summarizing the status of a service

appointment, work order, or work order line item.

Service Report Template A templates for service reports.

Service Resource A user or crew who can perform field service work. You can assign
service resources to service appointments and specify each resource’s
skills, service territory, and availability.

Service Resource Capacity The maximum number of scheduled hours or number of service
appointments that a capacity-based service resource can complete
within a specific time period.

Service Resource Skill A skill assigned to a service resource. You can specify skill level and
expiration.

Service Territory A region in which field service work is performed. You can assign service
resources to territories and create territory hierarchies.

Service Territory Location A location associated with a particular service territory.

Service Territory Member A service resource who is assigned to a particular service territory.

Shift A record used to schedule service resources.

Shipment A shipment of inventory between locations.

Skill Requirement A skill that is required to complete a particular field service task. Skill
requirements can be added to work types, work orders, and work order
line items.

Time Sheet A log of a service resource’s time and attendance.

Time Sheet Entry A period of time in which a service resource performs a specific function.

Time Slot A period of time on a specified day of the week during which field
service work can be performed. Operating hours consist of one or more
time slots.

Work Order Status Corresponds to the Status field on work orders.

Work Order Line Item Status Corresponds to the Status field on work order line items.

Work Type A template that helps you standardize your work orders.

238
Field Service Lightning Field Service Lightning Objects

Object Name Definition Tab in

Salesforce?
Work Type Group A category of work types that is used to define work-type-based
scheduling limits.

Work Type Group Member A work type that belongs to a particular work type group.

The following objects are available whether or not Field Service Lightning is enabled. You’ll likely encounter them when completing
field service tasks.

Object Name Definition Tab in

Salesforce?
Asset A purchased or installed product.

Asset Relationship A relationship between two assets that represents a replacement or

upgrade.

Contract Line Item A subdivision of a service contract, typically representing a product

covered by the service contract.

Entitlement Represents the level of support that a customer is entitled to.

Product A product or service that your business sells.

Service Contract Represents a service-level agreement, such as a warranty or

subscription.

Skill A capability needed to perform tasks.

Work Order A record that tracks work to be performed for customers. Work orders
can have their own service appointments and work order line items.

Work Order Line Item A subdivision of a work order, often representing a task to be
completed.

Custom Objects
The following objects are provided by the Field Service Lightning managed package. You can view them in Setup and create custom
tabs for them. Customize these objects only based on Salesforce’s recommendations.

Object Name Definition

Appointment Dependency A scheduling dependency between two service appointments.

Crew Management User Settings A user’s crew management preferences.

Crew Management User Settings Territory A user’s crew management preferences for the most recently
loaded service territory.

Criteria Custom criteria added to a scheduling recipe.

FSL Operation Used in data processing.

239
Field Service Lightning Field Service Lightning Objects

Object Name Definition

Gantt Filter A custom filter that controls what data appears in the Gantt.

Gantt Palette A palette used to color-code service appointments on the Gantt.

Map Polygon A custom polygon, which typically represents a service territory.

Optimization Data Schedule optimization data and results.

Optimization Request A request to optimize the schedule, created when a scheduled

optimization job runs or a user triggers an optimization action.

Scheduling Policy A set of work rules and service objectives that guides schedule
optimization.

Scheduling Policy Objective A service objective assigned to a specific scheduling policy.

Scheduling Policy Work Rule A work rule assigned to a specific scheduling policy.

Scheduling Recipe A collection of optimization settings that dictate how to address

a scheduling event such as an appointment cancellation.

Service Objective A scheduling goal in an optimization operation.

SLR Cache Cached data used in street-level routing.

Territory Optimization Request A schedule optimization request for a specific service territory.

User Setting The user’s dispatcher console preferences, such as the last filters
used. Do not customize.

User Setting Territory A user’s dispatcher console preferences for the most recently loaded
service territory.

User Territory A relationship between a user and the service territory that they
belong to.

Work Rule A rule that narrows the list of candidates for a service appointment.

240
Field Service Lightning Linked Article Fields

Linked Article Fields

A linked article is a Knowledge article that is attached to a work order, work order line item, or work
EDITIONS
type. Linked articles have the following fields. Some fields may not be visible or editable depending
on your page layout and field-level security settings. Available in: Salesforce
Classic and Lightning
Field Description Experience
Article ID The ID of the linked article record, which is The Field Service Lightning
created when an article is attached to a record. core features, managed
package, and mobile app
Article Title The title of the attached article.
are available in Enterprise,
Article Version The version of the article that is attached to the Performance, Unlimited,
record. This field displays the title of the attached and Developer Editions.
version, and links to the version. It is a required Work orders are also
field on linked articles attached to work orders available in Professional
and work order line items. Edition.

When you attach an article to a record, that

version of the article stays associated with the
record even if later versions are published. If
needed, you can detach and reattach an article
to a record to link the latest version.
For example, if an article was entitled “How to
Replace a Filter” when it was attached to a work
order, this field displays that title and links to the
attached version.

Knowledge Article ID Required. The ID of the article that is attached

to the record.

Last Viewed The date the article was last viewed.

Linked Object Type Read only. The type of record that the article is
attached to. For example, if the article is
attached to a work order, this field displays
“Work Order.”

Linked Record ID Required. The ID of the record that the article is

attached to. For example, if the article is
attached to a work order, this field displays the
ID of the work order.

Record Type ID The record type of the linked article. This field is
populated only if record types are used.

241
Field Service Lightning Location Fields for Field Service

Location Fields for Field Service

Locations, addresses, and associated locations have the following fields. Some fields may not be
EDITIONS
visible or editable depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Location
Experience
Locations in field service can be associated with products items to track inventory stored at the
The Field Service Lightning
location. They have the following fields.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Close Date Date the location closed or went out of service. Performance, Unlimited,
and Developer Editions.
Construction End Date Date construction ended at the location. Work orders are also
available in Professional
Construction Start Date Date construction began at the location.
Edition.
Description A brief description of the location.

Driving Directions Directions to the location.

Inventory Location Indicates whether the location stores parts.

Note: This field must be selected if you

want to associate the location with
product items.

Location The geographic location.

Location Level The location’s position in a location hierarchy.

If the location has no parent or child locations,
its level is 1. Locations that belong to a hierarchy
have a level of 1 for the root location, 2 for the
child locations of the root location, 3 for their
children, and so forth.

Location Name Location name. For example, Service Van #4.

Location Type Picklist of location types, which can be

customized. By default, no value is selected. The
available values are:
• Warehouse
• Site
• Van
• Plant

Mobile Location Indicates whether the location moves. For

example, a truck or tool box.

Open Date Date the location opened or came into service.

Owner Name The location’s owner or driver.

242
Field Service Lightning Location Fields for Field Service

Field Name Description

Parent Location The location’s parent location. For example, if vans are stored at a
warehouse when not in service, the warehouse is the parent
location.

Possession Date The date the location was purchased.

Remodel End Date Date remodel construction ended at the location.

Remodel Start Date Date remodel construction ended at the location.

Root Location (Read Only) The top-level location in the location’s hierarchy.

Time Zone Picklist of available time zones.

Vistor Address Lookup to an account’s or client’s address.

Address
Addresses are mailing, billing, or home addresses, typically associated with a location. They have the following fields.

Field Name Description

Address Name for the address.

Address Type Picklist of address types. The values are:

• Mailing
• Shipping
• Billing
• Home

Description A brief description of the address.

Driving Directions Directions to the address.

Location Type The type of location associated with the address. The values are:
• Warehouse (default)
• Site
• Van
• Plant

Parent A lookup field to the parent location .

Time Zone Picklist of available time zones.

Associated Location
Associated locations represent a relationship between an account and a location. Multiple accounts can be associated with a location;
for example, a shopping mall location might be related to several accounts. They have the following fields.

243
Field Service Lightning Maintenance Plan Fields

Field Name Description

Account Name The account associated with the location.

Active From Date and time the location starts being associated with the account.

Active To Date and time when the location is no longer associated with the
account.

Associated Location Name (Read Only) Auto-generated number for the association.

Location Name A lookup field to the associated location.

Type Picklist of address types. The values are:

• Bill To
• Ship To

Maintenance Plan Fields

Maintenance plans and maintenance assets have the following fields. Some fields may not be visible
EDITIONS
or editable depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Maintenance Plan
Experience
Maintenance plans let you define how often maintenance visits occur and mass-generate work
The Field Service Lightning
orders for future visits. They can be associated with accounts, work types, assets (creating records
core features, managed
known as maintenance assets), locations, and service contracts.
package, and mobile app
are available in Enterprise,
Field Name Description Performance, Unlimited,
Account The associated account, which typically and Developer Editions.
represents the customer receiving the Work orders are also
maintenance service. available in Professional
Edition.
Auto-generate work orders Turns on auto-generation of work order batches
for a maintenance plan and prohibits the
manual generation of work orders via the
Generate Work Orders action. If this option is
selected, a new batch of work orders is
generated for the maintenance plan on the next
suggested maintenance date* listed on each
maintenance asset, or on the maintenance plan
if no assets are included. If a Generation Horizon
is specified, the date of generation is that many
days earlier.

Contact The associated contact.

Date of the first work order in the next batch The suggested date of service for the first work
order (not the date the work order is created).
This corresponds to the work order’s Suggested

244
Field Service Lightning Maintenance Plan Fields

Field Name Description

Maintenance Date. You can use this field to enforce a delay before
the first maintenance visit (for example, if monthly maintenance
should begin one year after the purchase date).
For example, if you want the first maintenance visit to take place
on May 1, enter May 1. When you generate work orders, the earliest
work order will list a Suggested Maintenance Date of May 1, and
the dates on the later work orders will be based on the Generation
Timeframe and Frequency settings.

Important: Maintenance assets also list a Date of the first

work order in the next batch, which is initially inherited from
the maintenance plan. If the plan has maintenance assets,
this date auto-updates on the maintenance assets after
each batch is generated, but doesn’t update on the
maintenance plan itself because batch timing is calculated
at the maintenance asset level. If the plan doesn’t have
maintenance assets, this date auto-updates on the
maintenance plan after each batch is generated.

Description A brief description of the plan.

End Date The last day the maintenance plan is valid.

Frequency (Required) Amount of time between the plan’s work orders. The
unit is specified in the Frequency Type field.

Frequency Type (Required) The unit of frequency:

• Days
• Weeks
• Months
• Years
For example, to perform monthly maintenance visits you need a
work order for each visit, so enter 1 in Frequency and select Months.

Generate new batch upon completion If both this option and Auto-generate work orders are selected,
a new batch of work orders isn’t generated until the last work order
generated from the maintenance plan is completed. A work order
is considered completed when its status falls into one of the
following status categories: Cannot Complete, Canceled,
Completed, or Closed.
If a maintenance plan covers multiple assets, work orders are
generated per asset. If a maintenance asset’s final work order is
completed late, its work order generation is delayed, which may
cause a staggered generation schedule between maintenance
assets.

245
Field Service Lightning Maintenance Plan Fields

Field Name Description

Generation Horizon (Days) Moves up the timing of batch generation if Auto-generate work
orders is selected. A generation horizon of 5 means the new batch
of work orders is generated 5 days before the maintenance asset’s
(or maintenance plan’s, if there are no assets) next suggested
maintenance date*. The generation horizon must be a whole
number.

Generation Timeframe (Required) How far in advance work orders are generated in each
batch. The unit is specified in the Generation Timeframe Type field.

Generation Timeframe Type (Required) The generation timeframe unit:

• Days
• Weeks
• Months
• Years
For example, to generate 3 months’ worth of work orders at a time,
enter 3 in Generation Timeframe and select Months.

Location Where the service takes place.

Maintenance Plan Number (Read Only) An auto-assigned number that identifies the
maintenance plan.

Maintenance Plan Title A name for the maintenance plan.

Maintenance Window End (Days) Days after the suggested service date on the work order that its
service appointment can be scheduled.

Maintenance Window Start (Days) Days before the suggested service date on the work order that its
service appointment can be scheduled.
The maintenance window start and end fields affect the Earliest
Start Permitted and Due Date fields on the maintenance plan’s
work orders’ service appointments. For example, if you enter 3 for
both the maintenance window start and end, the Earliest Start
Permitted and the Due Date will be 3 days before and 3 days after,
respectively, the Suggested Maintenance Date on each work order.
If the maintenance window fields are left blank, the service
appointment date fields list their work order’s suggested
maintenance date.

Owner Maintenance plan owner.

Service Appointment Generation Method How service appointments are generated when more than one
asset is assoicated with the maintenance plan and work order
generation method is One work order line item per asset.
Choices are one service appointment for the parent work order or
one service appointment for each work order line items.

246
Field Service Lightning Maintenance Plan Fields

Field Name Description

Service Contract The service contract associated with the maintenance plan. The
service contract can’t be updated if any child maintenance asset
is associated with a contract line item from the service contract.

Start Date The first day the maintenance plan is valid.

Work Order Generation Method How work orders are generated when more than one asset is
assoicated with the maintenance plan. Choices are one work order
for each asset or one parent work order and work order line items
for each asset.

Work Order Generation Status (Read Only) Indicates whether the work order generation is in
progress or complete. You can generate only one batch at a time.

Work Type The associated work type. Work orders generated from the
maintenance plan inherit its work type’s duration, required skills
and products, and linked articles. Maintenance assets covered by
the plan use the same work type, though you can update them to
use a different one.

Maintenance Asset
A maintenance asset is a part or product covered by the maintenance plan. The Assets related list on the maintenance plan lists all
covered assets. An asset can be covered by multiple maintenance plans.

Field Name Description

Asset Asset associated with the maintenance plan.

Contract Line Item Contract line item associated with the maintenance asset. This field
can only list a contract line item that is associated with the asset,
and whose parent service contract is associated with the parent
maintenance plan.

Date of the first work order in the next batch The suggested date of service for the first work order (not the date
the work order is created). This corresponds to the work order’s
Suggested Maintenance Date. If left blank when the maintenance
asset is created, this field inherits its initial value from the related
maintenance plan. It auto-updates after each batch is generated.

Maintenance Asset Number (Read Only) An auto-assigned number that identifies the
maintenance asset.

Maintenance Plan Maintenance plan associated with the maintenance asset.

Work Type Work type associated with the maintenance asset. Work orders
generated from the maintenance plan inherit its work type’s
duration, required skills and products, and linked articles.
Maintenance assets covered by the plan use the same work type,
though you can update them to use a different one.

247
Field Service Lightning Operating Hours Fields for Field Service

*The field label for the next suggested maintenance date on maintenance plans and maintenance assets is Date of the first work order
in the next batch.

Operating Hours Fields for Field Service

Operating hours and time slots have the following fields. Some fields may not be visible or editable
EDITIONS
depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Operating Hours
Experience
Operating hours can be assigned to service territories, service territory members, and accounts to
The Field Service Lightning
indicate when they are available for field service work. Create operating hours via the Operating
core features, managed
Hours tab.
package, and mobile app
are available in Enterprise,
Field Name Description Performance, Unlimited,
Description The description of the operating hours. Add any and Developer Editions.
details that aren’t included in the name. Work orders are also
available in Professional
Name The name of the operating hours. For example: Edition.
Summer Hours, Winter Hours, or Peak Season
Hours.

Time Zone The time zone that the operating hours fall
within.

Time Slot
Time slots represent a time period within a day when field service work can be completed. After you create operating hours, create time
slots for each day via the Time Slots related list.

Field Name Description

Day of Week The day of the week when the time slot takes place.

End Time The time when the time slot ends.

Name The name of the time slot. The name is auto-populated to a day
and time format—for example, Monday 9:00 AM - 10:00 PM—but
you can manually update it if you wish.

Operating Hours The operating hours that the time slot belongs to. An operating
hours’ time slots appear in the Operating Hours related list.

Start Time The time when the time slot starts.

Type The type of time slot. Possible values are Normal and Extended.
You may choose to use Extended to represent overtime shifts.

248
Field Service Lightning Product Request and Transfer Fields

Product Request and Transfer Fields

Product requests, product request line items, product transfers, and shipments have the following
EDITIONS
fields. Some fields might not be visible or editable depending on your page layout and field-level
security settings. Available in: Salesforce
Classic and Lightning
Experience
Product Request
The Field Service Lightning
Product requests represent a part or parts ordered. They have the following fields.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Account The account associated with the product Performance, Unlimited,
request. and Developer Editions.
Work orders are also
Case The case associated with the product request. available in Professional
Edition.
Currency ISO Code Three-letter currency code. Available only if the
multicurrency feature is enabled.

Description Notes or context about the request.

Destination Location Where the product is delivered.

Need By Date Date the product must be delivered by.

Owner The owner of the product request.

Product Request Number (Read Only) An auto-generated number that

identifies the product request.

Shipment Type The type of shipment. The picklist includes the

following values, which can be customized:
• Rush
• Overnight
• Next Business Day
• Pick Up

Ship To Address The physical address where the product is

delivered. For example, the mailing address of
the warehouse that is requesting the product.

Source Location Where the product is at the time of the request.

Status The status of the shipment. The picklist includes

the following values, which can be customized:
• Draft: Finalizing the product request details.
• Submitted: The product request is ready for
processing.
• Received: The department in charge of
fulfilling the request is working on it.

249
Field Service Lightning Product Request and Transfer Fields

Field Name Description

Work Order The work order associated with the product request.

Work Order Line Item The work order line item associated with the product request.

Product Request Line Item

Product request line items are subdivisions of a product request. Each line item is associated with a specific product being requested.
They have the following fields.

Field Name Description

Account The account associated with the product request line item.

Case The case associated with the product request line item.

Description Notes and context about the request.

Destination Location Where the product is delivered.

Need By Date Date the product must be delivered by.

Parent The product request that the line item belongs to.

Product The product being requested.

Product Request Line Item Number (Read Only) An auto-assigned number that identifies the product
request line item.

Quantity Requested The amount requested.

Quantity Unit Of Measure Units of the requested product; for example, kilograms or liters.
Quantity Unit of Measure picklist values are inherited from the
Quantity Unit of Measure field on products.

Shipment Type The type of shipment. The picklist includes the following values,
which can be customized:
• Rush
• Overnight
• Next Business Day
• Pick Up

Ship To Address The physical address where the product is delivered.

Source Location Where the product is at time of the request.

Status The status of the shipment. The picklist includes the following
values, which can be customized:
• Draft
• Submitted
• Received

250
Field Service Lightning Product Request and Transfer Fields

Field Name Description

Work Order The work order associated with the product request line item.

Work Order Line Item The work order line item associated with the product request line
item.

Product Transfer
Product transfers track the transfer of product items between inventory locations. They have the following fields.

Field Name Description

Description Notes or context about the transfer.

Destination Location The location where the product is to be delivered.

Expected Pickup Date Date the product is expected to be picked up.

Owner Owner of the product transfer.

Product Name The product associated with the product transfer. If the product is
being transferred from outside your inventory—for example, if it’s
being ordered from a manufacturer—enter a product name.
Otherwise, we recommend entering a source product item.

Product Request The product request associated with the product transfer. Not all
transfers are created in response to a product request.

Product Request Line Item The product request line item associated with the product transfer.
Create a separate transfer for each line item on a product request.

Quantity Received Amount of product received at the destination location.

Quantity Sent Amount of product sent from the source location.

Quantity Unit Of Measure The units of the product; for example, kilograms or liters. Quantity
Unit of Measure picklist values are inherited from the Quantity Unit
of Measure field on products.

Received Indicates that the product was received. To mark a product transfer
received, you need permission to update product items. Once you
mark a product item received, you can’t undo it.

Note: To find out what happens when a product transfer

is marked received, see Guidelines for Transferring Inventory.

Received By The contact who received the product at the destination location.

Return Order The return order associated with the product transfer.

Return Order Line Item The return order line item associated with the product transfer.

Shipment The shipment related to the product transfer.

Shipment Expected Delivery Date The expected date of delivery, inherited from the related shipment.

251
Field Service Lightning Product Request and Transfer Fields

Field Name Description

Shipment Status The shipment status, inherited from the related shipment. It
includes the following values, which can be customized:
• Shipped
• Delivered

Shipment Tracking Number The shipment tracking number, inherited from the related
shipment.

Shipment Tracking URL The shipment tracking URL, inherited from the related shipment.

Source Location The location where the product is coming from.

Source Product Item The product item representing the stock at the source location.
Enter a source product item if the product is being transferred from
a location within your inventory, such as a warehouse. Specifying
a source product item on a product transfer automatically updates
the quantity at the source location to reflect the transfer.
If the product is being transferred from outside your inventory—for
example, if it’s being ordered from a manufacturer—use the
Product Name field instead.

Status Status of the product transfer. It includes the following values,

which can be customized:
• Ready for Pickup
• Completed

Shipment
A shipment tracks a product item while it is in transit. They have the following fields.

Field Name Description

Actual Delivery Date Date the product was delivered.

Delivered To The person or entity the product was delivered too.

Description Notes or context about the shipment.

Destination Location The place the product is to be delivered.

Expected Delivered Date Date the product is expected to be delivered.

Owner Name Owner of the shipment.

Ship From Address The place the product is coming from.

Shipment Number (Read Only) An auto-assigned number that identifies the shipment.

Shipping Provider The company or person making the transfer.

Ship To Address The address the product is to be delivered.

252
Field Service Lightning Product Item and Inventory Fields

Field Name Description

Source Location The address the product is shipped from.

Status The status of the shipment. The picklist includes the following
values, which can be customized:
• Shipped—The product is in transit.
• Delivered—The product is at the destination location.

Tracking Number Tracking number for the shipment.

Tracking URL URL of website used for tracking the shipment.

Product Item and Inventory Fields

Product items, product item transactions, products required, and products consumed have the
EDITIONS
following fields. Some fields might not be visible or editable depending on your page layout and
field-level security settings. Available in: Salesforce
Classic and Lightning
Experience
Product Item
The Field Service Lightning
Product items track the quantity of a particular product at a location. They have the following fields.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Location Location associated with the product item. This Performance, Unlimited,
usually indicates where the product item is and Developer Editions.
stored. Work orders are also
available in Professional
Owner The product item’s owner. Edition.

Product Item Number (Read Only) Auto-generated number identifying

the product item.

Product Name Product associated with the product item.

Quantity On Hand The quantity at the location. If you want to add

a serial number, this value must be 1.

Quantity Unit of Measure Units of the product item; for example, kilograms
or liters. Quantity Unit of Measure picklist values
are inherited from the Quantity Unit of Measure
field on products.

Serial Number A unique number for identification purposes. If

you want to enter a serial number, the Quantity
on Hand must be 1.

Tip: To learn more about the pros and

cons of assigning serial numbers to
product items, see Create Product Items
to Represent Inventory.

253
Field Service Lightning Product Item and Inventory Fields

Product Item Transaction

Product item transactions describe actions performed on a product item. They’re auto-generated records that help you track when a
product item is replenished, consumed, or adjusted. They have the following fields.

Field Name Description

Description A description of the transaction. The description is blank when the
transaction record is created, but can be updated.

Product Item The associated product item.

Product Item Transaction Number (Read Only) Auto-generated number identifying the product item
transaction.

Quantity The quantity of the product item involved in the transaction. If

inventory was consumed, the quantity is negative.

Related Record (Read Only) The product consumed or product transfer related to
the action. If the action wasn’t related to consumption or transfer,
the related record is blank.

Transaction Type The action that the transaction tracks.

• Replenished: When a part is stocked at a location. A
Replenished transaction is created when a product item is
created.
• Consumed: When parts are consumed to complete a work
order. A Consumed transaction is created when a record is
added to the Products Consumed related list on a work order
or work order line item.
• Adjusted: When there is a discrepancy or a change in
consumption. An Adjusted transaction is created when a
product item’s Quantity on Hand is edited, a product consumed
is updated or delete, or a product transfer is deleted.
• Transferred: When parts are transferred between locations.

Product Required
Products required are products that are needed to complete a work order or work order line item. You can add products required to
work orders, work order line items, and work types. They have the following fields.

Field Name Description

Parent Record Associated work order or work order line item.

Parent Record Type Indicates whether the parent record is a work order or a work order
line item.

Product Required Name of the required product.

Product Required Number Auto-generated number identifying the product required.

254
Field Service Lightning Product Item and Inventory Fields

Field Name Description

Quantity Required Amount required of the product.

Quantity Unit of Measure Units of the required product; for example, kilograms or liters.
Quantity Unit of Measure picklist values are inherited from the
Quantity Unit of Measure field on products.

Product Consumed
Products consumed are items from your inventory that were used to complete a work order or work order line item. They have the
following fields.

Note: To create or delete products consumed, you need permission to create product items.

Field Name Description

Description Notes and context about the product consumed.

Price Book Entry Price book associated with the product consumed. If the work
order and the product item’s associated product are related to the
same price book, the Price Book Entry auto-populates based on
the product item.

Product Product associated with the product consumed.

Product Consumed Number (Read Only) Auto-generated number identifying the product
consumed.

Product Item Product item associated with the product consumed. Creating a
product consumed record subtracts the quantity consumed from
the linked product item’s quantity.

Quantity Consumed The quantity of products consumed.

Quantity Unit of Measure Units of the consumed item; for example, kilograms or liters.
Quantity Unit of Measure picklist values are inherited from the
Quantity Unit of Measure field on products.

Unit Price The price per unit of the product consumed.

Work Order Work order associated with the product consumed.

Work Order Line Item Work order line item associated with the product consumed.

255
Field Service Lightning Return Order Fields

Return Order Fields

Return orders and return order line items have the following fields. Some fields may not be visible
EDITIONS
or editable depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Return Order
Experience
Return orders track the return or repair of products and inventory.
The Field Service Lightning
core features, managed
Field Name Description
package, and mobile app
Account The account associated with the return order. are available in Enterprise,
Performance, Unlimited,
Case The case associated with the return order. and Developer Editions.
Work orders are also
Contact The contact associated with the return order.
available in Professional
Description Notes or context about the return order. Edition.

Destination Location The location where the items are being returned
to. For example, if the return order tracks the
return of products from a technician’s van to a
warehouse, the warehouse is the destination
location.

Expected Arrival Date The date when the items are expected to arrive
at the destination location.

Order The order associated with the return order.

When you associated a return order with an
order, you can associate the return order’s line
items with order products.

Owner The owner of the return order.

Product Request The product request associated with the return

order. When you associated a return order with
a product request, you can associate the return
order’s line items with the product request’s line
items.
A return order might be related to a product
request if the return order tracks the return of
unused products or products to be repaired or
replaced. For example, a technician creates a
product request for three motors to prepare for
a field visit. If the technician finds that only two
motors are needed, they can create a return
order to return the third to the original location,
and list the product request in this field.

Return Order Number (Read only) Auto-generated number identifying

the return order.

256
Field Service Lightning Return Order Fields

Field Name Description

Returned By The user returning the items.

Ship From Address The return shipping address. This address tracks the location of the
items at the start of the return or repair. For example, if a customer
is returning an item, the Ship From address is the customer’s
address.

Shipment Type The type of shipment associated with the return order. Available
values are:
• Standard (default value)
• Rush
• Overnight
• Next Business Day
• Pickup

Source Location The items’ location at the start of the return or repair. For example,
if the return order tracks the return of products from a technician’s
service vehicle to a warehouse, the service vehicle is the source
location.

Status The status of the return order. Available values are:

• Draft
• Submitted
• Approved
• Canceled
• Closed

Return Order Line Item

Field Name Description
Asset The asset associated with the return order line item. One or more
of the following fields must be filled out: Asset, Order Product,
Product, Product Item, and Product Request Line Item.

Description Notes or context about the return order line item.

Destination Location The location where the items are being returned to. For example,
if the return order tracks the return of products from a technician’s
van to a warehouse, the warehouse is the destination location.

Order Product The order product associated with the return order line item. One
or more of the following fields must be filled out: Asset, Order
Product, Product, Product Item, and Product Request Line Item.

257
Field Service Lightning Return Order Fields

Field Name Description

Processing Plan Indicates the preferred fate of the items following their return.
Available values are:
• Repair—Repair the items and return them to the owner
• Discard—Discard the items
• Salvage—Salvage the items’ working components
• Restock—Return the items to your inventory

Product The product item representing the location of the product at the
start of the return. One or more of the following fields must be
filled out: Asset, Order Product, Product, Product Item, and Product
Request Line Item.

Product Item The product item associated with the return order line item. One
or more of the following fields must be filled out: Asset, Order
Product, Product, Product Item, and Product Request Line Item.

Product Request Line Item The product request line item associated with the return order line
item. One or more of the following fields must be filled out: Asset,
Order Product, Product, Product Item, and Product Request Line
Item.

Quantity Returned The quantity of items being returned. If multiple types of products
are being returned, track each product in a different return order
line item.

Quantity Unit of Measure Units of the returned items; for example, kilograms or liters. Quantity
Unit of Measure picklist values are inherited from the Quantity Unit
of Measure field on products.

Reason for Return The reason the items are being returned. Available values are:
• Damaged
• Defective
• Duplicate Order
• Wrong Item
• Wrong Quantity
• Not Satisfied
• Outdated
• Other

Repayment Method The method by which the customer or owner is reimbursed for
the items being returned. Available values are:
• Replace—The items are replaced
• Refund—The items are returned and the owner is refunded
• Credit—The items are returned and the owner receives credit
for them

258
Field Service Lightning Service Appointment Fields for Field Service

Field Name Description

• Return—The items are returned to the owner (for example,
following their repair)

Return Order The return order that the return order line item belongs to.

Return Order Line Item Number (Read only) Auto-generated number that identifies the return order
line item.

Source Location The items’ location at the start of the return or repair. For example,
if the return order tracks the return of products from a technician’s
service vehicle to a warehouse, the service vehicle is the source
location.

Service Appointment Fields for Field Service

Service appointments have the following fields. Some fields may not be visible or editable depending
EDITIONS
on your page layout and field-level security settings.
Available in: Salesforce
Field Name Description Classic and Lightning
Account (Read only) The account associated with the Experience
appointment. If the parent record is a work order The Field Service Lightning
or work order line item, this field’s value is core features, managed
inherited from the parent. Otherwise, it remains package, and mobile app
blank. are available in Enterprise,
Performance, Unlimited,
Actual Duration (Minutes) The number of minutes that it took the resource and Developer Editions.
to complete the appointment after arriving at Work orders are also
the address. When values are first added to the available in Professional
Actual Start and Actual End fields, the Actual Edition.
Duration is automatically populated to list the
difference between the Actual Start and Actual
End. If the Actual Start and Actual End fields are
subsequently updated, the Actual Duration field
doesn’t re-update, but you can manually update
it.

Actual End The actual date and time the appointment

ended.

Actual Start The actual date and time the appointment

started.

Address The address where the appointment is taking

place. The address is inherited from the parent
record if the parent record is a work order or
work order line item.

Appointment Number An auto-assigned number that identifies the

appointment.

259
Field Service Lightning Service Appointment Fields for Field Service

Field Name Description

Arrival Window End The end of the window of time in which the technician is scheduled
to arrive at the site. This window is typically larger than the
Scheduled Start and End window to allow time for delays and
scheduling changes. You may choose to share the Arrival Window
Start and End with the customer, but keep the Scheduled Start
and End internal-only.

Arrival Window Start The beginning of the window of time in which the technician is
scheduled to arrive at the site. This window is typically larger than
the Scheduled Start and End window to allow time for delays and
scheduling changes. You may choose to share the Arrival Window
Start and End with the customer, but keep the Scheduled Start
and End internal-only.

Contact The contact associated with the appointment. If the parent record
is a work order or work order line item, this field’s value is inherited
from the parent.

Description The description of the appointment.

Due Date The date by which the appointment must be completed. Earliest
Start Permitted and Due Date typically reflect terms in the
customer’s service-level agreement.

Duration The estimated length of the appointment. If the parent record is

work order or work order line item, the appointment inherits its
parent’s duration, but it can be manually updated. The duration is
in minutes or hours based on the value selected in the Duration
Type field.

Duration Type The unit of the duration: Minutes or Hours.

Earliest Start Permitted The date after which the appointment must be completed. Earliest
Start Permitted and Due Date typically reflect terms in the
customer’s service-level agreement.

Parent Record The parent record associated with the appointment. The parent
record can’t be updated after the service appointment is created.

Parent Record Status Category (Read only) The Status Category of the parent record. If the parent
record is a work order or work order line item, this field is populated;
otherwise, it remains blank.

Parent Record Type (Read only) The type of parent record: Account, Asset, Lead,
Opportunity, Work Order, or Work Order Line Item.

Scheduled End The time at which the appointment is scheduled to end. If you are
using the Field Service Lightning managed package with the
scheduling optimizer, this field is populated once the appointment
is assigned to a resource. Scheduled End – Scheduled Start =
Estimated Duration.

260
Field Service Lightning Service Appointment Fields for Field Service

Field Name Description

Scheduled Start The time at which the appointment is scheduled to start. If you are
using the Field Service Lightning managed package with the
scheduling optimizer, this field is populated once the appointment
is assigned to a resource.

Service Note Add notes such as an appointment summary or recommendations

for future work. Depending on your settings, these notes might
appear on a customer-facing service report.

Service Territory The service territory associated with the appointment. If the parent
record is a work order or work order line item, the appointment
inherits its parent’s service territory.

Status The status of the appointment. The picklist includes the following
values, which can be customized:
• None—Default value.
• Scheduled—The service appointment is scheduled.
• Dispatched—The service resource is in route.
• In Progress—The service resource started the work.
• Cannot Complete—The service resource couldn’t complete
the appointment for any reason.
• Completed—The service resource completed the work.
• Canceled—The service appointment has been canceled.

Status Category The category that each Status value falls into. The Status Category
field’s values are identical to the standard Status values.
If you create custom Status values, you must indicate which
category it belongs to. For example, if you create a Customer
Absent value, you may decide that it belongs in the Cannot
Complete category.
To learn which processes reference Status Category, see How are
Status Categories Used?

Subject A short phrase describing the appointment.

Work Type (Read only) The work type associated with the service appointment.
The work type is inherited from the appointment’s parent record
if the parent is a work order or work order line item.

Note: If Lightning Scheduler is also in use, this field is

editable. However, users see an error if they update it to list
a different work type than the parent record’s work type.

261
Field Service Lightning Service Crew Fields

Service Crew Fields

Service crews and service crew members have the following fields. Depending on your page layout
EDITIONS
and field-level security settings, you may not be able to view or update some of them.
Available in: Salesforce
Classic and Lightning
Service Crew
Experience
Service crews are groups of users who can be assigned to a service appointment as a unit. Create
The Field Service Lightning
service crews from the crew management tool or the Service Crews tab.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Crew Size The ideal number of members on the crew. This Performance, Unlimited,
field doesn’t update when you add or remove and Developer Editions.
members. Work orders are also
available in Professional
Note: You can add crew size Edition.
requirements to work types, work orders,
and work order line items that are
enforced during scheduling. To learn
more, see Considerations for Scheduling
Service Crews.

Gantt Color Hex code of the crew’s background color on the

Gantt. Crews without a set Gantt color appear
in purple. For example, set the Gantt color to
green (#008000) for all service crews that use a
company vehicle.

This is a Field Service Lightning managed

package feature.

Name The name of the service crew. For example,

Repair Crew.

Owner By default, the person who created the service

crew.

Service Crew Member

Service crew members are service resources who belong to a service crew. Add members to a service crew from the crew management
tool or the Service Crew Members related list on the crew record.

Field Name Description

End Date The last day that the service resource belongs to the crew. You can
use this field to track employment dates for contractors.

262
Field Service Lightning Service Report Fields

Field Name Description

Gantt Label Custom label that appears beneath the member’s name on the
Gantt. For example, enter the person’s job title.

This is a Field Service Lightning managed package feature.

Leader Indicates that the member is the crew leader. Leaders can edit
assigned appointments and their parent records, while members
can only view them. Crew geolocation is based on the leader’s
location. Leaders appear in the crew management tool with a star
next to their name.

Name The name of the crew member. Depending on your preference,

you can enter the service resource’s name or their role in the crew.

Service Crew The crew that the service resource belongs to.

Service Resource The service resource that belongs to the crew.

Start Date Required. The day the service resource joins the crew.

Service Report Fields

Service reports and digital signatures on service reports have the following fields. Some fields may
EDITIONS
not be visible or editable depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Service Report
Experience
Service reports display fields from related objects, including service appointments, work orders,
The Field Service Lightning
and work order line items. In addition, the Service Report object comes with the following fields.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Parent ID The ID of the record that the service report is Performance, Unlimited,
summarizing. For example, if you click Create and Developer Editions.
Service Report on a service appointment, this Work orders are also
field lists the service appointment’s record ID. available in Professional
Edition.
Service Report Language The language used for the service report. The
language is selected in the Service Report
Language field on the associated work order. If
the work order doesn’t specify a service report
language, the report is translated in the default
language in Salesforce of the person generating
the report.

Service Report Name The name of the service report.

263
Field Service Lightning Service Report Fields

Field Name Description

Service Report Template The template used to create the service report.

Note: If the person creating the service report doesn’t have

Read access to objects or fields in the service report
template, those fields aren’t visible in the report they create.

Signed Indicates that the service report contains one or more signatures.

Tip: To quickly find signed reports, add this field to the

Service Reports related list on work orders.

Digital Signature
Digital Signatures are signatures captured on service reports. For example, technicians can collect signatures from customers, technicians,
or anyone else involved in field service work.

Field Name Description

Date Signed The date of the signing.

Parent Record The service appointment, work order, or work order line item that
the service report belongs to.

Place Signed The place where the service report was signed.

Signature Image The image of the signature.

Signature Number An auto-generated number identifying the signature.

Signature Type The role of the person signing. It comes with one value, Default.
Service reports can have one signature per type, so your admin
needs to create additional signature types in Setup.
Create at least one value for every role that might need to sign a
service report. For example, Technician, Customer, Supervisor, or
Supplier. If you want some service reports to be signed by multiple
people in one role—for example, if all technicians present at an
appointment should sign—create numbered types: Technician 1,
Technician 2, and so forth.

Signed By The name of the person signing.

264
Field Service Lightning Service Resource Fields for Field Service

Service Resource Fields for Field Service

Service resources, resource absences, resource capacity records, assigned resources, and resource
EDITIONS
preferences have the following fields. Some fields may not be visible or editable depending on your
page layout and field-level security settings. Available in: Salesforce
Classic and Lightning
Experience
Service Resource
The Field Service Lightning
Service resources represent individual users or groups of users (known as service crews) who can
core features, managed
complete field service work.
package, and mobile app
are available in Enterprise,
Field Name Description Performance, Unlimited,
Active When selected, this option means that the and Developer Editions.
resource can be assigned to work orders. For Work orders are also
service tracking purposes, resources can’t be available in Professional
deleted, so deactivating a resource is the best Edition.
way to send them into retirement.

Capacity-Based Capacity-based resources are limited to a certain

number of hours or appointments in a specified
time period.

Tip: The Capacities related list shows a

resource’s capacity.

Description The description of the resource.

Include in Scheduling Optimization Use only if the Field Service Lightning managed
package is installed. When selected, this option
checks whether the resource can be assigned
to service appointments during the optimization
process. To be included in optimization,
resources need the Field Service Scheduling
permission set license. If this option is selected
and the resource doesn’t have the permission
set license, the user creating the service resource
is prompted to assign it.

Location The location associated with the service

resource. For example, a service vehicle driven
by the service resource.

Name The resource’s name. This name can be the

name or title of the associated user or crew.

Resource Type Indicates whether a resource is a technician,

dispatcher, or crew. Resources who are
dispatchers can’t be capacity-based or included
in schedule optimization. Only users with the
Field Service Dispatcher permission set license

265
Field Service Lightning Service Resource Fields for Field Service

Field Name Description

can be dispatchers. You can’t add additional resource types.

Note: Field Service Lightning users can see Asset as a

picklist option in the Resource Type field. However, you
can’t save the record when you select Asset in an org that
doesn’t have access to Lightning Scheduler.

Service Crew The associated service crew. If the service resource represents a
crew, select the crew.

Note: This field is hidden for all users by default. To use it,
update its field-level security settings in Setup and add it
to your service resource page layouts.

User The associated user. If the service resource represents a crew instead
of a single user, leave this field blank.

Resource Absence
Resource absences are periods of time in which a service resource isn’t available to work.

Field Name Description

Absence Number (Read only) An auto-generated number identifying the absence.

Absence Type The type of absence: Meeting, Training, Medical, or Vacation. You
can add custom values if needed, but the name Break is reserved
for the managed package.

Address The address associated with the absence.

Description The description of the absence.

End Time The date and time when the absence ends.

Resource Name The absent service resource.

Start Time The date and time when the absence begins.

Resource Capacity
A service resource’s capacity indicates how much work the resource can perform in a specified time period.

Field Name Description

End Date The date the capacity ends; for example, the end date of a contract.

Name (Read only) An auto-generated number identifying the capacity

record.

266
Field Service Lightning Service Resource Fields for Field Service

Field Name Description

Hours per Time Period The number of hours that the resource can work per time period.
You must fill out this field, the Work Items per Time Period field, or
both.

Service Resource The associated resource.

Start Date The date the capacity goes into effect.

Time Period Day, Week, or Month. For example, if a resource can work 80 hours
per month, select Month and enter 80 in Hours per Time Period.

Work Items per Time Period The total number of service appointments that the resource can
complete per time period. You must fill out this field, the Hours
per Time Period field, or both.

Assigned Resource
Assigned resources are service resources who are assigned to a service appointment. They appear in the Assigned Resources related list
on service appointments. Assign a service appointment to a service crew by creating an assigned resource record that is linked to the
service resource record representing the crew.

Field Name Description

Actual Travel Time (Minutes) The actual travel time in minutes to the work site.

Assigned Resource Number An auto-generated number identifying the assigned resource.

Estimated Travel Time (Minutes) The estimated travel time in minutes to the work site.

Note: If the resource represents a crew, you can’t track

individual crew members’ travel time unless you create an
assigned resource record for each crew member.

Service Appointment The related service appointment.

Service Crew The service crew assigned to the appointment. Typically,

appointments are assigned to crews by creating an assigned
resource record that links to the service crew record. If you’re using
that approach, you can leave the Service Crew field blank.
If you want to assign an appointment to crew members individually
so you can track each member’s travel time, create an assigned
resource record for each crew member that has both the User and
Service Crew fields completed.
This field is hidden for all users by default. To use it, update its
field-level security settings in Setup and add it to your assigned
resource page layouts.

Service Resource The service resource assigned to the appointment.

267
Field Service Lightning Service Territory Fields for Field Service

Resource Preference
Resource preferences indicate which service resources should be assigned to field service work. You can designate certain service
resources as preferred, required, or excluded on specific accounts or work orders. Work orders inherit their associated account’s resource
preferences.

Field Name Description

Preference Type • Preferred: Indicates that the customer would like their field
service work assigned to the resource
• Required: Indicates that the resource must be assigned to the
customer’s field service work
• Excluded: Indicates that the customer does not want their field
service work assigned to the resource
Resource preferences serve more as a suggestion than a
requirement. You can still assign a service appointment to any
resource regardless of the related work order’s resource preferences.

Related Record The work order or account with the resource preference.

Resource Preference Number An auto-generated number identifying the resource preference.

Service Resource The service resource that is preferred, required, or excluded.

Service Territory Fields for Field Service

Service territories, service territory members, and service territory locations have the following fields.
EDITIONS
Some fields may not be visible or editable depending on your page layout and field-level security
settings. Available in: Salesforce
Classic and Lightning
Experience
Service Territory
The Field Service Lightning
Service territories represent regions in which field service work can be performed.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Active Indicates whether the service territory is meant Performance, Unlimited,
to be used. If a territory is inactive, you can’t add and Developer Editions.
members to it or link it to work orders, work Work orders are also
order line items, or service appointments. available in Professional
Edition.
Address An address to associate with the territory. You
may want to list the address of the territory’s
headquarters. A service territory’s primary
members use its address as their home base
unless a different address is specified on the
member record. If the Field Service Lightning
managed package is installed, the home base

268
Field Service Lightning Service Territory Fields for Field Service

Field Name Description

is used to calculate travel for the first and last leg of the day.

Note: When defining an address, make sure it's geocoded.

You may need to enter a street address.

Description The description of the territory.

Name The name of the territory.

Operating Hours The territory’s operating hours, which indicate when service
appointments within the territory should occur. Service resources
who are members of a territory automatically inherit the territory’s
operating hours unless different hours are specified on the service
territory member record.

Parent Territory The territory’s parent service territory, if it has one. For example, a
Northern California territory can have a State of California territory
as its parent.

Top-Level Territory (Read only) The top-level territory in a hierarchy of service territories.
Depending on where a territory lies in the hierarchy, its top-level
territory might be the same as its parent.

Typical In-Territory Travel Time Estimated number of minutes needed to travel from one location
to another within the service territory. You can use this field in Apex
customization.

Service Territory Member

Service territory members are service resources who are available to work in the service territory.

Field Name Description

Address The member’s address. You may want to list the related service
resource’s address in this field.

End Date The date when the service resource is no longer a member of the
territory. If the resource will be working in the territory for the
foreseeable future, leave this field blank. This field is mainly useful
for indicating when a temporary relocation ends.

Member Number (Read only) An auto-generated number identifying the service

territory member.

Operating Hours The member’s operating hours, which are inherited from the service
territory.

Service Resource The service resource assigned to the service territory.

Service Territory The service territory that the service resource is assigned to.

269
Field Service Lightning Service Territory Fields for Field Service

Field Name Description

Start Date The date when the service resource becomes a member of the
service territory.

Territory Type • Primary: Where the resource works most often—for example,
near their home base. Service resources can have only one
primary territory.
• Secondary: Where the resource can be assigned to
appointments if needed. Service resources can have multiple
secondary territories with overlapping dates.
• Relocation: Representing a temporary move. Resources with
relocation territories are always assigned to appointments
within their relocation territories during the specified relocation
dates. If they don’t have a relocation territory, the primary
territories are favored over the secondary.
For example, a service resource can have the following territories:
• Primary territory: West Chicago
• Secondary territories:
– East Chicago
– South Chicago

• Relocation territory: Manhattan, for a three-month period

Service Territory Location

Service territory locations represent locations that belong to a service territory, such as a warehouse located inside a territory.

Field Name Description

Location The related location.

Service Territory The related service territory.

Service Territory Location Number An auto-generated number identifying the territory location.

270
Field Service Lightning Shift Fields for Field Service

Shift Fields for Field Service

Shifts have the following fields. Some fields may not be visible or editable depending on your page
EDITIONS
layout and field-level security settings.
Shifts can be used to schedule and dispatch service resources. Available in: Salesforce
Classic and Lightning
Field Name Description Experience

Created By (Read Only) User who created the time sheet. The Field Service Lightning
core features, managed
Created Date (Read Only) Date the time sheet was created. package, and mobile app
are available in Enterprise,
End Time The date and time that the shift ends.
Performance, Unlimited,
Job Profile Job profile associated with the shift. and Developer Editions.
Work orders are also
Label The customizable label, or name, for the shift. available in Professional
Edition.
Last Modified By (Read Only) User who last modified the time
sheet.

Last Modified Date (Read Only) Date the time sheet was last
modified.

Owner Name Shift owner.

Service Resource Service resource associated with the shift.

Service Territory Service territory associated with the shift.

Shift Number (Read Only) The number automatically created

for the shift.

Start Time The date and time that the shift starts.

Status The status of the shift. The picklist includes the

following values, which can be customized:
• Tentative
• Published
• Confirmed

Status Category The status of the shift using static values. This
field is derived from the Status field using the
mapping you define. The picklist includes the
following values:
• Tentative
• Published
• Confirmed

Time Slot Type The type of time slot for the shift. This field uses
the same values as the Time Slot field in the
Operating Hours object. The picklist includes
the following values:

271
Field Service Lightning Skill Fields for Field Service

Field Name Description

• Normal
• Extended

Skill Fields for Field Service

Skills represent certifications and areas of expertise in your field service workforce. Skills, service
EDITIONS
resource skills, and skill requirements have the following fields. Some fields may not be visible or
editable depending on your page layout and field-level security settings. Available in: Salesforce
Classic and Lightning
Experience
Skill
The Field Service Lightning
Skills represent a certification or area of expertise. They are created in Setup.
core features, managed
package, and mobile app
Field Name Description
are available in Enterprise,
Name The name of the skill. Performance, Unlimited,
and Developer Editions.
Description The description of the skill. Work orders are also
available in Professional
Developer Name The unique name of the skill in the API.
Edition.

Note: When you create a skill, leave the Assign Users and Assign Profiles sections blank. They
are specific to Chat, which also uses skills.

Service Resource Skill

Service resource skills are skills that are assigned to a service resource. They appear in the Skills related list on service resource detail
pages.

Field Name Description

End Date The date when the skill expires. For example, if a resource must be
re-certified after six months, the end date would be the date their
certification expires.

Service Resource The resource who possesses the skill.

Skill The skill the resource possesses.

Skill Level The resource’s skill level. Skill level can range from zero to 99.99.

Start Date The date when the resource gains the skill. For example, if the skill
represents a certification, the start date would be the date of
certification.

272
Field Service Lightning Time Sheet Fields

Skill Requirement
Skill requirements are skills that a service resource needs to complete a task. They appear in the Skill Requirements related list on work
type, work order, and work order line item detail pages.

Field Name Description

Related Record The work order, work order line item, or work type that the skill is
required on.

Skill The required skill.

Skill Level The required skill level. Skill level can range from zero to 99.99.

Time Sheet Fields

Time sheets and time sheet entries have the following fields. Some fields may not be visible or
EDITIONS
editable depending on your page layout and field-level security settings.
Available in: Salesforce
Classic and Lightning
Time Sheet
Experience
Time sheets relate service resources with their time and attendance.
The Field Service Lightning
core features, managed
Field Name Description
package, and mobile app
Created By (Read Only) User who created the time sheet. are available in Enterprise,
Performance, Unlimited,
Created Date (Read Only) Date the time sheet was created. and Developer Editions.
Work orders are also
Last Modified By (Read Only) User who last modified the time
available in Professional
sheet.
Edition.
Last Modified Date (Read Only) Date the time sheet was last
modified.

Name Time sheet name.

Owner Time sheet owner.

Service Resource Service resource associated with the time sheet.

Status The status of the time sheet. The picklist includes

the following values, which can be customized:
• None
• New
• Submitted
• Approved

Time Sheet End Date The last day the time sheet covers.

Time Sheet Entry Count (Read Only) The number of related time sheet
entries.

273
Field Service Lightning Time Sheet Fields

Field Name Description

Time Sheet Start Date The first day the time sheet covers.

Time Sheet Entry

Time sheet entries track the continual time a resource performs a specific function.

Field Name Description

Created By (Read Only) User who created the time sheet entry.

Created Date (Read Only) Date the time sheet entry was created.

Description A text box for notes on how the time was spent. For example, “This
service took longer than normal because the machine was
jammed.”

Duration (in Minutes) (Read Only) Minutes recorded on the time sheet entry.

End Time The date and time the activity finished.

Last Modified By (Read Only) User who last modified the time sheet.

Last Modified Date (Read Only) Date the time sheet was last modified.

Name Time sheet entry name.

Start Time The date and time the activity began.

Status The status of the time sheet entry. The picklist includes the
following values, which can be customized:
• None
• New
• Submitted
• Approved

Subject Activity performed; for example, repair, lunch, or travel.

Time Sheet (Read Only) Related time sheet.

Type The type of work performed. The picklist includes the following
values, which can be customized:
• None
• Direct
• Indirect

Work Order The work order related to the time sheet entry. Work orders are
searchable by their content.

Work Order Line Item The work order line item related to the time sheet entry. Work order
line items are searchable by their content.

274
Field Service Lightning Work Order Fields for Field Service

Work Order Fields for Field Service

Work orders have the following fields. Some fields may not be visible or editable depending on
EDITIONS
your page layout and field-level security settings.
Available in: Salesforce
Field Description Classic and Lightning
Account The account associated with the work order. Experience

The Field Service Lightning

Address The compound form of the address where the
core features, managed
work order is completed. The work order’s
package, and mobile app
service appointments and line items inherit its
are available in Enterprise,
address, though the address on line items can
Performance, Unlimited,
be updated. and Developer Editions.
Asset The asset associated with the work order. Work orders are also
available in Professional
Business Hours The business hours associated with the work Edition.
order.

Case The case associated with the work order.

City The city where the work order is completed.

Maximum length is 40 characters.

Contact The contact associated with the work order.

Country The country where the work order is completed.

Maximum length is 80 characters.

Currency ISO Code Three-letter currency code. Available only if the

multicurrency feature is enabled.

Description The description of the work order. We

recommend describing the steps a user must
complete to mark the work order Completed.

Discount (Read Only) The weighted average of the

discounts on all line items on the work order. It
can be any positive number up to 100.

Duration The estimated time required to complete the

work order. Specify the duration unit in the
Duration Type field.

Note: Work order duration and work

order line item duration are independent
of each other. If you want work order
duration to automatically show the sum
of the work order line items’ duration,
replace the Duration field on work orders
with a custom roll-up summary field.

Duration Type The unit of the duration: Minutes or Hours.

275
Field Service Lightning Work Order Fields for Field Service

Field Description
End Date The date when the work order is completed. This field is blank
unless you set up automation to configure it. For a sample workflow
rule that configures the Start Date field (a similar field), see below.

Entitlement The entitlement associated with the work order.

Entitlement Process End Time The time the work order exits an entitlement process. If an
entitlement process applies to a work order, this field appears.

Entitlement Process Start Time The time the work order entered an entitlement process. If an
entitlement process applies to a work order, this field appears.

Generated from maintenance plan (Read Only) Indicates that the work order was generated from a
maintenance plan, rather than manually created.

Note: This option is deselected for work orders that were

generated from maintenance plans before Summer ’18.

Geocode Accuracy The level of accuracy of a location’s geographical coordinates

compared with its physical address. A geocoding service typically
provides this value based on the address’s latitude and longitude
coordinates.

Grand Total (Read Only) The total price of the work order with tax added.

Is Closed Indicates whether the work order is closed.

Tip: Use this field to report on closed versus open work

orders.

Last Modified Date The date when the work order was last modified.

Last Viewed Date The date when the work order was last viewed.

Latitude Used with Longitude to specify the precise geolocation of the

address where the work order is completed. Acceptable values are
numbers between –90 and 90 with up to 15 decimal places.

Line Items (Read Only) The number of work order line items on the work order.

Location The location associated with the work order. For example, a work
site.

Longitude Used with Latitude to specify the precise geolocation of the address
where the work order is completed. Acceptable values are numbers
between –180 and 180 with up to 15 decimal places.

Maintenance Plan The maintenance plan associated with the work order. When the
work order is auto-generated from a maintenance plan, this field
automatically lists the related plan.

Milestone Status A milestone is a step in an entitlement process. It can have one of

three statuses: Compliant, Open Violation, and Closed Violation. If

276
Field Service Lightning Work Order Fields for Field Service

Field Description
an entitlement process applies to a work order, this field appears.
To learn more, see Milestone Statuses.

Milestone Status Icon An icon that corresponds to the milestone status.

• Compliant
• Open Violation
• Closed Violation

Minimum Crew Size The minimum crew size allowed for a crew assigned to the work
order.
If you’re not using the Field Service Lightning managed package,
this field serves as a suggestion rather than a rule. If you are using
the managed package, the scheduling optimizer counts the
number of service crew members on a service crew to determine
whether it fits a work order’s minimum crew size requirement.

Owner The work order’s assigned owner.

Parent Work Order The work order’s parent work order, if it has one.

Tip: View, create, and delete a work order’s child work

orders in the Child Work Orders related list.

Postal Code The postal code where the work order is completed. Maximum
length is 20 characters.

Price Book The price book associated with the work order. Adding a price
book to the work order lets you assign different price book entries
(products) to the work order’s line items. This field is only available
if products are enabled.

Priority The priority of the work order. The picklist includes the following
values, which can be customized:
• Low
• Medium
• High
• Critical

Recommended Crew Size The recommended number of people on the service crew assigned
to the work order.

Record Type The record type associated with the work type.

Return Order The return order associated with the work order.

Return Order Line Item The return order line item associated with the work order.

277
Field Service Lightning Work Order Fields for Field Service

Field Description
Root Work Order (Read Only) The top-level work order in a work order hierarchy.
Depending on where a work order lies in the hierarchy, its root
might be the same as its parent.

Service Appointment Count The number of service appointments on the work order.

Service Contract The service contract associated with the work order.

Service Report Language The language used for all service reports and service report
previews created for the work order, its service appointments, and
its work order line items and their service appointments. If the field
is blank, service reports are generated in the default language in
Salesforce of the person creating the report.
To appear as an option in the Service Report Language field, a
language must be set up in Translation Workbench or be one of
Salesforce’s 18 fully supported languages. Service report field names
are translated, but rich text field names, service report section
names, and text field values (such as service notes) aren’t translated.

Service Report Template The service report template that the work order’s service reports
should use.
If you don’t specify a service report template on a work order, it
uses the service report template listed on its work type. If the work
type doesn’t list a template or no work type is specified, the work
order uses the default service report template.

Note: This field stays blank unless you update it on the

work order. So to find out which template the work order’s
service reports will use, check its work type.

Service Territory The service territory where the work order is taking place.

Start Date The date when the work order goes into effect. This field is blank
unless you set up automation to populate it. For a sample workflow
rule that configures this field, see below.

State The state where the work order is completed. Maximum length is
80 characters.

Status The status of the work order. The picklist includes the following
values, which can be customized:
• New—Work order was created, but there hasn’t yet been any
activity.
• In Progress—Work has begun.
• On Hold—Work is paused.
• Completed—Work is complete.
• Cannot Complete—Work could not be completed.
• Closed—All work and associated activity is complete.

278
Field Service Lightning Work Order Fields for Field Service

Field Description
• Canceled—Work is canceled, typically before any work began.
Changing a work order’s status does not affect the status of its
work order line items or associated service appointments.

Status Category The category that each status value falls into. The Status Category
field has eight default values: seven values which are identical to
the default Status values, and a None value for statuses without a
status category.
If you create custom Status values, you must indicate which
category it belongs to. For example, if you create a Waiting for
Response value, you may decide that it belongs in the On Hold
category.
To learn which processes reference Status Category, see How are
Status Categories Used?

Stopped Indicates the the milestone countdown has been paused.

Stopped Since The time the milestone countdown was paused.

Street The street number and name where the work order is completed.

Subject The subject of the work order. Try to describe the nature and
purpose of the job to be completed. For example, “Annual on-site
well maintenance.” The maximum length is 255 characters.

Subtotal (Read Only) The total of the work order line items’ subtotals before
discounts and taxes are applied.

Suggested Maintenance Date The suggested date that the work order is completed. When the
work order is generated from a maintenance plan, this field is
automatically populated based on the maintenance plan’s settings.

Tax The total tax on the work order. For example, in a work order whose
total price is $100, enter $10 to apply a 10 percent tax. You can
enter a number with or without the currency symbol and you can
use up to two decimal places.

Total Price (Read Only) The total of the work order line items’ price after
discounts but before tax is added.

Work Order Number An auto-generated number that identifies the work order.

Work Type The work type associated with the work order. When a work type
is selected, the work order automatically inherits the work type’s
Duration, Duration Type, and required skills.

Example: The Start Date and End Date fields are blank by default, but you can set up workflow rules to configure them. The
following rule populates the Start Date field with the current date and time when the Status field is changed to In Progress:
1. Create a workflow rule on the Work Order object:

279
Field Service Lightning Work Order Line Item Fields for Field Service

• Under Evaluation criteria, select Created.

• Under Rule Criteria, enter Work Order: Status EQUALS In Progress.

2. Add a New Field Update workflow action:

• Under Field to Update, select Start Date.
• Under Date Options, select the option to use a formula and enter the formula NOW().

3. Save and activate your rule.

Work Order Line Item Fields for Field Service

Work order line items have the following fields. Some fields may not be visible or editable depending
EDITIONS
on your page layout and field-level security settings.
Available in: Salesforce
Field Description Classic and Lightning
Address The address of the line item. The line item Experience
inherits its address from its parent work order, The Field Service Lightning
but it can also be updated manually. core features, managed
package, and mobile app
Asset The asset associated with the line item.
are available in Enterprise,
If your org uses hierarchical assets (available Performance, Unlimited,
after Spring ’16), you may want to link a work and Developer Editions.
order’s line items with different assets. For this Work orders are also
reason, line items do not automatically inherit available in Professional
their parent work order’s asset value. Edition.

City The city where the line item is completed.

Maximum length is 40 characters.

Country The country where the line item is completed.

Maximum length is 80 characters.

Currency ISO Code The ISO code for any currency allowed by the
organization. Available only for orgs with the
multicurrency feature enabled.

Description The description of the line item. We recommend

describing the steps a user must follow to mark
the line item Completed.

Discount The percent discount to be applied to the line

item. You can enter a number with or without
the percent symbol and you can use up to two
decimal places.

280
Field Service Lightning Work Order Line Item Fields for Field Service

Field Description
Duration The estimated time required to complete the line item. Specify the
duration unit in the Duration Type field.

Note: Work order duration and work order line item

duration are independent of each other. If you want work
order duration to automatically show the sum of the work
order line items’ duration, replace the Duration field on work
orders with a custom roll-up summary field.

Duration Type The unit of the duration: Minutes or Hours.

End Date The date when the line item is completed.

Geocode Accuracy The level of accuracy of a location’s geographical coordinates

compared with its physical address. A geocoding service typically
provides this value based on the address’s latitude and longitude
coordinates.

Is Closed Indicates whether the line item has been closed. Changing the line
item’s status to Closed causes this checkbox to be selected in the
user interface.

Is Generated From Maintenance Plan Identifies whether the work order line item is generated from a
maintenance plan.

Last Referenced Date The date when the line item was last modified. Its label in the user
interface is Last Modified Date

Last Viewed Date The date when the line item was last viewed.

Latitude Used with Longitude to specify the precise geolocation of the

address where the work order is completed. Acceptable values are
numbers between –90 and 90 with up to 15 decimal places.

Line Item Number An auto-generated number that identifies the line item.

List Price The price of the line item (product) as listed in its corresponding
price book entry. If a product isn’t specified, the list price defaults
to zero. (Read only)

Location A location associated with the work order line item. For example,
a work site.

Longitude Used with Latitude to specify the precise geolocation of the address
where the work order is completed. Acceptable values are numbers
between –180 and 180 with up to 15 decimal places.

Maintenance Plan The maintenance plan associated with the work order line item.

Minimum Crew Size The minimum crew size allowed for a crew assigned to the line
item.
If you’re not using the Field Service Lightning managed package,
this field serves as a suggestion rather than a rule. If you are using

281
Field Service Lightning Work Order Line Item Fields for Field Service

Field Description
the managed package, the scheduling optimizer counts the
number of service crew members on a service crew to determine
whether it fits a line item’s minimum crew size requirement.

Order The order associated with the line item. For example, you may
need to order replacement parts before you can complete the line
item.

Parent Work Order Line Item The line item’s parent line item, if it has one.

Tip: View, create, and delete a line item’s child line items
in the Child Work Order Line Items related list.

Postal Code The postal code where the line item is completed. Maximum length
is 20 characters.

Pricebook Entry The price book entry (product) associated with the line item. The
label in the user interface is Product. This field’s lookup search
only returns products that are included in the work order’s price
book.

Priority The priority of the line item. The picklist includes the following
values, which can be customized:
• Low
• Medium
• High
• Critical

Product The product (price book entry) associated with the line item. This
field’s lookup search only returns products that are included in the
parent work order’s price book.

Quantity The line item’s quantity.

Recommended Crew Size The recommended number of people on the service crew assigned
to the line item.

Return Order The return order associated with the work order line item.

Return Order Line Item The return order line item associated with the work order line item.

Root Work Order Line Item The top-level line item in a line item hierarchy. Depending on
where a line item lies in the hierarchy, its root might be the same
as its parent. (Read only)

Service Appointment Count The number of service appointments on the work order line item.

Service Report Template The service report template that the line item’s service reports
should use.
If you don’t specify a service report template on a work order line
item, it uses the service report template listed on its work type. If

282
Field Service Lightning Work Order Line Item Fields for Field Service

Field Description
the work type doesn’t list a template or no work type is specified,
the line item uses the default service report template.

Note: This field stays blank unless you update it on the line
item. So to find out which template the line item’s service
reports will use, check its work type.

Service Territory The service territory where the line item work is taking place.

Start Date The date when the line item goes into effect.

State The state where the line item is completed. Maximum length is 80
characters.

Status The status of the line item. The picklist includes the following values,
which can be customized:
• New—Line item was created, but there hasn’t yet been any
activity.
• In Progress—Work has begun.
• On Hold—Work is paused.
• Completed—Work is complete.
• Cannot Complete—Work could not be completed.
• Closed—All work and associated activity is complete.
• Canceled—Work is canceled, typically before any work began.

Status Category The category that each status value falls into. The Status Category
field has eight default values: seven values which are identical to
the default Status values, and a None value for statuses without a
status category.
If you create custom Status values, you must indicate which
category it belongs to. For example, if you create a Waiting for
Response value, you may decide that it belongs in the On Hold
category.
To learn which processes reference Status Category, see How are
Status Categories Used?

Street The street number and name where the line item is completed.

Subject The line item’s subject. For example, “Tire Check.”

Subtotal The line item’s unit price multiplied by the quantity. (Read only)

Suggested Maintenance Date Date when maintenance work is planned.

Total Price The line item’s subtotal with discounts applied. (Read only)

Unit Price By default, the unit price for a line item is the product’s list price
from the price book, but you can change it.

283
Field Service Lightning Work Type Fields for Field Service

Field Description
Work Order The parent work order of the line item. Because work order line
items must be associated with a work order, this field is required.

Work Order Line Item Number An auto-generated number that identifies the work order line item.

Work Type The work type associated with the line item. When a work type is
selected, the work order line item automatically inherits the work
type’s Duration, Duration Type, and required skills.

Work Type Fields for Field Service

Work types have the following fields. Some fields may not be visible or editable depending on your
EDITIONS
page layout and field-level security settings.
Available in: Salesforce
Field Name Description Classic and Lightning
Auto-Create Service Select to automatically create service appointments on work orders Experience
Appointment or work order line items that use the work type. The Field Service Lightning
core features, managed
Note:
package, and mobile app
• By default, the Due Date on auto-created service are available in Enterprise,
appointments is seven days after the created date. Admins Performance, Unlimited,
can adjust this offset from the Field Service Settings page and Developer Editions.
in Setup, or by updating the Due Date Offset field on a Work orders are also
work type (a Field Service Lightning managed package available in Professional
feature). Edition.
• If a work type with the Auto-Create Service Appointment
option selected is added to an existing work order or work
order line item, a service appointment is only created for
the work order or work order line item if it doesn’t yet have
one.
• If someone updates an existing work type by selecting the
Auto-Create Service Appointment option, service
appointments aren’t created on work orders and work
order line items that were already using the work type.

Description The description of the work type. Try to add details about the task or
tasks that this work type represents.

Duration Type The unit of the Estimated Duration: Minutes or Hours.

Estimated Duration The estimated length of the work. The estimated duration is in
minutes or hours based on the value selected in the Duration Type
field.

Exact Appointments If selected, service appointment time slots reflect the time needed
for the work rather than a time window in which the work occurs.

284
Field Service Lightning Work Type Fields for Field Service

Field Name Description

This setting is useful, for example, for work types such as office or showroom visits that have an
exact start time.

Minimum Crew Size The minimum crew size allowed for a crew assigned to records using the work type.
If you’re not using the Field Service Lightning managed package, this field serves as a suggestion
rather than a rule. If you are using the managed package, the scheduling optimizer counts the
number of service crew members on a service crew to determine whether it fits a record’s
minimum crew size requirement.

Note: This field is hidden for all users by default. To use it, update its field-level security
settings and add it to your work type page layouts.

Name The name of the work type. Try to use a name that helps users quickly understand the type of
work orders that can be created from the work type. For example, “Annual Refrigerator
Maintenance” or “Valve Replacement.”

Recommended Crew Size The recommended number of people on the service crew assigned to the record using this
work type.

Note: This field is hidden for all users by default. To use it, update its field-level security
settings and add it to your work type page layouts.

Service Report Template The service report template associated with the work type.
If you choose not to specify a service report template on a work order, it uses the service report
template listed on its work type. If the work type doesn’t list a template or no work type is
specified, the work order uses the default service report template. The same is true for work
order line items.

285
Field Service Lightning Field Service Lightning Mobile App

Field Service Lightning Mobile App

The Field Service Lightning mobile app for Android and iOS is an all-in-one tool for field service
EDITIONS
technicians on the go. This enterprise-class mobile experience leverages Salesforce in a lightweight
design optimized for a modern mobile workforce. Offline capability means that users can keep Available in: Salesforce
working without internet connectivity and know that all their changes are saved. And the app is Classic and Lightning
highly customizable, allowing you to tailor it to your unique field service needs. Experience
Review this table to learn what the app has to offer. If you aren’t yet using Field Service Lightning
The Field Service Lightning
in Salesforce, see Set Up Field Service Lightning before getting started with the app. core features, managed
package, and mobile app
Feature Description are available in Enterprise,
Offline capability The app works offline, so technicians can Performance, Unlimited,
and Developer Editions.
complete their work even with limited or no
Work orders are also
network connectivity.
available in Professional
Push notifications Push notifications help your mobile workforce Edition.
stay up to date, making sure they never miss an
Field Service Lightning
important event. mobile users need the Field
Custom branding Brand the app to give it your company’s look Service Mobile user license
and feel. to access the app.

Configurable layouts Flexible layouts let you choose what record

information to display to your users.

Configurable actions Configure quick actions to help users quickly

complete common tasks, pass record data to
other apps, and build flows to guide your team
through collecting information and finalizing
jobs.

Chatter Communicate with dispatchers, partners, and

customers using Chatter.

Community user access Give members of your Salesforce

Community--like contractors--custom access to
your field service operation.

Geolocation tracking Keep tabs on service resources and enable

smarter scheduling with resource geolocation
tracking.

Service reports Create previewable service reports summarizing

field service visits. Seal the deal by capturing
customers’ signatures on the reports.

Salesforce Knowledge integration Attach specs, instructions, and best practices to

work orders and work order line items to keep
relevant information at your team’s fingertips.

Work order overview screen Help your team quickly find the information they
need to complete assignments. The work order

286
Field Service Lightning Field Service Lightning Mobile App Requirements

Feature Description
overview screen displays information about a work order’s service
appointments, line items, asset history, and more.

Find nearby work Help your team find other work orders in the same location so they
can take care of nearby jobs.

Inventory tab Let your team manage track consumption, request products, and
view their inventory from the app.

Field Service Lightning Mobile App Requirements

Learn about the mobile app’s device, connectivity, edition, and license requirements.
EDITIONS

Supported Devices Available in: Salesforce

Classic and Lightning
Experience
Supported Devices Supported Mobile OS Other Requirements
The Field Service Lightning
Android: All major Android Version 6.0 and later Google Play Services version core features, managed
devices are supported. The app 17.0.0 and later package, and mobile app
is optimized for Samsung and are available in Enterprise,
Google Pixel devices. Field Service Lightning Mobile
Performance, Unlimited,
app for Android isn’t supported
and Developer Editions.
on tablets when using a
Work orders are also
restricted profile. available in Professional
Edition.
iOS: iOS 12.0 or later
Field Service Lightning
• iPhone 5s or later models
mobile users need the Field
• iPad 5th generation or later Service Mobile user license
models to access the app.
• iPad Air 2 and iPad Pro
• iPad mini 2 or later models

287
Field Service Lightning Field Service Lightning Mobile App Considerations

Because we enhance functionality with every release, we support the latest version of the Field Service Lightning app available in Google
Play or the App Store only.
For optimal performance, keep your mobile devices’ operating systems updated and upgrade to the latest model of devices as allowed
by your mobile plan. Future versions of the Field Service Lightning mobile app may require removing support for older operating systems,
and sometimes newer operating systems don’t perform well on older devices.
Salesforce Customer Support uses commercially reasonable efforts to troubleshoot issues with the Field Service Lightning app, provided:
• A user’s device meets current minimum platform requirements
• Field Service Lightning app users have the most recent version installed

Wireless Connection
The Field Service Lightning app is optimized for offline performance, but a Wi-Fi® or cellular network connection is needed for the app
to communicate with Salesforce. For cellular connections, a 3G network or faster is required. For the best performance, we recommend
using Wi-Fi or LTE.

Field Service Lightning Mobile App Considerations

Review considerations for the Field Service Lightning mobile app for Android and iOS.
EDITIONS

Service Appointments Available in: Salesforce

Classic and Lightning
• Service appointment status can’t be updated manually from the mobile app, but you can create Experience
a flow to let users update it.
The Field Service Lightning
• The Recently Viewed service appointments list view shows all service appointments assigned core features, managed
to a user, even if the user has not viewed them. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
Service Reports and Developer Editions.
• Users cannot select a template when creating a service report in the mobile app. Instead, a Work orders are also
template is selected based on the following order: available in Professional
Edition.
1. The work order template
2. The work type template Field Service Lightning
mobile users need the Field
3. The standard template Service Mobile user license
to access the app.
• Service report previews have the following limitations:
– Although users can make an offline request to generate a service report, the final PDF is
created only when the user's device is online.
– The app doesn’t automatically get the latest data before generating a service report preview, so data in service report previews
could be out of date. This applies to both online and offline service report previews.
– If a reference field exceeds the maximum priming depth of 2, it isn't populated.
– Formula field values could be inaccurate in a preview because they aren’t dynamically calculated.
– Roll-up summary fields are blank.
– Related lists behave differently in mobile previews.
• The order of records in related lists could be different between the preview and the printed report.

288
Field Service Lightning Field Service Lightning Mobile App Considerations

• If a service report template includes a related list, but the record that the service report is being generated for doesn’t have
the related list on its page layout, the related list isn’t populated.
• On the printed report, all related lists are printed. In the mobile preview, a related list must be on the preview page layout
to appear on the preview.

– The following elements aren’t visible:

• Cases related list
• Headers and footers
• Organization fields
• Certain data fields
• Images in rich text fields on a service report template or service appointment, work order, or work order line item page layout

Inventory Management
• App users can add only one serialized product item as a product consumed on work orders. This limitation doesn’t apply to non-mobile
platforms.
• For better performance, only 1,000 of the most recently modified inventory items are primed.
• Only 1,000 products are shown in inventory lists.

Chatter
• The Feed tab in iOS is supported only on the work order, work order line item, service appointment, and case objects. The Feed tab
in Android is supported only on the work order, work order line item, and service appointment objects.
• (Android only) Chatter is disabled when the app doesn’t have internet connectivity.

Knowledge
• (iOS only) Images in knowledge articles display normally if they are hosted outside of Salesforce. Images uploaded to Salesforce
don't load correctly. As an alternative, we recommend using an image link that users can open themselves. You can avoid this issue
by selecting the option to use POST requests for cross-domain sessions. Find this option on the Session Settings page in Setup.
• (Android only) If a device is running in any of Salesforce’s 26 supported languages, the app automatically translates knowledge
articles to that language. Otherwise, the app defaults to English.
• (Android only) The Knowledge Article action isn't visible on the Work Order Overview screen. View knowledge articles using the
related list.

Barcode Scanner
• The barcode scanner is compatible only with 1D serial barcodes and 2D QR codes.
• In barcode scanning, the Android app uses the Zebra Crossing library. The iOS app uses Apple’s built-in libraries, except for
AVMetadataObjectTypeFace. For details, see AVMetadataObjectType.

Flows
• Select formula functions and operators are available offline. See Available Formula Functions and Operators on page 327.
• Screen flows launched using quick actions or app extensions aren't supported.

289
Field Service Lightning Field Service Lightning Mobile App Considerations

• Email alert actions aren't supported in flows.

• Paused flows aren't supported. If you leave a flow in progress and exit the Field Service Lightning mobile app, you can't resume the
flow where you left off.
• The wasSelected operator can’t be used in decisions.
• For eval() functions, the boolean values true and false are case-sensitive.
• Hardcoded ID values must be 18 digits long. 15-digit values aren’t supported.
• Apex classes aren’t supported in flows.
• Fault connectors aren't supported in flows.
• When uploading images in flows, the content document IDs parameter isn’t supported. Admins must create a flow confirmation
screen to show which images were uploaded. Videos and other file types aren’t supported.
• Flows don’t support the following elements. Adding these elements to a flow causes it to immediately display an error.
– Lightning components (except for file upload)
– Output parameters on file upload except for “Uploaded File Names”
– Choice resources with Display Text Input enabled
– Actions with output parameters

Note: Some flows that have actions with output parameters may not cause an error immediately, but they are still not
supported.

• Flow picklists that include a default value are not supported. If you choose a default value, it is not shown as the default value in the
picklist.
• Flow record variables require record fields to be accessed through their field API names. Use of field relationship names is not
supported.
• Record field lookups are limited to one level of indentation. If more levels are required, use assignment elements.
• Flow text areas have a 2000 character limit.
• Using semicolons when defining user choices in flow checkbox groups and multi-select picklists is not supported. If you use semicolons
for user choices, the data does not render accurately.
• Record Choice Sets do not retain the value that is selected. A Record Choice Set variable cannot be used to determine what selection
was made; however, the component used to make the selection (such as a picklist) saves that value for later use.

Lightning App Extensions

• The Salesforce app no longer supports parameters passed through Lightning app extensions. Lightning app extensions open the
Salesforce app on the mobile device but don't read any of the parameters.
• The Salesforce app can launch and accept parameters for Visualforce pages exposed as a Lightning Page Tab. However, the Lightning
Page Tab name can’t have any spaces in it.

Work Orders
To numerically sort work order line item records, use the following format.
• Add a zero, if needed, to create a two-digit number. For example, 02 correctly sorts before 12.
• If 100 items or more are required, add zeros to create a three-digit number. For example, 002 and 012 correctly sorts before 100.

290
Field Service Lightning Field Service Lightning Mobile App Considerations

General Limitations
• When displaying related lists in the mobile app (such as the work order line items for a work order), we may not be able to display
more than 200 items due to performance considerations.
• Plain text fields no longer support rich text or HTML content.
• Time fields (without a date) are not supported in the FSL mobile app.
• Under the profile tab, only 10 resource absence records are displayed.
• The Notes related list is not supported.
• Under the Files related list, only 50 files are displayed.
• Visualforce pages aren’t supported in the app, including actions and Visualforce components on page layouts.
• Lightning Component and custom override quick actions aren’t supported.
• Lookup filters aren’t supported.
• Enhanced notes are not supported.
• Users are not able to change the ownership of objects, like Service Appointments or Work Orders.
• In some countries, certain mapping features (such as driving directions and ETA) are not supported for Apple or Google maps.
• Google Maps is the only supported mapping application for features in the Field Service Lightning app.
• If a user's device is offline, its location data can't be accessed. When the device is back online, its last known location is sent to
Salesforce.
• Contact cards can't be viewed on the Work Order Overview screen. To view the contact information for a work order, add the Contact
field to the FSL Service Appointment Layout.
• Formulas aren't supported on the Details tab.
• If a default list view is selected, all list views that a user has access to display in the app. There is no way to hide or suppress specific
list views in the Field Service app.
• The Event Insights card is available only on Android devices.
• (Android only) By default, you must use a Lightning app extension to automatically open records in the Salesforce app.
• (Android only) There is no Notification tab.
• (Android only) Features that use Google services, like push notifications and Google maps, are not supported in China.
• (Android only) Related list file previews are limited to .pdf, .html, and .txt file types. To view other file types you must have third-party
apps installed. For example, to view spreadsheets you need to download an application like Google Sheets.
• (iOS only) Only plain text is supported for rich text fields.
• (iOS only) Default values are not available in offline mode.
• (iOS only) Lookup fields, like Account, aren’t supported on the Schedule, Work Order, and Work Order Line Item tabs.
• (iOS only) Custom override on actions isn’t supported, including custom override on lookup logic.

291
Field Service Lightning Field Service Lightning Mobile Security

Field Service Lightning Mobile Security

Protect and safely store data that is gathered from the Field Service Lightning mobile app (Android
EDITIONS
and iOS).
The Field Service Lightning App is built with the Salesforce Mobile SDK. The Salesforce Mobile SDK Available in: Salesforce
provides a set of low-level services that include security and authentication to applications that are Classic and Lightning
built using this framework. Experience

For information about data protection regulations and Service Cloud, see Data Protection and The Field Service Lightning
Privacy. core features, managed
package, and mobile app
are available in Enterprise,
Local Encryption at Rest Performance, Unlimited,
Encryption boosts the security of your customers’ data and helps you comply with privacy policies, and Developer Editions.
Work orders are also
regulatory requirements, and contractual obligations. Shield Platform Encryption and Field Audit
available in Professional
Trail are supported for the following fields on work orders, work order line items, and service
Edition.
appointments:
• Description Field Service Lightning
mobile users need the Field
• Subject Service Mobile user license
• Address (Street and City only) to access the app.
To encrypt these fields, add them to your Encryption Policy in Setup. The Subject and Address fields
support both probabilistic and deterministic encryption, while the Description field supports only
probabilistic encryption. If Field Audit Trail is enabled, you can set field history data retention policies for the fields whose data you want
to retain.

Important:
• Encryption is not supported for the Latitude and Longitude fields, which could be used to pinpoint an address.
• When you encrypt a field, existing values aren’t encrypted. Contact Salesforce for help with encrypting existing data.

Table 1: Offline Data

Salesforce App Field Service Lightning App

Offline data is stored using Core Data, and encrypted using Data is stored using the Sqlcipher provider for Sqlite3. Cached data
NSFileProtectionCompleteUntilFirstUserAuthentication. This is purged based on a least-recently-used cache policy.
authentication dictates how passcodes are exposed internally to
access the offline data. The passcode for the offline data is removed
from the local keychain when Salesforce is closed or running in
the background. Salesforce offline data is only accessible when the
app is open and in the foreground.

Table 2: Files and Attachments

Salesforce App Field Service Lightning App

Files and attachments are stored on the device’s file system in a Files are stored in an iOS sandboxed directory and are also
double-encrypted format. The device’s hardware encryption encrypted by application encryption. While viewing, files are
encrypts the files while the device is locked. In addition, Salesforce temporarily unencrypted in another sandbox directory, but are

292
Field Service Lightning Field Service Lightning Mobile Security

Salesforce App Field Service Lightning App

encrypts using an AES algorithm (128-bit block size and 256-bit erased when the app is in the background or when the viewer is
key size). When the file is viewed, there's a temporary unencrypted dismissed. Also, the temp directory is cleaned when the application
copy kept on the file system (removed when the 'viewing' is launched.
operation is complete).

Table 3: Chatter Feed Data

Salesforce App Field Service Lightning App

Feed data is stored using Core Data, and encrypted using All Chatter feed data is stored with the Sqlcipher provider for
NSFileProtectionCompleteUntilFirstUserAuthentication. This Sqlite3. Cached data is purged based on a least-recently-used cache
authentication dictates how passcodes are exposed internally to policy.
access the feed data. The passcode for the feed data is removed In addition, Feed functionality is provided by a shared component,
from the local keychain when Salesforce is closed or running in which makes the experience on iOS and Android the same.
the background. Salesforce feed data is only accessible when the
app is open and in the foreground.
Also, the feed data storage is time-based. The feed cache purges
items older than one week, unless the remainder of feed items is
fewer than 25 items. Also feeds that have more than 500 items
have their excess items removed.

Server-Side Encryption at Rest

Salesforce provides encryption abilities for data at rest on the Salesforce servers. The Platform Encryption feature allows customers to
create policies at the field-level to encrypt sensitive data. This feature supports custom objects, and a subset of standard fields on standard
objects. As of the time of this writing, encryption is supported for some fields on the following standard objects: Account, Contact,
Opportunity, Lead, Case, and Case Comment.
Custom fields on these or other objects can be encrypted assuming that they use data types that can be encrypted.

Encrypting Data in Transit

Data transmitted to and from the Salesforce server is protected using SSL. Authentication, access controls, and digital signatures are
protected using SHA-256.

User Authentication

Salesforce App Field Service Lightning App

the Salesforce mobile app supports certificate-based login, whereby Certificate-based authentication is a function of the Identity
the customer can push a unique certificate to the device using Provider. Files are stored in the application directory and are
Mobile Device Management (MDM). The certificate can encrypted using application encryption. The files are decrypted
authenticate the user to Salesforce. while viewing and deleted after the view operation is complete.
The directory is cleared when the user logs out.

293
Field Service Lightning Field Service Lightning Mobile Security

Salesforce App Field Service Lightning App

Alternatively, Salesforce’s Lightning Login feature has multifactor
authentication from the Salesforce Authenticator app. The factors
are:
• What you have: The mobile device
• What you are: If fingerprint biometrics is enabled on the device
• What you know: if the device is enabled for PIN-based login.
Lightning Login is only enabled on devices that have either PIN or
fingerprint enabled.

Trusted IP Ranges
Logins to the Field Service Lightning mobile app can be restricted to specific trusted IP ranges, which is also true for the Salesforce mobile
app. You can implement this using a Virtual Private Network (VPN) solution on mobile devices. After logging in to VPN, users can log in
to the app. Afterwards, the user can log in to Salesforce.

Device Identification
Salesforce is piloting a new feature to track device fingerprints accessing the Salesforce services. The feature supports the ability to see
who logged in with a particular device and to revoke access to specific devices.

Handling Sensitive Data

To prevent leakage of sensitive data, Salesforce apps support four settings to limit data exfiltration on a mobile device.
• DISABLE_EXTERNAL_PASTE : Allows users to copy-and-paste data within the app, but prevents users from pasting data copied
from the app to other apps or OS features.

Note: This feature does not work on Samsung phones (and other manufacturers of Android phones) where a custom clipboard
implementation is used.

• FORCE_EMAIL_CLIENT_TO : If a user taps on an email action within the app, the user is directed to the email app specified in the
attribute value.
• SHOW_OPEN_IN : Prevents users from opening files in applications outside of the app.
• SHOW_PRINT : Used to disable printing from within the app.
The following table shows the level of support for these features in the Field Service Lightning (FSL) mobile app as well as the Salesforce
mobile app.

Setting Supported on FSL Mobile Supported on Salesforce Mobile

DISABLE_EXTERNAL_PASTE (Default: FALSE)

FORCE_EMAIL_CLIENT_TO

SHOW_OPEN_IN (Default: TRUE)

SHOW_PRINT

294
Field Service Lightning Field Service Lightning Android and iOS Mobile App
Comparison

The Field Service Mobile app settings are non-restrictive by default. To change a setting from the default value, go to Setup.
Enter Connected Apps in the Quick Find box, select Manage Connected Apps, then click the name of the Field Service connected
app. Update the attribute from the Custom Attributes section on the connected app page.

Mobile Device Management

Salesforce provides an extra level of security compliance with the most popular Mobile Device Management (MDM) suites. Both Android
and iOS, with an MDM, give you enhanced functionality for distribution and control over your users’ devices. The enhanced security
functions, when you combine Salesforce with an MDM, include certificate-based authentication and automatic custom host provisioning.

MDM Supported on FSL Mobile Supported on Salesforce Mobile

RequireCertAuth

AppServiceHosts

AppServiceHostLabels

OnlyShowAuthorizedHosts

ClearClipboardOnBackground

Field Service Lightning Android and iOS Mobile App Comparison

Learn about the main feature differences between the Android and iOS versions of the Field Service
EDITIONS
Lightning mobile app.
Available in: Salesforce
Feature Supported on Android Supported on iOS Classic and Lightning
Native deep linking to the Experience
Salesforce App The Field Service Lightning
core features, managed
Mentioning people and groups
package, and mobile app
Video, image, and PDF posts are available in Enterprise,
Performance, Unlimited,
Deleting posts and Developer Editions.
Work orders are also
Liking and bookmarking posts available in Professional
Edition.
Offline posts
Field Service Lightning
Find work by location mobile users need the Field
Service Mobile user license
Products required to access the app.

295
Field Service Lightning Supported Data Types in the Field Service Lightning Mobile
App

Supported Data Types in the Field Service Lightning Mobile App

Learn which data types are supported in the Field Service Lightning mobile app for Android and
EDITIONS
iOS.
Available in: Salesforce
Data Type Supported Classic and Lightning
Auto Number Experience

The Field Service Lightning

Formula core features, managed
package, and mobile app
Roll-Up Summary
are available in Enterprise,
Performance, Unlimited,
Lookup Relationships
and Developer Editions.
External Lookup Relationship Work orders are also
available in Professional
Checkbox Edition.
(Shows Yes/No)
Field Service Lightning
Currency
mobile users need the Field
Service Mobile user license
Date
to access the app.
Date/Time (The following fields aren’t supported:
Scheduled End, Scheduled Start, Arrival Window
End, Arrival Window Start)

Email

Geolocation

Number

Percent

Phone

Picklist (Picklists with fewer than six options are

shown in an expanded view.)

Picklist (Multiple Select) (Picklists with fewer than six options are
shown in an expanded view.)

Text

Text Area

Text Area (Long)

Text Area (Rich)

Text Area (Encrypted)

Time (Read Only)

296
Field Service Lightning Download the Connected App

Data Type Supported

URL

Download the Connected App

Before you configure user access and customize the Field Service Lightning mobile app, download
EDITIONS
the connected app.
The connected app is different from the actual Field Service Lightning mobile app, but equally Available in: Salesforce
important. The connected app provides push notifications, geolocation services, and other app Classic and Lightning
settings related to service report generation and app customization. If your team uses mobile Experience
devices, download the connected app for Field Service Lightning.
The Field Service Lightning
Note: Apple and Google Maps provide high-level route and ETA in the FSL mobile app. To core features, managed
get this functionality, Android users must have the Apex Rest Services permission enabled package, and mobile app
for the mobile worker's user profile. See Set Apex Class Access from the Class List Page. To are available in Enterprise,
Performance, Unlimited,
get detailed driving directions, both iOS and Android users can click the Get Directions button.
and Developer Editions.
This links out to external mapping applications you have installed on your device.
Work orders are also
available in Professional
Edition.

Field Service Lightning

mobile users need the Field
Service Mobile user license
to access the app.

USER PERMISSIONS

To install connected apps

and update user
permissions:
• Customize Application

297
Field Service Lightning Give Users Access to the Field Service Lightning Mobile App

Give Users Access to the Field Service Lightning Mobile App

To give your mobile workforce access to the Field Service Lightning mobile app, set them up with
EDITIONS
the right user license and permissions. These steps also apply to community users.
1. Assign the Field Service Mobile user license to the user. Available in: Salesforce
Classic and Lightning
2. Create a Field Service Mobile permission set.
Experience
a. From Setup, enter Permission Sets in the Quick Find box, then select Permission
Sets. The Field Service Lightning
core features, managed
b. Click New. package, and mobile app
c. Select the Field Service Mobile license from the picklist. are available in Enterprise,
Performance, Unlimited,
d. Click Save.
and Developer Editions.
e. Click System Permissions, then click Edit. Work orders are also
available in Professional
f. Select the Field Service Standard and Field Service Mobile system permissions.
Edition.
g. Click Save.
Field Service Lightning
3. Customize the permission set’s object permissions. mobile users need the Field
Click Object Settings, then click an object’s name to modify its permissions. Save your changes Service Mobile user license
after modifying an object. At a minimum, app users need the following permissions. You can to access the app.
assign additional permissions to objects such as assets, accounts, and products, as you see fit.
USER PERMISSIONS
Object Name Object Permission Field Permission Needed
Needed To create permission sets:
• Manage Profiles and
Contact Read Email, Name, Phone, Title Permission Sets
Resource Absence Read, Create, Edit Absence Number, End Time, To manage users:
Start Time, Resource, Type • Manage Users
To create service resources:
Service Appointment Read, Edit Address, Appointment
• Create on service
Number, Contact, Created By,
resources
Created Date, Owner, Parent
Record, Parent Record Type,
Parent Record Status,
Category, Scheduled Start,
Scheduled End, Status, Work
Type

Service Resource Read, Edit Active, User

Work Order Read, Create, Edit None

4. Add the API Enabled system permission to the permission set.

a. Click System Permissions.
b. Click Edit.
c. Select API Enabled.
d. Click Save.

298
Field Service Lightning Give Users Access to the Field Service Lightning Mobile App

5. Assign the permission set to your mobile app users.

a. Click Manage Assignments, and then click Add Assignments.
b. Select all users who needs the app permission set.
c. Click Assign.

6. Create a service resource record for each user. For instructions, see Create Service Resources for Field Service.

Important: To use the Field Service Lightning mobile app, each user needs Read access to their service resource record.

7. (Android only) Add Apex class access to the user profile for Google Maps functionality.
a. From Setup, enter Profiles in the Quick Find box, then select Profiles.
b. Select the profile for the users who require access to Google Maps.
c. From the profile page, click Apex Class Access.
d. Click Edit.
e. Add the following Apex classes to the list of Enabled Apex Classes: GoogleApis_geo, GoogleApis_direction.
f. Click Save.

299
Field Service Lightning Let Users Manage Inventory from the Field Service Lightning
Mobile App

Let Users Manage Inventory from the Field Service Lightning Mobile App
Customize your page layouts and user permissions so that your team can take care of inventory
EDITIONS
management tasks. For example, give technicians the ability to log product consumption, create
product requests, and keep their service vehicle inventory current. Inventory management is Available in: Salesforce
supported on both Android and iOS. Classic and Lightning
Before getting started, get to know Salesforce inventory management terms and processes. See Experience
Set Up Your Field Service Inventory.
The Field Service Lightning
core features, managed
package, and mobile app
Show the Inventory Tab (Android and iOS)
are available in Enterprise,
Let users view and update their inventory, log inventory consumption, and request parts from the Performance, Unlimited,
Inventory tab. To see the Inventory tab, app users must be active service resources who are associated and Developer Editions.
with a mobile inventory location. They must have at least Read access to product items or product Work orders are also
requests. available in Professional
Edition.
A location represents a physical area where products are stored. Because field service workers
typically bring products with them in their vehicle, you can create a field location type to represent Field Service Lightning
their inventory, such as a vehicle or toolbox. mobile users need the Field
Service Mobile user license
1. From the full Salesforce site, click the Service Resources tab.
to access the app.
2. On a service resource, click Edit.
3. In the Location lookup field, enter a location that has both Inventory Location and Mobile USER PERMISSIONS
Location selected.
To update page layouts:
Note: If you don’t see the Location field, add it to your service resource page layout.
• Customize Application
To update connected apps:
• Customize Application
AND either
Modify All Data
OR
Manage Connected
Apps

300
Field Service Lightning Let Users Manage Inventory from the Field Service Lightning
Mobile App

Because this service resource is associated with the location, the user sees the Inventory tab in the app.

Manage Inventory in the Field (Android and iOS)

To let service resources who are associated with a mobile inventory location manage their inventory, you create product items that
represent the stock. Each product item is linked to a location, such as a van or warehouse, and to a specific inventory product. When
you create product items, you can track inventory usage and restock when necessary.

Note: Only 1,000 products are shown in inventory lists in the Salesforce mobile app.

1. On the Product Items tab in the full Salesforce site, create product items for the mobile inventory location associated with the service
resource. For example, if Service Van 42 contains 30 batteries, create a product item associated with the Service Van 42 location and
the Battery product. For more information, see Create Product Items to Represent Inventory.
2. To let your team create or update the product items representing their inventory, assign the object permissions listed in Create
Product Items to Represent Inventory.

Log Product Consumption (Android and iOS)

You can let users who are associated with a mobile inventory location create product consumed records from the field service app.

301
Field Service Lightning Customize the Field Service Lightning Mobile App

1. Add the Products Consumed related list to the work order page layout to make it visible in the Products and Related tabs of the
work order carousel.
2. Assign the user the object permissions listed in Track Inventory Consumption.

Note: Android and iOS users can consume only one serialized product item per product per work order using the Products
Consumed related list. For example, you could have multiple product items that are assigned serial numbers and that are all
associated with your Inverter product. An app user can add only one of them as a product consumed on a specific work order.
This limit doesn’t apply to non-mobile platforms.

Let Users Add Required Products (iOS Only)

If a particular product is required to complete a work order or work order line item, add it as a required product. You can let your team
create product required records.
1. Add the Products Required related list to work order and work order line item page layouts.
2. Assign the user the object permissions listed in Track Required Inventory.

Customize the Field Service Lightning Mobile App

Learn how to customize the Field Service Lightning mobile app’s screens, actions, and branding
EDITIONS
settings, and create unique mobile experiences for different user profiles.

Important: Available in: Salesforce

Classic and Lightning
• Users must re-log in to the app to receive metadata updates like page layout changes. Experience
• Salesforce doesn’t recommend manually deleting metadata. If the mobile device goes
The Field Service Lightning
offline immediately after metadata is deleted, data may not be available until the device
core features, managed
is back online. After metadata is deleted, refresh all application tabs—Schedule, Inventory,
package, and mobile app
and Profile—by pulling down on each screen.
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
IN THIS SECTION:
Work orders are also
Customize the Field Service Lightning Mobile App by User Profile available in Professional
Assign unique configurations of mobile app settings to different user profiles to accommodate Edition.
the needs of contractors, supervisors, and other app users.
Field Service Lightning
Customize Screens in the Field Service Lightning Mobile App mobile users need the Field
Control which fields users see in the Field Service Lightning mobile app by updating page and Service Mobile user license
search layouts. to access the app.
Brand the Field Service Lightning Mobile App
Give the Field Service Lightning mobile app your company’s look and feel by customizing the colors used in the user interface. Apply
your company colors or optimize the color scheme to compensate for the relative brightness of your mobile workforce’s work
environments.
Add a Profile Tab Background Image in the Field Service Lightning Mobile App
Add a Profile Tab Background Image in the Field Service Lightning Mobile App.
Track Service Resource Geolocation with the Field Service Lightning Mobile App
Use geolocation to get a bird’s-eye view of your mobile workforce. You can exclude certain users from geolocation tracking.

302
Field Service Lightning Customize the Field Service Lightning Mobile App

Set Up Custom Actions in the Field Service Lightning Mobile App

Configure quick actions, global actions, flows, and app extensions to help your team work more efficiently from the field. Actions
are displayed in a predefined order in the action launcher on record pages in the app.

Customize the Field Service Lightning Mobile App by User Profile

Assign unique configurations of mobile app settings to different user profiles to accommodate the
EDITIONS
needs of contractors, supervisors, and other app users.
For example, you can create a different branding experience for contractors, or assign particular Available in: Salesforce
geolocation settings or app extensions to technicians versus supervisors. Alternatively, you can use Classic and Lightning
the same settings configuration for all users. Experience

1. From Setup, enter Field Service Mobile Settings in the Quick Find box, The Field Service Lightning
then select Field Service Mobile Settings core features, managed
package, and mobile app
2. Your org comes with one settings configuration named Field Service Mobile Settings, which is
are available in Enterprise,
assigned to all user profiles by default.
Performance, Unlimited,
• To edit that configuration, click Edit. and Developer Editions.
• To create a new configuration of mobile settings that can be assigned to different user Work orders are also
profiles, click New. available in Professional
Edition.
3. Update the label if desired.
Field Service Lightning
For example, you might want two settings configurations named Supervisor Settings mobile users need the Field
and Technician Settings, respectively. Service Mobile user license
to access the app.
4. Update the settings as needed.

Tip: To give app users edit access to their field service records, select Enable Full Edit
USER PERMISSIONS
on Records. If you want to restrict editing from the mobile app, don’t select this option.
To configure Field Service
5. Click Save. Mobile Settings:
6. Click Mobile Settings Assignment, then click Edit Assignment to assign your settings • Customize Application
configurations to user profiles.

303
Field Service Lightning Customize the Field Service Lightning Mobile App

Customize Screens in the Field Service Lightning Mobile App

Control which fields users see in the Field Service Lightning mobile app by updating page and
EDITIONS
search layouts.
Records in the Field Service Lightning mobile app display the first three fields in the corresponding Available in: Salesforce
page layout. Some fields are hard-coded, meaning they are shown in the app regardless of their Classic and Lightning
place in the page layout. Experience

Important: The Field Service Lightning

core features, managed
• When you update metadata like a page layout, users must log out and log into the Field package, and mobile app
Service Lightning mobile app to see the changes. are available in Enterprise,
• Not all field types are supported in the Field Service Lightning app. Review Supported Performance, Unlimited,
Data Types in the Field Service Lightning Mobile App before you configure your layouts. and Developer Editions.
Work orders are also
available in Professional
Screen in the mobile app Page Layout Details
Edition.
Absences Absences related list on the You can reach the Absences Field Service Lightning
Service Resource page layout screen from the Profile screen. mobile users need the Field
Resource absences are Service Mobile user license
to access the app.
displayed differently in the app
based on whether the start
time and end time fields are USER PERMISSIONS
included in the related list
layout. To modify page layouts:
• Customize Application
Inventory Search results layout on the The Inventory tab represents To create custom list views:
product item object. the items in the user’s • Read on the type of
inventory. It shows product record included in the list
items associated with the user’s AND
service resource record. Create and Customize
List Views
Service resources only see the
Inventory tab if they’re To create, edit, or delete
associated with a mobile public list views:
inventory location (which • Manage Public List
represents their service vehicle). Views
See Let Users Manage
Inventory from the Field Service
Lightning Mobile App.
On iOS, the Inventory tab
doesn’t use the Product Item
search layout and can’t be
customized.

Products Product search layout Users must be able to find

products to create product
requests and product items.

304
Field Service Lightning Customize the Field Service Lightning Mobile App

Screen in the mobile app Page Layout Details

Users viewing products in the app see the
Product Name field and the top 3 fields
in the search layout.

Note: To search Products, a

pricebook must be set on the parent
object. Only string fields are
searchable. Numbers, Dates and
other fields can't be searched.

Products Consumed Product consumed related list on the work You can reach the Products Consumed
order. Product consumed number must be screen from the Related tab or the Products
the first field. tab in the work order carousel.

Record Highlight for any record Compact Layout of the record (for example, A record highlight is a preview of a record.
Service Appointment Compact Layout) The top-most field in a record’s compact
layout is displayed prominently.

Record Lookup Search Layout of the record (for example, A record lookup is a search for a record. To
Contact Search Layout) change the search results, update the search
layout in your org.

Related Lists Related list layout Related list sorting uses the default page
layout sorting. If the user overrides the sort
setting, the app uses this setting for related
list sorting. Related list sorting only sorts on
one column.

Schedule • The layout selected in the Default The Schedule tab lists service appointments
List View Developer Name assigned to the user.
field on the Field Service Mobile Settings For details, see Customize the Schedule Tab.
assigned to the user’s profile.
• (If no list view is specified) Service Tip: The Default List View
Appointment search layout Developer Name is the name
of the list view that shows when the
mobile Service Appointment page
is first opened. If the Default
List View Developer
Name isn’t defined, mobile users
see their service appointments
within the date picker range. This list
and the list defined are available
offline. However, there isn't an
option to change to another list view
on the mobile device unless the
Default List View
Developer Name is defined.

305
Field Service Lightning Customize the Field Service Lightning Mobile App

Screen in the mobile app Page Layout Details

Service Appointment List view layout. The service appointment screen includes
the following fields in the following order:
• First field in the service appointment list
view (displayed as a title)
• Scheduled Start (only visible if the field
has a value)
• First three fields in the service
appointment search layout
• Address (only visible if the field has a
value)
• Scheduled End (only visible if the field
has a value)

Work Order Overview List view layout You can reach the Work Order Overview
• First field in Work Order compact layout screen by tapping a service appointment
is in bold in the app from the Schedule tab.

• Description field can’t be changed and

shows a max of 3 lines.
• Has up to 5 fields (including the title)
displayed in this layout

IN THIS SECTION:
Customize the Schedule Tab
The Schedule tab in the Field Service Lightning mobile app shows service appointments that are assigned to the user. The Schedule
tab layout is based on a list view specified in Setup. If no list view is specified, it uses the service appointment search layout.
Customize the Layout of the Work Order Overview Screen
When a user taps a service appointment on the Schedule tab, an overview of the work order is shown. You can customize the
highlights and cards shown on the work order overview screen.

306
Field Service Lightning Customize the Field Service Lightning Mobile App

Customize the Schedule Tab

The Schedule tab in the Field Service Lightning mobile app shows service appointments that are
EDITIONS
assigned to the user. The Schedule tab layout is based on a list view specified in Setup. If no list
view is specified, it uses the service appointment search layout. Available in: Salesforce
Classic and Lightning
Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Field Service Lightning

mobile users need the Field
Service Mobile user license
to access the app.

USER PERMISSIONS

To modify search layouts:

• Customize Application
To create custom list views:
• Read on the type of
record included in the list
AND
Create and Customize
List Views

To create, edit, or delete

public list views:
• Manage Public List
Views

307
Field Service Lightning Customize the Field Service Lightning Mobile App

You can base the Schedule tab on a list view. Using a list view allows you to set criteria to filter the records that appear to app users.
1. Create a service appointment list view with up to four fields. Set filter criteria to filter the records according to your use case. Note
the API name of the list view.
2. From Setup, enter Field Service Mobile Settings in the Quick Find box, then select Field Service Mobile
Settings.
3. Click Edit next to the mobile settings configuration you want to define the list view for.
4. In the Default List View Developer Name field, enter the API name of the list view you want to use.

Tip: The Default List View Developer Name is the name of the list view that shows when the mobile Service
Appointment page is first opened. If the Default List View Developer Name isn’t defined, mobile users see
their service appointments within the date picker range. This list and the list defined are available offline. However, there isn't
an option to change to another list view on the mobile device unless the Default List View Developer Name
is defined.

5. Click Save.
If no list view is specified in Setup, users viewing service appointments from the Schedule tab see the following fields:
• Scheduled Start
• Scheduled End
• Address
• Top field in the Service Appointment search layout (excluding the previous three).
Considerations for Customizing the Schedule Tab
• The service appointment calendar view appears differently on Android and iOS devices. On Android, the calendar uses a month
view. On iOS, the calendar uses a week view.
• If the Schedule tab is based on a list view, including the Scheduled Start field in your list view filter lets app users see a date picker
with a range of 45 days before and after the current date. If the list view doesn’t include this field, users just see a single Schedule
tab of the user’s appointments based on your filter criteria, as it would appear on the full Salesforce site.
• Service appointments in the schedule list are shown in chronological order. This order cannot be changed.
• Lookup fields, like Account, aren’t supported on the Schedule tab and won’t show up.
• Formulas aren't supported on the Schedule tab.

308
Field Service Lightning Customize the Field Service Lightning Mobile App

• The app prominently displays the top two fields of the service appointment search layout, so consider which fields your mobile
workforce needs to see on the Schedule tab. Many users, for example, may prefer to see Subject instead of the service appointment
ID. Scheduled Start and Address are displayed in the same location regardless of the list view or search layout settings
• Multi-day appointments appear on the Schedule tab in the following way:
– If a multi-day appointment includes both a Scheduled Start and Scheduled End, the appointment appears on the schedule for
every day between those two dates and includes a visual progress bar representing the job’s scheduled completion.
– If a multi-day appointment includes a Scheduled End but not a Scheduled Start, the appointment appears on the schedule every
day until the Scheduled End date.
– If a multi-day appointment includes a Scheduled Start but not a Scheduled End, the appointment appears on the schedule every
day after the Scheduled Start date until the appointment is complete.

Customize the Layout of the Work Order Overview Screen

When a user taps a service appointment on the Schedule tab, an overview of the work order is
EDITIONS
shown. You can customize the highlights and cards shown on the work order overview screen.
Available in: Salesforce
Classic and Lightning
Experience

The Field Service Lightning

core features, managed
package, and mobile app
are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Field Service Lightning

mobile users need the Field
Service Mobile user license
to access the app.

309
Field Service Lightning Customize the Field Service Lightning Mobile App

Important:
• When you modify a page layout, users must log out and log in to the Field Service Lightning mobile app to see the changes.
• Not all field types are supported in the Field Service Lightning app. Before you configure your layouts, review Supported Data
Types in the Field Service Lightning Mobile App

Change the Screen Layout

A preview of the work order is anchored to the top of the screen. This preview shows the first five fields in the work order compact layout,
with the Description field counted as one of the five. The first field in the compact layout appears in bold and is used as the title of the
work order overview. The Description field appears below the title and is followed by the next three fields in the compact layout.
1. From the Object Manager in Setup, select Work Order.
2. Click Compact Layouts.
3. Click the name of the compact layout and edit the layout as desired.
4. Save your changes.

Navigate the Work Order Carousel

The horizontal work order carousel lets users switch between the following views:
• Overview: Shows work order cards
• Products: Where users manage required and consumed products
• Details: Shows all supported fields on the work order page layout
• Related: Shows all related lists on the work order page layout
• Feed: Shows the Chatter feed if feed tracking is enabled
• Location: Shows work in the same location as the current appointment.

Add Cards
On the Overview tab in the work order carousel, users see information about the work order and its child records. The information appears
in cards, which are discrete spaces for different kinds of information. The following cards can be added to the work order overview screen.

Card Description How to Display and Available In

Customize
Asset Service History Provides context about the In Android, the Asset Service Android and iOS
maintenance history of an asset. History card displays the first
It shows the asset associated four fields in the work orders
with the current work order. It related list from the asset page
also lists the asset’s three most layout. The first field is displayed
recent work orders and provides prominently.
a link to view all associated work
orders. It does not show work In iOS, this card displays the
order line items that are work order number and the first
associated with the asset. field from the asset detail page
layout. Normally, the first field is
the asset name.

310
Field Service Lightning Customize the Field Service Lightning Mobile App

Card Description How to Display and Available In

Customize
Event Insights Shows diagnostic IoT data for In Setup, under Manage Android only
customers’ connected devices Connected Apps, enable Event
that helps field service Insights. Salesforce IoT is
technicians more quickly analyze included with Service Cloud in
and solve customer issues while Unlimited Edition.
on site. For details, see Salesforce
IoT.

Knowledge Shows knowledge articles that In iOS, the Knowledge card is iOS only
are attached to the work order, only visible if an article is
with a snippet of each article attached to the work order.
included.

Service Appointment Shows a map and the option to If the work order has one or Android only
navigate to the address of the more service appointments, the
appointment. If the address is Service Appointment card is
not set, the card instead visible.
presents the user with the
option to set the address, and The following fields on this card
then activate navigation. cannot be removed from it: Start
Time, End Time, Date, Address,
ETA (estimated time of arrival).

Service Report Displays service reports If a service report has been Android and iOS
associated with the work order’s previously generated, the
service appointments. Service Report card appears at
the top of the Overview tab.
There is no option to create a
service report. Otherwise, the
card appears at the bottom of
the Overview tab and includes
an option to create a service
report.
The Service Report card is visible
by default in iOS. To make the
card visible in Android, manually
add it to layout.

Work Order Line Item Shows a visual progress If the work order has work order Android and iOS
indicator for the work order and line items, the Work Order Line
lists its work order line items. iOS Item card is visible.
users with the proper
permissions can tap the + icon In Android, this card displays
to create line items. For details, four fields for each line item. The
see Let Users Create Work Order Work Order Line Item Number
Line Items from the Field Service field is always visible. It's
Lightning Mobile App. followed by the first three fields
from the Work Order Line Items

311
Field Service Lightning Customize the Field Service Lightning Mobile App

Card Description How to Display and Available In

Customize
related list. The card for child
Work Order Line Items is not
available in Android.
In iOS, this card displays the first
two fields from the Work Order
Line Items related list.

Brand the Field Service Lightning Mobile App

Give the Field Service Lightning mobile app your company’s look and feel by customizing the colors
EDITIONS
used in the user interface. Apply your company colors or optimize the color scheme to compensate
for the relative brightness of your mobile workforce’s work environments. Available in: Salesforce
1. From Setup, enter Field Service Mobile Settings in the Quick Find box, Classic and Lightning
and select Field Service Mobile Settings. Experience

2. Click Edit next to the mobile settings configuration you want to modify, or New to set up a The Field Service Lightning
new settings configuration. core features, managed
Each configuration can be assigned to one or more user profiles. package, and mobile app
are available in Enterprise,
3. Under Branding Colors, update the hex color code of each setting as needed. Performance, Unlimited,
and Developer Editions.
Important: Each value must consist of the # symbol followed by six letters or numbers. Work orders are also
available in Professional
4. When you have entered values for every token you wish to modify, click Save. Edition.
Users must log out and log in to the app to see changes to branding.
Field Service Lightning
mobile users need the Field
Note: iOS 13 and later app users can enable Dark Mode from their OS settings. However,
Service Mobile user license
this overrides the custom branding colors for some UI elements.
to access the app.

USER PERMISSIONS

To customize branding
colors:
• Customize Application

312
Field Service Lightning Customize the Field Service Lightning Mobile App

Token Name Description Default Value

Navbar Background Color The color of the top bar in the app. #803ABE

Navbar Inverted Color The secondary color of the top bar in the app. #FFFFFF

Brand Inverted Color The color of toasts and the contrast color for the floating action #FFFFFF
button.

Feedback Primary Color The color of error messages. #C23934

Feedback Secondary Color The color of success messages or progress icons. #13C4A3

Feedback Selected Color The color indicating the user’s current selection. #FFFFFF

Primary Brand Color The color of non-interactive areas in the app. #803ABE

Secondary Brand Color The color of interactive areas in the app. #2A7AB0

Contrast Primary Color The color of primary text. #000000

Contrast Secondary Color The color of secondary text. #444444

Contrast Tertiary Color The color of the icons on the settings screen and of primary lines #9FAAB5
that delineate different areas of the UI.

313
Field Service Lightning Customize the Field Service Lightning Mobile App

Token Name Description Default Value

Contrast Quaternary Color The color of some graphics and of secondary lines that delineate #E6E6EB
different areas of the UI.

Contrast Quinary Color The color of the background behind cards in the UI. #EEEEEE

Contrast Inverted Color The color of card backgrounds in the UI. #FFFFFF

Add a Profile Tab Background Image in the Field Service Lightning Mobile App
Add a Profile Tab Background Image in the Field Service Lightning Mobile App.
EDITIONS
1. Upload your image as a static resource.
Available in: Salesforce
a. From Setup, enter Static Resources into the Quick Find box and click Static
Classic and Lightning
Resources.
Experience
b. Click New.
The Field Service Lightning
c. Give the static resource a name, like background_banner. Remember the name, since core features, managed
you need to use it in a later step. package, and mobile app
d. Select an image file for upload. An image sized at 3072 x 819 pixels leads to the best results are available in Enterprise,
on large displays such as iPads in landscape mode. However, if your users often encounter Performance, Unlimited,
slow mobile networks, consider using a smaller image. and Developer Editions.
Work orders are also
e. Click Save. available in Professional
Edition.
2. Create a custom attribute to use the static resource on every user’s Profile tab.
a. From Setup, enter Connected Apps into the Quick Find box, then select Field Service Lightning
Connected Apps. mobile users need the Field
Service Mobile user license
b. b. Select Salesforce Field Service for iOS or Salesforce Field Service for Android. to access the app.
c. Scroll down to the list Custom Attributes and click New.
d. For the attribute key, enter COMPANY_PROFILE_IMAGE_RESOURCE_NAME. USER PERMISSIONS
e. For the attribute value, enter the name of the static resource you created surrounded by To set the company profile
quotation marks. image:
• Customize Application
Tip: If you named your static resource background_banner, your attribute value
is“background_banner”.

f. Click Save.

314
Field Service Lightning Customize the Field Service Lightning Mobile App

315
Field Service Lightning Customize the Field Service Lightning Mobile App

Track Service Resource Geolocation with the Field Service Lightning Mobile App
Use geolocation to get a bird’s-eye view of your mobile workforce. You can exclude certain users
EDITIONS
from geolocation tracking.
When service resource tracking is enabled, the Field Service Lightning mobile app uploads the Available in: Salesforce
geolocation of app users to Salesforce at regular intervals. Enable service resource tracking in Setup. Classic and Lightning
Experience
1. From Setup, enter Field Service Settings in the Quick Find box, and select
Field Service Mobile Settings. The Field Service Lightning
2. Click Edit next to the settings configuration you want to update. core features, managed
package, and mobile app
3. Under Additional Settings, check Collect Service Resource Geolocation History. are available in Enterprise,
4. Enter values for the following geolocation-related fields. Performance, Unlimited,
and Developer Editions.
Tip: Higher precision or higher frequency settings increase battery consumption on Work orders are also
mobile devices. To conserve battery power with Android O and later, your position is available in Professional
updated less while the app is in the background. To get an accurate position update, Edition.
open the Field Service Lightning mobile app on your phone.
Field Service Lightning
Important: Due to a limitation with iOS devices when in background mode, you can mobile users need the Field
expect a location update as soon as the device moves 500 meters or more from its previous Service Mobile user license
location, but you should not expect a location update more frequently than once every to access the app.
five minutes. When the app is in the foreground, it correctly obeys the values specified
in the Geolocation Update Frequency in Minutes and Geolocation Accuracy fields. USER PERMISSIONS
• Geolocation Update Frequency in Minutes: Controls how often geolocation is polled
To configure resource
when the app is running in the foreground. For iOS devices, this value also controls update
tracking:
frequency when the app is in the background.
• Customize Application
• Geolocation Update Frequency in Minutes (Background Mode): For Android devices,
To assign permission sets:
this value controls how often geolocation is polled when the app is running in the
• Assign Permission Sets
background. See the note above about iOS devices when in background mode.
• Geolocation Accuracy: This value controls the accuracy of the geolocation data collected
when the app is running in the foreground. Choose from the following values:
– Fine: 10 meters
– Medium: 100 meters
– Coarse: 1 kilometer

• Geolocation Accuracy (Background Mode): For Android devices, this value controls the accuracy of the geolocation data
collected when the app is running in the background. See the note above about iOS devices when in background mode. Choose
from the following values:
– Medium: 100 meters
– Coarse: 1 kilometer
– Very Coarse: The app doesn’t poll for geolocation data, and geolocation coordinates update only when another app polls
for geolocation. The accuracy of the geolocation data depends on the accuracy setting of the application that triggers the
geolocation poll.

5. Click Save.
Geolocation tracking is now enabled!

316
Field Service Lightning Customize the Field Service Lightning Mobile App

What if you want to exclude specific service resources from tracking? For example, if not all members of your workforce are legally
protected against geolocation tracking.
Individual mobile users can turn off location tracking for the Field Service Lightning mobile app from their phone’s operating system
settings. To exclude them from tracking at the admin level:
1. From Setup, enter Permission Sets into the Quick Find box and select Permission Sets.
2. Create a separate permission set for users that you wish to exclude from geolocation tracking. Clone your Field Service Standard
permission set and give it a new name.
3. From the settings of your new permission set, click System Permissions.
4. Click Edit and select Exclude Technician from Geolocation Tracking.
5. Click Save.
6. Click Manage Assignments, and then click Add Assignment.
7. Select the users that you wish to exclude from geolocation tracking, and then click Assign.

Set Up Custom Actions in the Field Service Lightning Mobile App

Configure quick actions, global actions, flows, and app extensions to help your team work more
EDITIONS
efficiently from the field. Actions are displayed in a predefined order in the action launcher on record
pages in the app. Available in: Salesforce
Classic and Lightning
IN THIS SECTION: Experience

Which Actions Appear in the Field Service Lightning Mobile App The Field Service Lightning
Learn which actions are visible in the Android and iOS app action launcher. core features, managed
package, and mobile app
Create Quick Actions for the Field Service Lightning Mobile App
are available in Enterprise,
Add quick actions to object page layouts so your mobile workforce can quickly create and edit Performance, Unlimited,
records, send messages to contacts, and more. and Developer Editions.
Let Users Create Work Order Line Items from the Field Service Lightning Mobile App Work orders are also
Help your team stay organized in the field by letting them create work order line items to split available in Professional
Edition.
work orders or work order line items into sub-tasks. This feature is available in the Field Service
Lightning mobile app for iOS, but not for Android. Field Service Lightning
Create App Extensions for the Field Service Lightning Mobile App mobile users need the Field
Service Mobile user license
Create app extensions to let users pass data from the Field Service Lightning app to another
to access the app.
app.
Add Flows to the Field Service Lightning Mobile App
USER PERMISSIONS
Guide your team through mobile flows in which they can view information, create and update
records, and trigger input-based actions. To create quick actions and
add them to page layouts:
• Customize Application

317
Field Service Lightning Customize the Field Service Lightning Mobile App

Which Actions Appear in the Field Service Lightning Mobile App

Learn which actions are visible in the Android and iOS app action launcher.
EDITIONS

Actions Available in the App Available in: Salesforce

Classic and Lightning
When a user clicks the action button from an object's screen, they see a list of actions found on the
Experience
page layouts for that objects. The action launcher displays actions in the following order:
The Field Service Lightning
1. App extensions and flows scoped to work orders (sorted alphanumerically).
core features, managed
2. Create Service Report: Only visible on the Work Order screen if an alternate service closure package, and mobile app
flow isn’t configured and the service appointment page layout includes the Service Reports are available in Enterprise,
related list. Performance, Unlimited,
and Developer Editions.
3. Edit Work Order or Work Order Line Item, for records of those types.
Work orders are also
4. Quick actions from Quick Actions in the Salesforce Classic Publisher, available in Professional
following the order in the page's layout. Edition.
5. Hard-coded actions such as Edit and View Detail. Field Service Lightning
6. Open in Salesforce, only visible if the Salesforce mobile app is installed on the mobile device. mobile users need the Field
Service Mobile user license
to access the app.
Considerations for Android Devices
• In Android, actions are categorized as Work Order Actions or Service Appointment Actions. In
iOS, these actions are consolidated into one list.
• The Create Service Report action isn't visible in Android. To create a service report in Android, navigate to the "Work Order Overview"
screen.

• The Knowledge Article action isn't visible on the Work Order Overview screen in Android. View knowledge articles using the related
list.

318
Field Service Lightning Customize the Field Service Lightning Mobile App

Create Quick Actions for the Field Service Lightning Mobile App
Add quick actions to object page layouts so your mobile workforce can quickly create and edit
EDITIONS
records, send messages to contacts, and more.
Users viewing records can call a quick action by tapping the action from the action launcher. Quick Available in: Salesforce
actions are assigned to record page layouts. For example, you can add a Create Opportunity action Classic and Lightning
to the contact page layout to let users create an opportunity from any contact record in the app. Experience

Create a work order quick action and add it to the work order overview screen. The Field Service Lightning
core features, managed
Tip: You can follow these steps for any field service object available in the app. package, and mobile app
are available in Enterprise,
1. From the Object Manager in Setup, click Work Orders, then click Buttons, Links, and Actions.
Performance, Unlimited,
2. Click New Action. and Developer Editions.
3. Configure an action to either create or edit a record, and save your changes. Work orders are also
available in Professional
4. From the Object Manager, click Page Layouts under Work Orders. Edition.
5. Click the work order page layout.
Field Service Lightning
6. From the layout editor, select Quick Actions. mobile users need the Field
7. Drag your newly created action into the Quick Actions in the Salesforce Classic Publisher Service Mobile user license
section. to access the app.

8. Save your changes.

USER PERMISSIONS
The action will be visible in the app and on the full Salesforce site.
To create quick actions and
Note: The app supports quick actions of the types Create a Record and Update a Record. add them to page layouts:
Lightning Component, Visualforce, and custom override actions aren’t supported. • Customize Application

319
Field Service Lightning Customize the Field Service Lightning Mobile App

Let Users Create Work Order Line Items from the Field Service Lightning Mobile App
Help your team stay organized in the field by letting them create work order line items to split work
EDITIONS
orders or work order line items into sub-tasks. This feature is available in the Field Service Lightning
mobile app for iOS, but not for Android. Available in: Salesforce
1. Create a quick action to create a work order line item. Classic and Lightning
Experience
a. From the Object Manager in Setup, select Work Order, and then click Buttons, Links, and
Actions. The Field Service Lightning
b. Click New Action. core features, managed
package, and mobile app
c. Select the action type Create a Record. are available in Enterprise,
d. Select the target object Work Order Line Item. Performance, Unlimited,
and Developer Editions.
e. Select the standard label type New Child [Record]. Work orders are also
f. Enter a label, such as New Line Item. available in Professional
This automatically generates the API name. Edition.

Field Service Lightning

g. Add a description, such as Create a work order line item.
mobile users need the Field
h. Select whether or not to create a Chatter feed post when the action is used. Service Mobile user license
i. Optionally, enter a success message that will show when the user creates a line item. to access the app.

j. Save your changes.

USER PERMISSIONS
2. Add your quick action to the work order page layout.
To create quick actions and
a. From the Object Manager in Setup, select Work Order, then click Page Layouts.
add them to work order line
b. Click Work Order Page Layout. item page layouts:
• Customize Application
c. In the layout editor, select Quick Actions.
d. Drag your newly created action into Quick Actions in the Salesforce Classic Publisher.
e. Save your changes.

When this action is added to the layout, iOS users see a + icon in the Work Order Line Item card on work orders and work order line
items. Users can tap the icon to create a new work order line item.

320
Field Service Lightning Customize the Field Service Lightning Mobile App

Create App Extensions for the Field Service Lightning Mobile App
Create app extensions to let users pass data from the Field Service Lightning app to another app.
EDITIONS
App Extension Type Supported in Android Supported in iOS Available in: Salesforce
Android Yes No Classic and Lightning
Experience
iOS No Yes
The Field Service Lightning
Lightning Apps Yes Yes core features, managed
package, and mobile app
Web apps Yes Yes are available in Enterprise,
Flow Yes Yes Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
To set up an app extension, follow the steps below.
Edition.
1. From Setup, enter Field Service Mobile Settings in the Quick Find box, then
select Field Service Mobile Settings. Field Service Lightning
mobile users need the Field
2. Click Edit next to the mobile settings configuration that you want to create an app extension Service Mobile user license
for. to access the app.
3. Under App Extensions, click Add.
4. Fill out the fields. USER PERMISSIONS
• Field Service Mobile Settings: Automatically populated. Represents the current Mobile To create and modify App
Field Service Settings configuration. Extensions:
• Type: A picklist of app extension types. The iOS and Android types will only show on their • Customize Application
respective devices. Flow refers to a Flow (Setup > Process Automation > Flows) of the
type Field Service Mobile Flow. Lightning App refers to an app that is exposed in Salesforce
for Android or Salesforce for iOS (Setup > Mobile Apps > Salesforce > Salesforce Navigation).
• Label: The label as it appears to users in the app. The label isn’t localized automatically.
• Name: The extension’s name.
• Scoped To Object Types: The records from which a user can activate an app extension. Scoping an app extension to an object
lets users activate that app extension from records of the specified type. The object names are entered as comma separated
values and cannot include spaces. For example, to scope an extension to the Work Order object and the Service Appointment
object, enter WorkOrder,ServiceAppointment. To create a global app extension so users can activate it from any
record, leave this field blank.
• Launch Value: A launch value of "https://google.com" will launch a web browser on both iOS and Android. The value to use
to launch the app or Flow. If type is Flow, then the launch value is the API name of the flow you want to use. If type is Lightning
App, the launch value is the name of the tab in Salesforce for iOS and Salesforce for Android. The tab name represents a Lightning
Component Tab and you can find the tab name in Setup > Salesforce Navigation. The launch values for types iOS, Android,
and Lightning App support passing parameters.

Important: For Lightning App types: Salesforce for Android version 17.0 supports passing Lightning App parameters. Salesforce
for iOS version 18.0 does not currently support passing parameters. To bypass this issue, use a type of iOS with a URL format
of “https://{orgURL}/lightning/n/{tab name}?params=...”

5. Click Save.

321
Field Service Lightning Customize the Field Service Lightning Mobile App

Warning: the Salesforce mobile app can launch and accept parameters for Visualforce pages exposed as a Lightning Page
Tab. However, the Lightning Page Tab name can’t have any spaces in it.

Passing Tokens Into the Launch Value

[other]: Flow app extensions do not accept tokens. They receive the Flow input parameters described in Considerations for
Using Flows in the Field Service Lightning Mobile App on page 326.
The launch value supports static URLs for web addresses, as well as dynamic values that can be used to pass contextual information
to the other app in the form of tokens. These tokens can pass field information from any record that is visible on the Field Service
Lightning app. For example, if the user is viewing a service appointment, the tokens can be used to pass the data from any field on
that service appointment to the app extension. The basic format for these tokens is based on the names of the field, like so: {!Name}.

Tip: The following example uses a token to dynamically pass a custom text field that is on a work order into a Google search.
The token is written in bold for clarity: https://www.google.com/#q={!WO_Custom_Text_Field__c}
The field name is case sensitive and must match the field name exactly as it is defined on the object.

Values that aren't related to a record are called global variables. When you use a global variable in a token, use the format
{!$User.email}.

Supported Global Variables

Organization.id

User.displayName

User.email

User.firstName

User.id

User.language*

User.lastName

User.locale*

User.nickName

User.orgId

User.userName

Note: *Android uses the device's language and locale settings.

322
Field Service Lightning Customize the Field Service Lightning Mobile App

Add Flows to the Field Service Lightning Mobile App

Guide your team through mobile flows in which they can view information, create and update
EDITIONS
records, and trigger input-based actions.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Connect a Flow to the Field Service Lightning Mobile App
You can set up an app extension that connects a flow to the Field Service Lightning Mobile The Field Service Lightning
App. core features, managed
package, and mobile app
Create a Flow to Capture Images in the Field Service Lightning Mobile App
are available in Enterprise,
Create a flow that lets your team capture images from the Field Service Lightning mobile app. Performance, Unlimited,
For example, make it easy for technicians to save photos of a customer’s asset before and after and Developer Editions.
service. Work orders are also
Capture Customer Signatures on Service Reports with a Flow available in Professional
Edition.
Using an app extension, you can add a final step to capture a customer’s signature at the end
of a flow. Field Service Lightning
Considerations for Using Flows in the Field Service Lightning Mobile App mobile users need the Field
Service Mobile user license
Review flow considerations before using flows in the Field Service Lightning mobile app.
to access the app.

USER PERMISSIONS

To open, edit, or create a

flow in Flow Builder:
• Manage Flow
To run flows from the app:
• Run Flows

323
Field Service Lightning Customize the Field Service Lightning Mobile App

Connect a Flow to the Field Service Lightning Mobile App

You can set up an app extension that connects a flow to the Field Service Lightning Mobile App.
EDITIONS
Before you create an app extension, make sure that you have already created a flow.
Available in: Salesforce
1. From Setup, enter Field Service Mobile Settings in the Quick Find box, and
Classic and Lightning
select Field Service Mobile Settings.
Experience
Important: Only the user profiles assigned to the mobile settings configuration you
The Field Service Lightning
select have access to the flow. To manage user profile assignments, click Manage
core features, managed
Assignments on the Field Service Mobile Settings page. package, and mobile app
are available in Enterprise,
2. Click Edit next to the mobile settings configuration that you want to add the flow to.
Performance, Unlimited,
3. Under App Extensions, click Add. and Developer Editions.
4. Enter a label for your app extension. This label is what your users see in the user interface. Work orders are also
available in Professional
5. For Type, select Flow. Edition.
6. Enter a name that expresses the purpose of the flow.
Field Service Lightning
7. For Scoped to Object Types, which controls where users can find and activate the flow, enter mobile users need the Field
the API name of the object. Service Mobile user license
If you want to scope the flow to multiple objects, separate the object names with a comma to access the app.
and no space. For example, if you enter WorkOrder,Contact, users can activate the flow
from the detail page of a work order or contact. USER PERMISSIONS
To create an unscoped flow action so that users can activate the flow from multiple screens,
To view, edit, or create a
leave this field blank.
flow in Flow Builder:
8. • Manage Flow
Important: Flows must be of the type Field Service Mobile.
To run flows from the app:
For Launch Value, enter the unique name of your flow. • Run Flows
9. Click Save.

324
Field Service Lightning Customize the Field Service Lightning Mobile App

Create a Flow to Capture Images in the Field Service Lightning Mobile App
Create a flow that lets your team capture images from the Field Service Lightning mobile app. For
EDITIONS
example, make it easy for technicians to save photos of a customer’s asset before and after service.
1. Build a flow with a Screen element that contains a File Upload component. Available in: Salesforce
Classic and Lightning
An API name is generated when you label your flow. You need the API name to connect the
Experience
flow to the Field Service Lightning mobile app.
The Field Service Lightning
2. Save your flow as the Field Service Mobile Flow type. core features, managed
You can now connect the flow to the Field Service Lightning app with an app extension or Quick package, and mobile app
Action, just like any other flow. are available in Enterprise,
Performance, Unlimited,
and Developer Editions.
Work orders are also
available in Professional
Edition.

Field Service Lightning

mobile users need the Field
Service Mobile user license
to access the app.

USER PERMISSIONS

To view, edit, or create a

flow in Flow Builder:
• Manage Flows

Capture Customer Signatures on Service Reports with a Flow

Using an app extension, you can add a final step to capture a customer’s signature at the end of a
EDITIONS
flow.
Available in: Salesforce
User Permissions Needed Classic and Lightning
To view, edit, or create a flow in Flow Builder: Manage Flows Experience

The Field Service Lightning

core features, managed
After you build a flow, create an app extension with the following settings. These settings don't package, and mobile app
change the rest of your flow, but when the mobile app detects the Service_Report_Flow name, it are available in Enterprise,
launches the Service Report preview interface when your flow completes. Performance, Unlimited,
and Developer Editions.
• Label—Enter the text that you want to appear in the Actions tab. For example, My Service
Work orders are also
Report Flow.
available in Professional
• Type—Select Flow. Edition.
• Name—Enter Service_Report_Flow.
Field Service Lightning
• Scoped to Object Types—Enter ServiceAppointment. mobile users need the Field
• Launch Value—Enter the API name of the flow that you want to conclude with signature Service Mobile user license
capture. to access the app.

325
Field Service Lightning Customize the Field Service Lightning Mobile App

Because the API name of the service report flow is unique, you can have only one Service_Report_Flow at a time.

Considerations for Using Flows in the Field Service Lightning Mobile App
Review flow considerations before using flows in the Field Service Lightning mobile app.
EDITIONS

Downloading Flow Data Available in: Salesforce

Classic and Lightning
When the app loads a user’s schedule data, it also downloads global flows and any flows scoped
Experience
to records in their schedule data. Pulling down on the screen to sync with Salesforce causes the
app to reload flow metadata. The Field Service Lightning
core features, managed
package, and mobile app
Flow Input Parameters are available in Enterprise,
When an iOS or Android app launches a flow, it passes the following input parameters: Performance, Unlimited,
and Developer Editions.
• Id—The ID of the record that the flow is launched from.
Work orders are also
• UserId—The ID of the current user. available in Professional
• ParentId—The record ID of the parent record that the flow is launched from. For example, if a Edition.
flow is launched from a service appointment, the ParentId is the ID of the parent work order or Field Service Lightning
work order line item. mobile users need the Field
Service Mobile user license
Creating a Choice Option to access the app.

If the user selects the choice value to use in a screen component, such as a radio button or
multi-select picklist, the screen component is set to this value. If no choice value is configured, the screen component is set to the choice
label.

Flow Limitations in the Field Service Lightning Mobile App

• Select formula functions and operators are available offline. See Available Formula Functions and Operators on page 327.
• Screen flows launched using quick actions or app extensions aren't supported.
• Email alert actions aren't supported in flows.
• Paused flows aren't supported. If you leave a flow in progress and exit the Field Service Lightning mobile app, you can't resume the
flow where you left off.
• The wasSelected operator can’t be used in decisions.
• For eval() functions, the boolean values true and false are case-sensitive.
• Hardcoded ID values must be 18 digits long. 15-digit values aren’t supported.
• Apex classes aren’t supported in flows.
• Fault connectors aren't supported in flows.
• When uploading images in flows, the content document IDs parameter isn’t supported. Admins must create a flow confirmation
screen to show which images were uploaded. Videos and other file types aren’t supported.
• Flows don’t support the following elements. Adding these elements to a flow causes it to immediately display an error.
– Lightning components (except for file upload)
– Output parameters on file upload except for “Uploaded File Names”
– Choice resources with Display Text Input enabled
– Actions with output parameters

326
Field Service Lightning Customize the Field Service Lightning Mobile App

Note: Some flows that have actions with output parameters may not cause an error immediately, but they are still not
supported.

• Flow picklists that include a default value are not supported. If you choose a default value, it is not shown as the default value in the
picklist.
• Flow record variables require record fields to be accessed through their field API names. Use of field relationship names is not
supported.
• Record field lookups are limited to one level of indentation. If more levels are required, use assignment elements.
• Flow text areas have a 2000 character limit.
• Using semicolons when defining user choices in flow checkbox groups and multi-select picklists is not supported. If you use semicolons
for user choices, the data does not render accurately.
• Record Choice Sets do not retain the value that is selected. A Record Choice Set variable cannot be used to determine what selection
was made; however, the component used to make the selection (such as a picklist) saves that value for later use.

Available Formula Functions and Operators

Important: Formula functions are case-sensitive. Make sure to use the formatting listed.

Math Operators Logical Operators

• + (Add) • == (Equal), only == , not =
• - (Subtract) • != (Not Equal), only != , not <>
• * (Multiply) • < (Less Than)
• / (Divide) • > (Greater Than)
• () (Open and Close Parenthesis) • <= (Less or Equal)
• >= (Greater or Equal)
• && (And), only && , not AND
• || (Or), only || not OR

Date and Time Functions Logical Functions

• DAY • ISBLANK
• MONTH • ISNUMBER
• NOW Math Functions
• WEEKDAY • ABS
• YEAR • CEILING
Text Functions • FLOOR
• BEGINS • LN
• CONTAINS • LOG
• FIND • SQRT
• LEFT Advanced Functions
• LEN • REGEX
• LOWER

327
Field Service Lightning Using the Field Service Lightning Mobile App

• RIGHT
• SUBSTITUTE
• TRIM
• UPPER
• VALUE

Using the Field Service Lightning Mobile App

Learn how to install and log into the app, adjust in-app settings, and complete common tasks from
EDITIONS
the app.
Available in: Salesforce
IN THIS SECTION: Classic and Lightning
Experience
Get the Field Service Lightning Mobile App
The Field Service Lightning mobile app is available to users with the Field Service Mobile license The Field Service Lightning
and a supported Android or iOS device. Learn how to install the app and log in. core features, managed
package, and mobile app
Customize Push Notifications for the Field Service Lightning Mobile App
are available in Enterprise,
Push notifications alert your mobile workforce to approaching appointments and scheduling Performance, Unlimited,
changes. and Developer Editions.
Offline Priming in the Field Service Lightning Mobile App Work orders are also
Learn what data the Field Service Lightning mobile app downloads for offline work and how available in Professional
Edition.
the app syncs with Salesforce.
In-App Profile Settings in the Field Service Lightning Mobile App Field Service Lightning
mobile users need the Field
Click the gear icon in the top right-hand corner of the Profile tab to view pending uploads,
Service Mobile user license
manage linked accounts, and provide feedback to Salesforce about the app.
to access the app.
Chatter in the Field Service Lightning Mobile App
Collaborate on field service jobs using Chatter. Feed tracking must be enabled to display the
Feed tab.
Create Service Reports in the Field Service Lightning Mobile App
Service reports summarize the work that was performed by a customer, and can be signed by the technician, customer, and others
involved in the work. Learn how to configure the Field Service Lightning mobile app to support service report generation and review
important considerations about offline service reports and service report previews.
View Knowledge Articles in the Field Service Lightning Mobile App
Knowledge articles can be attached to work orders, work order line items, and work types to share product specs, instructions, and
guidelines with your team.
Create Resource Absences in the Field Service Lightning Mobile App
Resource absences indicate when a service resource is unavailable to work. During schedule optimization, service resources aren’t
assigned to appointments that conflict with their absences. View and manage absences from the Profile tab in the app.

328
Field Service Lightning Using the Field Service Lightning Mobile App

Get the Field Service Lightning Mobile App

The Field Service Lightning mobile app is available to users with the Field Service Mobile license
EDITIONS
and a supported Android or iOS device. Learn how to install the app and log in.
To get the app, search for Field Service Lightning in the Google Play Store or the iOS Available in: Salesforce
App Store on your mobile device. Classic and Lightning
Experience
When the app is downloaded, tap it to launch it. Upon launching it for the first time, you’ll receive
several device permission requests. Approve any requests to let the app: The Field Service Lightning
core features, managed
• Send you notifications
package, and mobile app
• Access your basic information are available in Enterprise,
• Access your location, which is used in the app’s mapping functionality and geolocation tracking Performance, Unlimited,
for scheduling and Developer Editions.
• Access your camera Work orders are also
available in Professional
You can change the device permissions that your device gives the Field Service Lightning app at Edition.
any time. To do so, navigate to your device’s settings, then tap the Field Service Lightning app.
Field Service Lightning
Tip: When using the iOS app with iOS 13 or later, the location permission request allows the mobile users need the Field
app to track the location only while the app is being used. To track the location while the app Service Mobile user license
is in the background, set this value to “Always” from the device’s Settings app (Settings > to access the app.
Field Service Lightning > Location).

Logging In
When given the option, log in to Salesforce from the app. If prompted, create a passcode for an added level of security. Depending on
how your Salesforce org is configured, you may need to enter information for a custom domain:
• Click the gear icon in the top right of the login screen to specify production or sandbox org, or press + to enter a custom domain.
If you’re a community user, the first login is slightly different. On the initial login screen, click the settings button in the top right, then
add a connection with the URL of your Salesforce community. The URL can be found in Setup under Communities. When entering the
community URL, omit https://.

Note: If you see a prompt that says “FieldServiceApp Wants to Use salesforce.com to Sign In,” accept it to log in to the app.

329
Field Service Lightning Using the Field Service Lightning Mobile App

Customize Push Notifications for the Field Service Lightning Mobile App
Push notifications alert your mobile workforce to approaching appointments and scheduling
EDITIONS
changes.
1. Ensure that the connected app (different from the app itself) has been downloaded. Available in: Salesforce
Classic and Lightning
2. Enable notifications in Setup.
Experience
a. From Setup, enter Field Service Settings in the Quick Find box, then select
Field Service Settings. The Field Service Lightning
core features, managed
b. Under Notifications, select Enable notifications, and save your changes. package, and mobile app
are available in Enterprise,
3. Choose when service appointment notifications are sent.
Performance, Unlimited,
a. From Setup, enter Field Service Mobile Settings in the Quick Find box, and Developer Editions.
then select Field Service Mobile Settings. Work orders are also
available in Professional
b. Next to your mobile settings configuration, click Edit.
Edition.
c. Under Customization, select how to send appointment notifications and then save your
changes. Field Service Lightning
mobile users need the Field
• When you select Send appointment notifications on assignment, users are notified Service Mobile user license
when they’re assigned to a service appointment and when their assignment is changed to access the app.
or removed. They’re not notified when they are dispatched for the appointment.
• When you select Send appointment notifications on dispatch, users are notified
USER PERMISSIONS
when they’re dispatched for a service appointment and when their assignment is
changed or removed. To customize push
• When you select both options, users receive assignment and dispatch notifications. notifications:
• Customize Application
• If you select neither option, no service appointment notifications are sent.

Users also receive push notifications in the following circumstances.

• A Chatter text post is made on a work order that the user follows.
• A Chatter file post is made on a work order that the user follows.
• A feed-tracked change is made to a work order that the user follows.
• (iOS only) A feed-tracked change is made to a service appointment that the user follows.

Note: Technicians are not automatically added as followers to work orders and service appointment records that they are assigned
to. Consider creating an Apex trigger on the service resource object to add or remove users as followers when assignments change.

330
Field Service Lightning Using the Field Service Lightning Mobile App

Offline Priming in the Field Service Lightning Mobile App

Learn what data the Field Service Lightning mobile app downloads for offline work and how the
EDITIONS
app syncs with Salesforce.
Available in: Salesforce
Syncing Data Classic and Lightning
Experience
When the Field Service Lightning mobile app is connected to the internet, it regularly synchronizes
data with the Salesforce server. If the app goes offline, users see a notification in the top navigation The Field Service Lightning
bar. core features, managed
package, and mobile app
Any changes made while the app is offline are added to the pending uploads queue in order of are available in Enterprise,
occurrence. The queue shows the status of the app’s attempts to upload changes to the Salesforce Performance, Unlimited,
server. To view the queue, tap the top navigation bar when uploads are pending, or go to the in-app and Developer Editions.
settings in the Profile tab. To delete a pending upload, swipe it left and confirm the deletion. Work orders are also
If an error occurs when the app is trying to upload a change to Salesforce, the Pending Uploads available in Professional
queue is paused at that upload. Subsequent changes in the queue may depend on a prior change, Edition.
so the conflict must be resolved before the queue is processed. There is no conflict resolution for Field Service Lightning
conflicting changes in the pending uploads queue, so the most recent change uploaded to the mobile users need the Field
Salesforce server takes precedence. The most common way to resolve a conflict is by deleting a Service Mobile user license
pending upload. You can also tap some items to edit the data. to access the app.
If the priming system encounters a network error during the priming process, an error message
appears and priming stops. When you regain connectivity, use the offline priming UI to resync your
data.

What Is Data Priming?

When a user logs in to the Field Service Lightning app, it automatically pre-downloads data related to the user’s assigned service
appointments. This process is known as priming, and it ensures that all the data a technician needs is available even if internet connectivity
is lost. In order to view files offline, they must be opened at least once in the app. Priming can take awhile from the initial launch of the
app, or when a new user logs on to the app if there is a high volume of data.

What Gets Primed?

The data that the app primes for each user is based on the user’s assigned service appointments. References are generally primed to a
depth of 3. Refer to this table for details and exceptions.

Category What Gets Primed

Key Objects (Service Appointments, Work Orders, Work Order Line All service appointments for the user within the time range
Items, Assets) specified in the Salesforce org are primed. This time range defaults
to 45 days before and after the current day. Configure this value
from Field Service Mobile Settings (under Future Days in the
Date Picker and Past Days in the Date Picker).
All work orders, work order line items, or assets referenced by the
above service appointments are also primed.

Other Objects All objects referenced by the above key objects are primed to a
depth of 3. This depth means that the app primes any objects

331
Field Service Lightning Using the Field Service Lightning Mobile App

Category What Gets Primed

referenced by key objects (level 2), and primes any objects that
these objects reference (level 3).
For example, if a Service Appointment (SA-0001), references a
custom object JellyBean (JB-0002), and JB-0002 references another
object Account (AC-0003), all three are primed. However, no objects
referenced from AC-0003 are primed.

Special Objects If an object being primed has a reference field that refers to any of
the following object types, that referenced object is also primed
(even if already at a depth of 3). Special object types include:
Product, Product Consumed, Product Required, Product Request,
Product Request Line Item, Product Transfer, Account, Case,
Contract, Assigned Resource.

Related Lists For related lists referenced by key objects, we prime the list of files
and the object types that it contains. We also prime up to 25
records in the related list. If a related listcontains more than 25
records, the 25 most recently modified records are primed.
This limit doesn’t apply to the Articles related list, which has no
limit.
A related list of type Service Reports or Content Document is
always primed. Note that only metadata about the files from the
files related list are primed. The actual file data, for example the file
name and version, are not primed

Inventory The user’s inventory is primed. For multi-location inventory, we

only prime up to 10 locations. For each location, we prime up to
2000 records.

Service Reports Service reports and previews associated with all the above work
orders and work order line items are primed.

Knowledge Articles Knowledge articles are primed using the Embedded Service
Knowledge SDK.

Object Feeds If feeds are enabled in the org, feeds are primed for supported
object types using the Feed SDK offline priming feature. Supported
objects include: Work Order, Work Order Line Item, Case, Service
Appointment, Product Request, Product Request Line Item, and
Asset.

Quick Actions For every object that is primed, we also prime the page and search
layouts, which contains the list of quick actions for that object type.
Create and Update quick actions are primed from the Quick Actions
in the Salesforce Classic Publisher section on the page layout.

332
Field Service Lightning Using the Field Service Lightning Mobile App

Category What Gets Primed

Default Developer List View If a list view is specified under Field Service Mobile Settings >
Default Developer List View Name, the work orders and service
appointments from the list view are primed.

Flows All active flows referenced in Field Service Mobile Settings App
Extensions are primed. Subflows are primed to a depth of 5. All
metadata and quick actions for referenced objects in a flow are
also primed. If a flow has an issue during priming (for example, an
unsupported flow element), then that flow is not primed.

Price Books Price books aren’t primed for offline usage due to performance
considerations.

In-App Profile Settings in the Field Service Lightning Mobile App

Click the gear icon in the top right-hand corner of the Profile tab to view pending uploads, manage
EDITIONS
linked accounts, and provide feedback to Salesforce about the app.
Available in: Salesforce
View pending uploads Classic and Lightning
Experience
The upload queue shows pending uploads that the app sends to your org when internet access is
restored. Each upload represents individual changes to records that the user has made in the order The Field Service Lightning
that they made them. If an upload in the queue encounters an error, the queue will pause until the core features, managed
error is resolved. To delete a pending upload, swipe it left and confirm the deletion. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
Manage linked accounts and Developer Editions.
Work orders are also
In the account management section, you can log out from your current user profile or log in with
available in Professional
a different account.
Edition.

Field Service Lightning

Give feedback mobile users need the Field
Tap the feedback button to share your feedback about the app with Salesforce. Your Salesforce Service Mobile user license
admin doesn’t receive the feedback you submit. to access the app.

333
Field Service Lightning Using the Field Service Lightning Mobile App

Chatter in the Field Service Lightning Mobile App

Collaborate on field service jobs using Chatter. Feed tracking must be enabled to display the Feed
EDITIONS
tab.
To show the Feed tab on the work order overview carousel, enable feed tracking on work orders. Available in: Salesforce
Classic and Lightning
1. From Setup, enter Chatter into the Quick Find box and select Feed Tracking.
Experience
2. Select Work Order from the object list.
The Field Service Lightning
3. Check Enable Feed Tracking. core features, managed
4. Click Save. package, and mobile app
are available in Enterprise,
Limitations
Performance, Unlimited,
• The Feed tab in iOS is supported only on the work order, work order line item, service and Developer Editions.
appointment, and case objects. The Feed tab in Android is supported only on the work order, Work orders are also
work order line item, and service appointment objects. available in Professional
• (Android only) Chatter is disabled when the app doesn’t have internet connectivity. Edition.

Field Service Lightning

mobile users need the Field
Service Mobile user license
to access the app.

USER PERMISSIONS

To customize fields tracked

in feeds:
• Customize Application
To view the field tracking
setup page:
• View Setup and
Configuration

334
Field Service Lightning Using the Field Service Lightning Mobile App

Create Service Reports in the Field Service Lightning Mobile App

Service reports summarize the work that was performed by a customer, and can be signed by the
EDITIONS
technician, customer, and others involved in the work. Learn how to configure the Field Service
Lightning mobile app to support service report generation and review important considerations Available in: Salesforce
about offline service reports and service report previews. Classic and Lightning
To allow app users to preview and create service reports, make the following configurations. Experience

1. Complete the steps in Create Service Report Templates to prepare for and create service report The Field Service Lightning
templates core features, managed
package, and mobile app
2. Ensure that the service appointment page layout includes the Service Reports related list.
are available in Enterprise,
3. Add the Work Type field to work order and work order line item page layouts, and make Performance, Unlimited,
sure users have permission to view it. and Developer Editions.
4. Add the Service Report Template field to the work type page layout. Work orders are also
available in Professional
5. (Recommended) Select a service report template in the Service Report Template field on each Edition.
work type in your org.
Field Service Lightning
Create a Service Report in the App mobile users need the Field
To create a service report in the app, navigate to a service appointment, work order, or work Service Mobile user license
order line item. Tap the action icon, then tap Create Service Report. If the service report to access the app.
template includes a signature section, you’re prompted to Sign & Confirm. If there isn’t a
signature section, only a Confirm option appears.
USER PERMISSIONS
In Android, the Create Service Report action appears on the Service Reports card. If a work order
already has a service report, users can edit the existing report, but can’t create additional reports. To create or edit a Service
Report Template:
Service reports are translated in the language selected in the Service Report Language field on • Customize Application
the associated work order. If that field is blank, they use the default language of the person
generating the report.
Create a Service Report Offline
Mobile workers can create service report previews while offline. For the iOS app, you can disable offline service report generation.
1. From Setup, enter Connected Apps in the Quick Find box, then select Connected Apps.
2. Click Salesforce Field Service for iOS.
3. In the Custom Attributes list, click New.
4. Set the Attribute key to DISABLE_SERVICE_REPORT_PREVIEW_IOS.
5. Set the Attribute value to "true". Be sure to include the quotation marks.
Limitations
• Users cannot select a template when creating a service report in the mobile app. Instead, a template is selected based on the
following order:
1. The work order template
2. The work type template
3. The standard template

• Service report previews have the following limitations:

– Although users can make an offline request to generate a service report, the final PDF is created only when the user's device
is online.

335
Field Service Lightning Using the Field Service Lightning Mobile App

– The app doesn’t automatically get the latest data before generating a service report preview, so data in service report previews
could be out of date. This applies to both online and offline service report previews.
– If a reference field exceeds the maximum priming depth of 2, it isn't populated.
– Formula field values could be inaccurate in a preview because they aren’t dynamically calculated.
– Roll-up summary fields are blank.
– Related lists behave differently in mobile previews.
• The order of records in related lists could be different between the preview and the printed report.
• If a service report template includes a related list, but the record that the service report is being generated for doesn’t
have the related list on its page layout, the related list isn’t populated.
• On the printed report, all related lists are printed. In the mobile preview, a related list must be on the preview page layout
to appear on the preview.

– The following elements aren’t visible:

• Cases related list
• Headers and footers
• Organization fields
• Certain data fields
• Images in rich text fields on a service report template or service appointment, work order, or work order line item page
layout

View Knowledge Articles in the Field Service Lightning Mobile App

Knowledge articles can be attached to work orders, work order line items, and work types to share
EDITIONS
product specs, instructions, and guidelines with your team.
Available in: Salesforce
Letting App Users View Knowledge Articles Classic and Lightning
Experience
To let Field Service Lightning mobile app users view knowledge articles:
The Field Service Lightning
1. Ensure you have Salesforce Knowledge set up in your org.
core features, managed
2. Add the Articles related list to work order and work order line item page layouts. package, and mobile app
are available in Enterprise,
Performance, Unlimited,
Viewing Articles in the App and Developer Editions.
To view the Articles related list on a work order, tap Related in the work order carousel. Tap the Work orders are also
name of an article to view it. The Knowledge card in the work order overview screen also shows available in Professional
articles attached to the work order or work order line item. Edition.

Field Service Lightning

Limitations mobile users need the Field
Service Mobile user license
• (iOS only) Images in knowledge articles display normally if they are hosted outside of Salesforce. to access the app.
Images uploaded to Salesforce don't load correctly. As an alternative, we recommend using an
image link that users can open themselves. You can avoid this issue by selecting the option to
use POST requests for cross-domain sessions. Find this option on the Session Settings page in Setup.
• (Android only) If a device is running in any of Salesforce’s 26 supported languages, the app automatically translates knowledge
articles to that language. Otherwise, the app defaults to English.

336
Field Service Lightning Using the Field Service Lightning Mobile App

• (Android only) The Knowledge Article action isn't visible on the Work Order Overview screen. View knowledge articles using the
related list.

Create Resource Absences in the Field Service Lightning Mobile App

Resource absences indicate when a service resource is unavailable to work. During schedule
EDITIONS
optimization, service resources aren’t assigned to appointments that conflict with their absences.
View and manage absences from the Profile tab in the app. Available in: Salesforce
To allow users to create, update, and delete absence records from the app, make the following Classic and Lightning
configurations. Experience

1. Add the Absences related list to the service resource page layout, and customize its fields as The Field Service Lightning
needed. core features, managed
package, and mobile app
Tip: The date picklist values on resource absences are based on the Picklist Time are available in Enterprise,
Interval in Minutes setting on the Field Service Mobile Settings page in Setup. Performance, Unlimited,
and Developer Editions.
2. Add the "Non Availability" record type to user profiles.
Work orders are also
a. From Setup, enter Users in the Quick Find box, then select Profiles. available in Professional
b. Select the user profile that you want to add the record type to. Edition.

c. Under Apps, select Object Settings. Field Service Lightning

mobile users need the Field
d. Select Resource Absences and click Edit. Service Mobile user license
e. Next to Non Availability, select the circle for Default Record Type. The checkbox for Assigned to access the app.
Record Type is automatically filled in.

Important: For resource absences created from the app to be considered for schedule USER PERMISSIONS
optimization, Non Availability must be selected as the default record type.
To view, create, edit, or
a. Click Save. delete resource absences:
• Read on service
3. Optionally, hide certain resource absence types from the Profile tab in the app. resources
a. From Setup, enter Connected Apps in the Quick Find box, then select Manage
Connected Apps.
b. Select Salesforce Field Service for Android or Salesforce Field Service for iOS.
c. Under Custom Attributes, click New.
d. For Attribute key, enter EXCLUDE_RESOURCE_ABSENCE_TYPES.
e. For Attribute value, enter a comma-separated list of the resource absence types you want to hide from the Profile tab. Then click
Save.
For example, if you want to hide meetings and trainings from the Profile tab, you would enter "Meeting, Training".

Note: Under the profile tab, only 10 resource absence records are displayed.

Managing Absences in the App

View and manage absences from the Absences card on the Profile tab. To create a resource absence, click the + icon.
The Type field indicates the nature of the time off from work, and comes with the following values:
• Vacation (default)
• Meeting

337
Field Service Lightning Using the Field Service Lightning Mobile App

• Training
• Medical

338