The Admin's Guide to

Entitlement Management
Salesforce, Spring 17

@salesforcedocs
Last updated: March 11, 2017
 Copyright 20002017 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

INTRODUCTION TO ENTITLEMENT MANAGEMENT ....................1

What Is Entitlement Management? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Entitlements: Terms to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Entitlement Management Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

PLANNING YOUR IMPLEMENTATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Planning for Entitlement Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Entitlement Management Setup Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

SETTING UP ENTITLEMENT MANAGEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Set Up Entitlements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Set Up Service Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Set Up Contract Line Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Set Up Entitlement Management in Communities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Report on Entitlements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

ENFORCING SERVICE LEVELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Set Up Milestones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Set Up an Entitlement Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

ENTITLEMENT VERSIONING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Updating an Entitlement Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Create a New Version of an Entitlement Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Use a New Version of an Entitlement Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

LEARN MORE ABOUT ENTITLEMENT MANAGEMENT . . . . . . . . . . . . . . . . . . 43

Where to Learn More . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
INTRODUCTION TO ENTITLEMENT MANAGEMENT

What Is Entitlement Management?

Entitlement management helps you provide the correct support to your customers. It includes a
EDITIONS
variety of features that let you define, enforce, and track service levels as part of your support
management process. Available in: Salesforce
Entitlement management features include: Classic
Entitlements, which let support agents determine whether a customer is eligible for support. Available in: Professional,
Entitlement processes, which let you design timelines that include all the steps that your support Enterprise, Performance,
team must complete to resolve support records like cases or work orders. Unlimited, and Developer
Editions with the Service
Service contracts, which let you represent different kinds of customer support agreements like
Cloud
warranties, subscriptions, or maintenance agreements. You can restrict service contracts to
cover specific products.
Community access to entitlements, which lets community users view entitlements and service contracts and create support records
from them.
Reporting on entitlement management, which lets you track the way entitlements are used in your Salesforce org and whether service
contract terms are being met.
Because entitlement management is highly customizable, you have full control of which features you use and how you set them up to
reflect your customer support model. Well walk you through important planning decisions and setup steps to help you make the most
of entitlement management. To get started, we recommend that you check out the Entitlement Management Trailhead module:
Entitlement Management.

Important: Only users in orgs with the Service Cloud can enable, create, and update entitlement management items.

Entitlements: Terms to Know

Learn useful terms related to entitlement features in Salesforce.
EDITIONS
Entitlement
A unit of customer support in Salesforce, such as phone support or web support. Its typically Available in: Salesforce
used to represent terms in warranties. You can associate entitlement with accounts, assets, Classic
contacts, and service contracts. View entitlements from the Entitlements tab or the Entitlements
Available in: Professional,
related list on accounts, assets, contacts, and service contracts.
Enterprise, Performance,
Entitlement Contact Unlimited, and Developer
Contacts who are entitled to customer supportfor example, a named caller. The Contacts Editions with the Service
related list on an entitlement shows which contacts are eligible for that entitlement. You can Cloud
remove or add contacts directly from the related list, or by updating the contact record itself.
Your business may not allow you to provide support to customers unless they are a contact on
the entitlement.

1
Introduction to Entitlement Management Entitlements: Terms to Know

Note:
Contacts on an account dont automatically inherit the accounts entitlements. Depending on your business processes,
you may need to create a separate entitlement for each contact on an account. You can also set up an Apex trigger that
automatically assigns an entitlement to a contact when you create the contact.
Entitlement contacts dont have page layouts, search layouts, buttons, links, or record types.
The same visibility and sharing settings that apply to the parent account apply to contacts. Associating a contact with an
entitlement doesnt share the entitlement record with the contact or the related community user.

Entitlement Template
Predefined terms of customer support that can be quickly added to products in Salesforce. For example, you can create entitlement
templates for phone or web support so users can easily add entitlements to products purchased by customers.
Entitlement Management
A collection of Salesforce features that help you provide the correct service levels to your customers. It includes:
Entitlements, which let support agents determine whether a customer is eligible for support.
Entitlement processes, which are timelines that include all the steps that your support team must complete to resolve support
records like cases or work orders.
Service contracts, which let you represent different kinds of customer support agreements like warranties, subscriptions, or
maintenance agreements. You can restrict service contracts to cover specific products.
Community access to entitlements, which lets community users view entitlements and service contracts and create support records
from them.
Reporting on entitlement management, which lets you track the way entitlements are used in your Salesforce org and whether
service contract terms are being met.
Depending on your business needs, you may decide to use all of these features or just a few of them.
Service Contract
A customer support agreement between you and your customers. Service contracts in Salesforce can represent warranties,
subscriptions, service level agreements (SLAs), and other types of customer support. View service contracts in the Service Contracts
tab or on the Service Contracts related list on accounts and contacts.
Contract Line Item
Specific products covered by a service contract. View contract line items in the Contract Line Items related list on service contracts
(not contracts!). You can only use contract line items if your org uses products.

Note: Schedules arent available for contract line items, and community users cant access them.

Entitlement Process
A timeline that includes all the steps (milestones) that support agents must complete to resolve a support record. Each process
includes the logic needed to determine how to enforce the correct service level for your customers. Entitlement processes come in
two types: Case and Work Order.
Not all entitlements need processes. For example, a simple entitlement might just state that a customer is eligible for phone support
24/7. If you need to add time-dependent steps or service levels to that definitionfor example, if you want a supervisor to be notified
by email when a customers case goes unresolved for two hoursyou need an entitlement process.
Milestone
A required step in your entitlement process. Milestones are metrics that represent service levels to provide to each of your customers.
Examples of milestones include First Response and Resolution Time on cases.
Milestone Action
A time-dependent workflow action that occurs on a milestone in an entitlement process. For example, you might add the following
actions to a milestone:

2
Introduction to Entitlement Management Entitlement Management Limitations

Send an email alert to certain users one hour before a first response milestone is scheduled to expire
Update certain fields on a case one minute after a first response is completed
There are three types of milestone actions:
Success actions are triggered when a milestone is completed
Warning actions are triggered when a milestone is about to be violated
Violation actions are triggered when a milestone is violated
You can automate tasks, email alerts, field updates, and outbound messages for each action type.

Entitlement Management Limitations

The following limitations apply to entitlements and their related features.
EDITIONS
Entitlement Limitations
Available in: Salesforce
Every entitlement must be associated with an account.
Classic
You cant share entitlements. Entitlements inherit their parent accounts sharing settings.
Available in: Professional,
If youre using entitlement processes, manage customers work orders and cases on separate
Enterprise, Performance,
entitlements. This is because an entitlement process only runs on records that match its
Unlimited, and Developer
type. For example, when a Case entitlement process is applied to an entitlement, the process
Editions with the Service
only runs on cases associated with the entitlement. If a work order is also associated with
Cloud
the entitlement, the process wont run on the work order.
Merge fields for entitlements on cases aren't supported. For example, if you add the
Entitlement Name {!Case.Entitlement} merge field to an email template, the field is not populated on the
template.
Entitlement contacts dont have page layouts, search layouts, buttons, links, or record types.
Entitlements dont automatically apply to cases created with Web-to-Case or Email-to-Case. If needed, you can add entitlements
to these features using Apex code. For a sample trigger, see Automatically Add Entitlements to Cases from Web, Email, and
Communities.
Milestone Limitations
You can't add milestones to support records without using entitlement processes. Entitlement processes apply milestones to
support records.
An org can have up to 1,000 entitlement processes, with up to 10 milestones per process. If your org was created before Summer
13, its maximum number of entitlement processes may be lower, but you can ask Salesforce to increase it.
Milestones arent marked completed automatically. If youd like, you can set up automation to auto-complete milestones on
support records that match unique criteria. To learn more, see Auto-Complete Case Milestones.
After an entitlement process is activated, you cant delete its milestones or create milestone actions. However, you can create
versions of entitlement processes with different milestone settings and apply the new version to existing entitlements.
Only one instance of a milestone can count down on a record at a time. For example, if a Response Time milestone begins
counting down on a case, a second Response Time milestone cant be created until the first is completed.
Business hours on entitlement processes arent supported in change sets. To transfer an entitlement process with business hours
from one Salesforce org to another, use one of these approaches:
Create the entitlement process from scratch in the new org
Use an alternative method to transfer the entitlement process, such as the Force.com Migration Tool
Remove the business hours from the entitlement process before adding it to a change set

3
Introduction to Entitlement Management Entitlement Management Limitations

Contract Line Item Limitations

You can only use contract line items if your org uses the Product object.
You cant create list views for contract line items.
You cant share contract line items. Contract line items inherit their parent service contracts sharing settings. For example, users
with the Read permission on service contracts inherit the Read permission on contract line items.

4
PLANNING YOUR IMPLEMENTATION

Planning for Entitlement Management

Entitlement management is highly customizable, which means you have many choices during
EDITIONS
setup. Before you begin the setup process, its essential to choose an entitlement management
model. Available in: Salesforce
Classic

Choose What Determines Support Eligibility Available in: Professional,

Enterprise, Performance,
You can set up entitlement management so customers are eligible for support based on one or Unlimited, and Developer
several of the following types of records: Editions with the Service
Accounts: Any contact on the account is eligible for support. Cloud
Contacts: Specific contacts are eligible for support.
Assets: Specific assets (purchased products) are eligible for support.
Service contracts: Customers are eligible for support based on a specific service contract.
Contract line items: Specific products covered by a service contract are eligible for support.
Your approach depends on how detailed you want your support process to be. If you prefer to keep it simple, just have your support
agents determine support eligibility based on accounts. Heres what this approach looks like:

5
Planning Your Implementation Planning for Entitlement Management

Choose a Setup Model

There are three general ways to set up entitlement management. Once youve decided what should determine support eligibility, review
the three models and select the one that best meets your business needs. You can always change which model youre using.

Entitlement model What determines support eligibility Use this model if

Entitlements only (simplest option) Support agents determine whether a There's no need to manage your
customer is eligible for support at the customers' entitlements as part of a
account, contact, or asset level. service contract
Your entitlements don't have a renewal
process
Entitlements aren't purchased by your
customers; they're bundled with
products (warranties)
Your customers' entitlements are short
term and managed independently of
each other

Entitlements + service contracts Support agents determine whether a Entitlements are purchased and
customer is eligible for support based on managed separately from the products
their service contract. they cover and are part of a service
contract
Your customers' entitlements are
renewed at a contract level
You use Salesforce for customer support
but not necessarily for service contract
management

Entitlements + service contracts + contract Support agents determine whether a You use Salesforce for customer support
line items (most complex option) customer is eligible for support based on and to manage your customers' service
the products covered in their service contracts
contract.
Your support team manages service
contract transactions, such as transfers,
mergers, and renewals
Warranties, subscriptions, or other
support products appear as line items
on your sales orders and map to one or
more entitlements
Entitlements are created and updated
through an integration with your order
management system

Regardless of the setup model you choose, you can enhance your support process with other entitlement management features. For
example, you can:

6
Planning Your Implementation Entitlement Management Setup Checklist

Create entitlement processes to enforce required, time-dependent steps in your support process
Use entitlement versioning to create and maintain multiple versions of entitlement processes
Add entitlements to communities
Report on entitlements
After you select a setup model, head to the invaluable Entitlement Management Setup Checklist.

Entitlement Management Setup Checklist

When you set up entitlement management, you decide which features to use. Use this checklist
EDITIONS
to confirm that youve set up entitlement management in a way that fits your support processes.
Available in: Salesforce
Step Complete if... Classic
Read Planning for Entitlement Management Youre thinking about using entitlements in Available in: Professional,
your org. Enterprise, Performance,
Unlimited, and Developer
Set Up Entitlements You want customer support eligibility to be
Editions with the Service
determined at the account or contact level.
Cloud
Enable Entitlements You want to use entitlements in your org.

Customize Entitlements You want to control which fields users see USER PERMISSIONS
on entitlements, and how and where users
To set up entitlement
associate entitlements with other records. management
Set Up Entitlement and Asset Lookup You want to control which entitlements and Manage Entitlements
Filters on Cases assets users can link to a case.

Give Users Access to Entitlement You want to give users the appropriate user
Management permissions, field access, and tab access.

Set Up an Entitlement Template You want to predefine the terms of support

for specific products.

Automatically Add Entitlements to You want the correct entitlement to be added

Cases from Web, Email, and Communities automatically to cases created using
Web-to-Case, Email-to-Case, or communities.

Set Up Milestones You want to define required steps that

support agents must complete to close a
support record.

Customize Milestone Page Layouts You want to control which milestone-related

fields users see.

Enable Milestone Feed Items You want automatic notifications to be added

to the feed and the record owners profile
page when a milestone is completed or
violated.

Set Up the Milestone Tracker You want your support team to be able to
see a list of upcoming and closed milestones

7
Planning Your Implementation Entitlement Management Setup Checklist

Step Complete if...

and countdowns for active and overdue milestones.

Limit User Updates to Milestones You want to prevent users from updating milestones unless
certain criteria are met.

Create a Milestone You want to define a required step in your support process.

Auto-Complete Case Milestones You want milestones to be automatically marked Completed

on cases that match unique criteria.

Set Up an Entitlement Process You want to be able to apply the required steps in your support
process to specific records.

Create an Entitlement Process You want to create a timeline that includes all of the steps that
your support team must complete to resolve support records.

Customize Entitlement Process Fields You want to control which entitlement process fields users see.

Add a Milestone to an Entitlement Process You want to specify which required support steps occur, and
when, on your timeline.

Add a Milestone Action to an Entitlement Process You want to define time-dependent workflow actions that
occur at every step (milestone) in an entitlement process when
the milestone is nearing violation, violated, or completed.

Apply an Entitlement Process to an Entitlement You want a specific entitlements support records to follow the
steps defined in your entitlement process.

Create a New Version of an Entitlement Process You want to update an entitlement process.

Use a New Version of an Entitlement Process You want to apply a new version of an entitlement process to
new or existing entitlements.

Set Up Service Contracts You want customer support eligibility to be determined at the
service contract level.

Set Up Contract Line Items You want to be able to limit a service contract to cover specific
products.

Set Up Entitlement Management in Communities You want customers or partners to be able to view their
entitlements and service contracts and create support records
from them.

Report on Entitlements You want to view and share data on entitlements and service
contracts.

Give your support team entitlement management guidelines. You want your support team to understand:
How to verify that a customer is entitled to support
How to link cases or work orders to entitlements
How entitlement processes affect the way they resolve
cases or work orders

8
SETTING UP ENTITLEMENT MANAGEMENT

Set Up Entitlements
Entitlements are units of customer support in Salesforce, such as phone support or web support.
EDITIONS
Set up entitlements in your Salesforce org to help support agents determine whether a customer
is eligible for support. Available in: Salesforce
Classic
1. Enable Entitlements
Available in: Professional,
Enable entitlements in your Salesforce org to help support agents deliver the correct service Enterprise, Performance,
level to your customers. Unlimited, and Developer
2. Customize Entitlements Editions with the Service
Customize entitlement fields and page layouts based on your business needs and how your Cloud
agents work.
3. Set Up Entitlement and Asset Lookup Filters on Cases
Set up lookup filters on entitlement-related case fields to restrict the entitlements that users can select on a case.
4. Give Users Access to Entitlement Management
After you set up entitlement management, make sure that users have the appropriate user permissions, field access, and tab access.
5. Set Up an Entitlement Template
Entitlement templates let you predefine terms of support that users can add to products.
6. Automatically Add Entitlements to Cases from Web, Email, and Communities
Entitlements dont automatically apply to cases created using Web-to-Case, Email-to-Case, or communities. However, you can add
entitlements to these features using Apex code.

Enable Entitlements
Enable entitlements in your Salesforce org to help support agents deliver the correct service level
EDITIONS
to your customers.
1. From Setup, enter Entitlement Settings in the Quick Find box, then select Available in: Salesforce
Entitlement Settings. Classic
2. Select Enable Entitlement Management. Available in: Professional,
3. Click Save. This takes you to a page where you can customize entitlement management settings. Enterprise, Performance,
Unlimited, and Developer
Youll come back to those settings later on in the entitlement management setup process.
Editions with the Service
Cloud

USER PERMISSIONS

To enable entitlements:
Customize Application

9
Setting Up Entitlement Management Customize Entitlements

Customize Entitlements
Customize entitlement fields and page layouts based on your business needs and how your agents
EDITIONS
work.
1. Customize entitlements fields. Available in: Salesforce
This lets you control what information users add to entitlements. Classic

Available in: Professional,

Tip: Create custom entitlement fields that are specific to your industry or your support
Enterprise, Performance,
processes. For example:
Unlimited, and Developer
Customize the values for the Type field to match the types of entitlements your Editions with the Service
team provides or sells, like online support or online training. Cloud
If your business charges for entitlement renewals, create a currency field on
entitlements named Cost to Renew. USER PERMISSIONS

2. Customize entitlement page layouts. To edit page layouts and set

field history tracking:
This lets you specify which fields and related lists users see on entitlements. Consider making
Customize Application
the following customizations:
Add the Status Icon field so users can easily see whether the entitlement is active,
expired, or inactive.
Add the Cases, Contacts, and Work Orders related lists so users can:
View cases, contacts, and work orders associated with entitlements
Create cases or work orders automatically associated with the correct entitlements
Add contacts to entitlements

3. Set field history tracking on entitlements.

This lets you see when field values were changed. Changes are listed in the Entitlement History related list on entitlements. From
the object management settings for entitlements, go to the fields section and click Set History Tracking.

4. Customize other objects page layouts.

Add the Entitlement Name lookup field to case and work order page layouts. This lets users add entitlements to cases
or work orders.

Important: To let a user create cases from entitlements or change a cases assigned entitlement, make the Entitlement
Name field on cases editable for their profile.

Add the Entitlements related list to other objects page layouts:

Add the Entitlements related list to this objects page So users can view and create entitlements when...
layouts...
Accounts Any contact on the account is eligible for support

Contacts Specific contacts are eligible for support

Assets Specific assets (purchased products) are eligible for support

5. Make the Entitlements tab visible in Salesforce and any custom apps.

10
Setting Up Entitlement Management Set Up Entitlement and Asset Lookup Filters on Cases

The Entitlements tab is where users create and edit entitlements. Add the tab to an app or instruct your users to add it to an existing
tab set in Salesforce. Users need the Read permission on entitlements to see the Entitlements tab.

Set Up Entitlement and Asset Lookup Filters on Cases

Set up lookup filters on entitlement-related case fields to restrict the entitlements that users can
EDITIONS
select on a case.
For example, when community users create a case and use the lookup on the Entitlement Available in: Salesforce
Name field, you can set up lookup filters so they can choose only entitlements registered to their Classic
account or contact.
Available in: Professional,
1. From Setup, enter Entitlement Settings in the Quick Find box, then select Enterprise, Performance,
Entitlement Settings. Unlimited, and Developer
Editions with the Service
2. Choose the item(s) you'd like returned in the lookup fields.
Cloud

Lookup Field on Cases Click... To Return...

USER PERMISSIONS
Asset Same account on the Assets registered to the
case account on the case. To set up entitlement-related
lookups on cases: Manage
Tip: If you want the Entitlements
lookup field to return Manage Entitlements
all assets that share an
account with the case,
select only this option.

Same contact on the Assets registered to the

case contact on the case.

Entitlements on the Assets associated with

case's account entitlements that belong to
the cases account.

Entitlements on the Assets associated with

case's contact entitlements related to the
cases contact.

Entitlement Active status Entitlements with an Active

Status.

Same account on the Entitlements associated with

case the account on the case.

Same asset on the Entitlements associated with

case the asset on the case.

Same contact on the Entitlements associated with

case the contact on the case.

11
Setting Up Entitlement Management Give Users Access to Entitlement Management

Choosing multiple items acts as an AND function, so the more items you select, the more it restricts the options returned. For example,
choosing Same account on the case and Same contact on the case means the Asset lookup field only
returns assets registered to both the account and the contact on the case.

Tip: Choose items that match the way your support agents verify support eligibility. For example, choose the account-related
items if your support agents verify support eligibility based on accounts.

3. Click Save.

Note: Equivalent lookup filters arent available for work orders.

Give Users Access to Entitlement Management

After you set up entitlement management, make sure that users have the appropriate user
EDITIONS
permissions, field access, and tab access.
1. Assign entitlement management permissions to users. Available in: Salesforce
Classic
Users Who Will Need These Permissions Permissions Are
Available in: Professional,
Auto-Enabled on These
Enterprise, Performance,
Standard Profiles
Unlimited, and Developer
Set up entitlement Manage Entitlements System Administrator Editions with the Service
management, including Cloud
AND
milestones, entitlement
processes, and entitlement Customize Application
USER PERMISSIONS
templates
To create and edit users:
Provide entitlement Customize Application System Administrator
Manage Internal Users
management to a community AND

Create and Set Up

Communities

Create or update custom Manage Custom Report System Administrator

report types that include Types
entitlement management

Create and run reports based Create and Customize Read Only, Standard User,
on entitlement management Reports Solution Manager, Contract
custom report types Manager, Marketing User, and
System Administrator

Create cases with Create on cases Standard User, Solution

entitlements AND Manager, Contract Manager,
Marketing User, and System
Read on entitlements Administrator

Change a cases entitlement Edit on cases Standard User, Solution

AND Manager, Contract Manager,
Marketing User, and System
Read on entitlements Administrator

12
Setting Up Entitlement Management Give Users Access to Entitlement Management

Users Who Will Need These Permissions Permissions Are Auto-Enabled on

These Standard Profiles
Create work orders with entitlements Create on work orders Standard User, Solution Manager, Contract
AND Manager, Marketing User, and System
Administrator
Read on entitlements

Change a work orders entitlement Edit on work orders Standard User, Solution Manager, Contract
AND Manager, Marketing User, and System
Administrator
Read on entitlements

Verify or view entitlements Read on entitlements Read Only, Standard User, Solution
Manager, Contract Manager, Marketing
User, and System Administrator

Create entitlements Create on entitlements None: enable the permission in a

permission set or custom profile

Change entitlements Edit on entitlements None: enable the permission in a

permission set or custom profile

View entitlement contacts Read on entitlement contacts Read Only, Standard User, Solution
Manager, Contract Manager, Marketing
User, and System Administrator

Change entitlement contacts Create on entitlement contacts None: enable the permissions in a
AND permission set or custom profile

Delete on entitlement contacts

Verify or view service contracts Read on service contracts Read Only, Standard User, Solution
Manager, Contract Manager, Marketing
User, and System Administrator

Create service contracts Create on service contracts None: enable the permission in a
permission set or custom profile

Change service contracts Edit on service contracts None: enable the permission in a
permission set or custom profile

Verify or view contract line items Read on contract line items Read Only, Standard User, Solution
Manager, Contract Manager, Marketing
User, and System Administrator

Add contract line items to service contracts Edit on service contracts None: enable the permissions in a
AND permission set or custom profile

Create on contract line items and Read

on products and price books

Change contract line items on service Edit on service contracts None: enable the permissions in a
contracts AND permission set or custom profile

13
Setting Up Entitlement Management Set Up an Entitlement Template

Users Who Will Need These Permissions Permissions Are Auto-Enabled on

These Standard Profiles
Edit on contract line items and Read on
products and price books

Tip: If a standard profile doesnt include a certain user permission, you can create a permission set and enable the permission
in it. Or, clone the standard profile and enable the permission in the custom profile.

2. Set field-level security.

Choose which entitlement management fields users can view and edit. Field-level security settings let you specify users access to
fields in several areas of the user interface:
Detail and edit pages
Related lists
List views
Reports
Search results
Email and mail merge templates
Communities
You can set field-level security from a permission set, profile, or a particular field.

Important: To let a user create cases from entitlements or change a cases assigned entitlement, make the Entitlement
Name field on cases editable for their profile.

SEE ALSO:
Salesforce Help: Field-Level Security

Set Up an Entitlement Template

Entitlement templates let you predefine terms of support that users can add to products.
EDITIONS
You can create entitlement templates for specific products so support agents can quickly add the
right entitlement whenever a customer purchases the product. For example, you can create Available in: Salesforce
entitlement templates for web or phone support so agents can easily add entitlements to products Classic
offered to customers.
Available in: Professional,
Purchased or installed products are represented in Salesforce as assets. That means: Enterprise, Performance,
A product (for example, Laser Scanner) is linked to an entitlement template Unlimited, and Developer
Editions with the Service
A corresponding asset (for example, the laser scanner purchased by ABC Labs) is linked to an Cloud
entitlement that was created from the entitlement template

Note: Entitlement templates are only available if entitlements and products are enabled in USER PERMISSIONS
your org.
To create entitlement
Tip: The Entitlement Management Trailhead module introduces you to common terms and templates:
walks you through the process of creating an entitlement template. And, its fun! To get Manage Entitlements
started, see Entitlement Management.

14
Setting Up Entitlement Management Set Up an Entitlement Template

1. Add the Entitlement Templates related list to product page layouts.

2. Optionally, add the Type and Business Hours fields to the Entitlement Templates related list. This lets users view the type
of entitlement, such as Web or phone support, and any business hours that apply to the entitlement.
3. Create an entitlement template.
a. From Setup, enter Templates in the Quick Find box, then select Entitlement Templates.
b. Click New Template.
c. Enter any details:

Field Description
Entitlement Template Name The name of the entitlement template.
Use a descriptive name, like Phone Support. This helps
users better understand entitlement templates when they see
them on related lists for products.

Term (Days) The number of days the entitlement is in effect.

For example, if you want the entitlement template to entitle
all customers who purchase this product to 90 days of phone
support, enter 90.

Entitlement Process The entitlement process associated with the entitlement.

Per Incident Lets you limit the number of cases the entitlement supports.
The admin determines whether this field is visible.

Cases Per Entitlement The total number of cases the entitlement supports.
This field is only available if Per Incident is selected.

Business Hours The entitlements supported business hours.

Type The type of entitlement, such as Web or phone support.

Admins can customize this fields values.

4. Click Save.
5. Add the entitlement template to a product.
a. Go to the product detail page.
b. Click Add Entitlement Template on the Entitlement Templates related list.
c. Select the entitlement template.
d. Click Insert Selected.
e. Click Done.
Now when a user creates an asset and links it to that product, the Entitlements related list on the asset includes an entitlement
created from the entitlement template. That way, support agents responding to a call about the asset can quickly see what kind of
support the customer is entitled to receive.

15
Setting Up Entitlement Management Automatically Add Entitlements to Cases from Web, Email,
and Communities

Note: All users, even those without the View Setup and Configuration user permission, can view entitlement templates via the
API.

Automatically Add Entitlements to Cases from Web, Email, and Communities

Entitlements dont automatically apply to cases created using Web-to-Case, Email-to-Case, or
EDITIONS
communities. However, you can add entitlements to these features using Apex code.
When a case is created via Web-to-Case, Email-to-Case, or a community, it isnt automatically Available in: Salesforce
associated with an entitlement. When a cases Entitlement field is empty, this sample trigger Classic
checks whether the case contact has an active entitlement. If the contact has an active entitlement,
Available in: Professional,
the entitlement is added to the case. If the contact doesnt have an active entitlement, the trigger Enterprise, Performance,
then checks whether the case account has an active entitlement. If the case account has an active Unlimited, and Developer
entitlement, the entitlement is added to the case. The trigger helps ensure that cases are resolved Editions with the Service
according to your customer support agreements. Cloud
To define this case trigger in your Salesforce org:
1. From Setup, enter Case Triggers in the Quick Find box, then select Case Triggers. USER PERMISSIONS
2. Click New. To define Apex triggers:
3. Copy the text below and paste it in the text field. Author Apex
4. Click Save.
trigger DefaultEntitlement on Case (Before Insert, Before Update) {
List <EntitlementContact> entlContacts =
[Select e.EntitlementId,e.ContactId,e.Entitlement.AssetId
From EntitlementContact e
Where e.ContactId in :contactIds
And e.Entitlement.EndDate >= Today
And e.Entitlement.StartDate <= Today];
if(entlContacts.isEmpty()==false){
for(Case c : Trigger.new){
if(c.EntitlementId == null && c.ContactId != null){
for(EntitlementContact ec:entlContacts){
if(ec.ContactId==c.ContactId){
c.EntitlementId = ec.EntitlementId;
if(c.AssetId==null && ec.Entitlement.AssetId!=null)
c.AssetId=ec.Entitlement.AssetId;
break;
}
}
}
}
} else{
List <Entitlement> entls = [Select e.StartDate, e.Id, e.EndDate,
e.AccountId, e.AssetId
From Entitlement e
Where e.AccountId in :acctIds And e.EndDate >= Today
And e.StartDate <= Today];
if(entls.isEmpty()==false){
for(Case c : Trigger.new){
if(c.EntitlementId == null && c.AccountId != null){
for(Entitlement e:entls){

16
Setting Up Entitlement Management Set Up Service Contracts

if(e.AccountId==c.AccountId){
c.EntitlementId = e.Id;
if(c.AssetId==null && e.AssetId!=null)
c.AssetId=e.AssetId;
break;
}
}
}
}
}
}
}
}

Set Up Service Contracts

Service contracts are agreements between you and your customers for a type of customer support.
EDITIONS
Service contracts can represent different kinds of customer support, such as warranties, subscriptions,
or service level agreements (SLAs). Available in: Salesforce
Note: Entitlements must be enabled in your org for you to set up service contracts. Classic

Available in: Professional,

From the object management settings for service contracts:
Enterprise, Performance,
1. Customize service contract fields. Unlimited, and Developer
This lets you control what information users add to service contracts. You can create custom Editions with the Service
service contract fields that are specific to your industry or support process. Cloud

2. Customize service contract page layouts.

USER PERMISSIONS
This lets you specify which fields and related lists users see on service contracts. Consider making
the following customizations: To set up service contracts:
Add the Status Icon field so users can easily see whether the service contract is active, Manage Entitlements
expired, or inactive. AND
To let users make one service contract the parent of another, add the Parent Service Customize Application
Contract field and Child Service Contracts related list. You can also add the read-only
Root Service Contract field so users can see the top-level service contract in a
service contract hierarchy. A service contract hierarchy can contain up to 10,000 service contracts.

3. Set field-level security on service contract fields.

This lets you choose which service contract fields users can access.

4. Set field history tracking on service contracts.

This lets you see when field values were changed. Changes are listed in the Service Contract History related list on service contracts.
From the object management settings for service contracts, go to the fields section, and then click Set History Tracking.

5. Make the Service Contracts tab visible in Salesforce and any custom apps.
The Service Contracts tab is where users create and edit service contracts and contract line items. Add the tab to an app or instruct
your users to add it to an existing tab set in Salesforce. Users need the Read permission on service contracts to see the Service
Contracts tab.

6. Add the Service Contracts related list to account and contact page layouts.

17
Setting Up Entitlement Management Set Up Contract Line Items

This lets users create, update, and verify service contracts from accounts and contacts.

Set Up Contract Line Items

Set up contract line items to be able to specify which products a service contract covers. Contract
EDITIONS
line items only display to users on the Contract Line Items related list on service contracts (not on
contracts!). You can only use contract line items if your Salesforce org uses products. Available in: Salesforce
Note: Entitlements must be enabled in your org for you to set up contract line items. Classic

Available in: Professional,

From the object management settings for contract line items:
Enterprise, Performance,
1. Customize contract line item fields. Unlimited, and Developer
This lets you control what information users add to contract line items. You can create custom Editions with the Service
contract line item fields that are specific to your industry or support process. Cloud

2. Customize contract line item page layouts.

USER PERMISSIONS
This lets you specify which fields and related lists users see on contract line items. Consider
making the following customizations: To set up service contracts
and contract line items with
Add the Status Icon field so users can easily see whether the line item is active,
entitlements:
expired, or inactive.
Manage Entitlements
To let users make one line item the parent of another, add the Parent Contract
AND
Line Item field and Child Contract Line Items related list. You can also add the read-only
Root Contract Line Item field, which lists the top-level line item in a contract Customize Application
line item hierarchy. A contract line item hierarchy can contain up to 10,000 line items.

3. Customize other objects page layouts.

This lets you choose how users can associate contract line items with other records. Consider making the following customizations:
(Required) Add the Contract Line Items related list to service contract page layouts. This lets users create, edit, and delete contract
line items from service contracts.
Add the Contract Line Items related list to asset layouts. This lets users view and change associations between assets and contract
line items.
Add the Contract Line Item lookup field to entitlement page layouts. This lets users associate a line item with a particular
entitlement.

4. Set field-level security on contract line items.

This lets you choose which contract line item fields users can access.

5. Set field history tracking on contract line items.

This lets you see when field values were changed. Changes are listed in the Contract Line Item History related list on contract line
items. From the object management settings for contract line items, go to the fields section, and then click Set History Tracking.

Note: Schedules aren't available for contract line items, and community users cant access them.

18
Setting Up Entitlement Management Set Up Entitlement Management in Communities

Set Up Entitlement Management in Communities

Add entitlement management to your communities to let customers or partners view their
EDITIONS
entitlements and service contracts. Contract line items dont display in communities.
Follow these steps to expose entitlements and/or service contracts in a community. Available in: Salesforce
Classic
1. Update user profiles.
a. Clone the Customer Community User, Customer Community Plus User, or Partner Communities are available
Community User profiles and enable the Read permission on entitlements and/or service in: Enterprise, Performance,
contracts. Unlimited, and Developer
Editions with the Service
Note: Remember to click Edit Profiles at the bottom of the detail page to activate Cloud
the new profiles.
Entitlement Management is
b. Optionally, on the profiles of delegated community moderators, enable the Create and available in Professional,
Delete permissions on entitlement contacts. This lets moderators update entitlement Enterprise, Performance,
Unlimited, and Developer
contacts.
Editions with the Service
c. Verify that the tab visibility for the Entitlements and/or Service Contracts tabs is Default On. Cloud

2. Add the Entitlements and/or Service Contracts tabs to the community.

3. Add the Entitlement Name field to case and work order page layouts assigned to USER PERMISSIONS
community users. This lets users add entitlements to cases and work orders. Work orders are To create, customize, or
not available in communities built using the self-service community templates. activate a community:
Create and Set Up
Note: To avoid exposing your internal support processes, we recommend not adding
Communities AND is a
the following fields to case and work order page layouts for community users: member of the
Entitlement Process Start Time community theyre
updating
Entitlement Process End Time
To set up entitlement
Stopped management:
Stopped Since Manage Entitlements
To assign user licenses:
4. Optionally, add the Entitlements related list to account and contact page layouts assigned to Manage Internal Users
community moderators. This lets moderators create cases automatically associated with the
right entitlements.

19
Setting Up Entitlement Management Report on Entitlements

Report on Entitlements
Use custom report types to define report criteria that users can use to run and create reports on
EDITIONS
entitlements, service contracts, and contract line items.
After you set up entitlement management, your Salesforce org automatically includes the following Available in: Salesforce
custom report types: Classic

Available in: Professional,

Custom Report Type Description Report Type Location Enterprise, Performance,
Accounts with entitlements Lists accounts with Accounts & Contacts Unlimited, and Developer
with contacts entitlements that include Editions with the Service
contacts (named callers). Cloud

Service contracts with contract Lists service contracts with Customer Support Reports
line items contract line items (products). USER PERMISSIONS

Service contracts with Lists service contracts with Customer Support Reports To create or update
entitlement management
entitlements entitlements.
custom report types:
Cases with milestones Lists cases with milestones. Customer Support Reports Manage Custom Report
Types
Note: This report type
To create and run reports
cant be customized. based on entitlement
management custom report
types:
To customize entitlement management custom report types: Create and Customize
Reports
1. From Setup, enter Report Types in the Quick Find box, then select Report Types.
2. From the All Custom Report Types page, you can:
Define a new custom report type. You can't select entitlements as a primary object.
Update a custom report type's name, description, report type category, and deployment status.
Delete a custom report type.

Important: When you delete a custom report type, all the data stored in the custom report type is deleted and cannot
be restored from the Recycle Bin.

Tip: If you want to view a list of work orders with milestones in your org, use the Object Milestones custom report type to create
a work order report.

20
ENFORCING SERVICE LEVELS

Set Up Milestones
Milestones represent required steps in your support management process, like first response times.
EDITIONS
Set up and customize milestones in your org so they can be added to entitlement processes and
applied to support records like cases and work orders. Available in: Salesforce
Classic
1. Customize Milestone Page Layouts
Available in: Professional,
Milestones appear in the Case Milestones related list on cases, and the Object Milestones related Enterprise, Performance,
list on work orders. Customize your page layouts to help support agents and supervisors track Unlimited, and Developer
support progress. Editions with the Service
2. Enable Milestone Feed Items Cloud
Help support agents monitor support activity by enabling milestone feed items. This option
posts a notification to the feed and the record owners profile page when a milestone is
completed or violated.
3. Set Up the Milestone Tracker
The milestone tracker gives support agents a complete view of upcoming and closed milestones, and displays countdowns for active
and overdue milestones. Add it to the case feed, work order feed, a custom page, or the service console.
4. Limit User Updates to Milestones
Add validation rules to milestones to prevent users from updating milestones unless certain criteria are met.
5. Create a Milestone
Milestones represent required steps in your support process, such as case resolution time and first response time. Youll create
master milestones in your org, then add them to entitlement processes to enforce different service levels on support records like
cases and work orders.
6. Auto-Complete Case Milestones
Create an Apex trigger that automatically marks milestones Completed on cases that match unique criteria. In your trigger, define
which events and related case criteria must be satisfied for a milestone to be marked Completed. You can implement a similar trigger
to auto-complete work order milestones.

21
Enforcing Service Levels Customize Milestone Page Layouts

Customize Milestone Page Layouts

Milestones appear in the Case Milestones related list on cases, and the Object Milestones related
EDITIONS
list on work orders. Customize your page layouts to help support agents and supervisors track
support progress. Available in: Salesforce
1. Add any of the following fields to case and object milestone detail pages. Classic
To edit case milestone detail page layouts, from Setup, enter Case Milestones in Available in: Professional,
the Quick Find box, then click Page Layouts under Case Milestones. Enterprise, Performance,
To edit object milestone detail page layouts (which apply to work order milestones), from Unlimited, and Developer
Setup, enter Object Milestones in the Quick Find box, then click Page Layouts Editions with the Service
under Object Milestones. Cloud

Field Description USER PERMISSIONS

Actual Elapsed Time The amount of time that it took to complete To create and edit page
a milestone. layouts:
(Elapsed Time) (Stopped Time) = (Actual Customize Application
Elapsed Time) To create milestones:
Manage Entitlements
Note: If you want to be able to display
this field, Enable stopped time and AND
actual elapsed time must be selected Customize Application
on the Entitlement Settings page.
To enable the Stopped
Time and Actual Elapsed
Completed Icon ( ) that indicates a milestone Time fields:
completion. Manage Entitlements
Completion Date The date and time the milestone was
completed.

Elapsed Time The time it took to complete a milestone.

Automatically calculated to include any
business hours on the support record. Elapsed
time is calculated only after the Completion
Date field is populated.

Entitlement Process The entitlement process that is being used for

the record. Entitlement processes are optional.

Start Date The date and time that the milestone tracking
started.

Stopped Time How long an agent has been blocked from

completing a milestone. For example, an
agent might wait for a customer to reply with
more information.

Note: Enable stopped time and

actual elapsed time must be selected
on the Entitlement Settings page.

22
Enforcing Service Levels Customize Milestone Page Layouts

Field Description
Target Date The date and time to complete the milestone.

Target Response The time to complete the milestone. Automatically calculated

to include any business hours on the support record.

Time Remaining The time that remains before a milestone violation. Automatically
calculated to include any business hours on the support record.

Time Since Target The time that has elapsed since a milestone violation.
Automatically calculated to include any business hours on the
support record.

Violation Icon ( ) that indicates a milestone violation.

2. Add milestone elements to case and work order page layouts:

a. Add milestone fields:

Field Description
Milestone Status The milestones status.

Milestone Status Icon An icon that corresponds to the milestone status:

Compliant
Open Violation
Closed Violation

Entitlement Process Start Time The time the record enters the entitlement process.

Entitlement Process End Time The time the record exits the entitlement process.

b. Add the Case Milestones or Object Milestones related list to display the records milestones.

23
Enforcing Service Levels Enable Milestone Feed Items

Enable Milestone Feed Items

Help support agents monitor support activity by enabling milestone feed items. This option posts
EDITIONS
a notification to the feed and the record owners profile page when a milestone is completed or
violated. Available in: Salesforce
Important: Classic

Chatter and entitlements must be enabled in your org. Available in: Professional,
Enterprise, Performance,
Enabling milestone feed items doesn't create feed items for milestones that have already
Unlimited, and Developer
been completed or violated.
Editions with the Service
If you add entitlement management to a community, enabling milestone feed items also Cloud
makes feed items visible to community users.

1. From Setup, enter Entitlement Settings in the Quick Find box, then select USER PERMISSIONS
Entitlement Settings.
To enable milestone feed
2. Select Enable milestone feed items. This enables feed items for both cases and items:
work orders. Manage Entitlements

Set Up the Milestone Tracker

The milestone tracker gives support agents a complete view of upcoming and closed milestones,
EDITIONS
and displays countdowns for active and overdue milestones. Add it to the case feed, work order
feed, a custom page, or the service console. Available in: Salesforce
Often, support agents performance is measured by how often they meet milestones. The milestone Classic
tracker helps agents be prepared for support deadlines by showing them:
Available in: Professional,
The time remaining until an active milestone reaches its Target Date Enterprise, Performance,
The time passed since an overdue milestones Target Date Unlimited, and Developer
Editions with the Service
A list of upcoming milestones
Cloud
A list of closed milestones
When a milestone is in progress, the milestone is represented by a green circle. The circle winds USER PERMISSIONS
down clockwise as time elapses. The remaining time is shown in the center of the circle. When the
time to complete the milestone expires, the circle turns red. The amount of time that the milestone To create and edit page
is overdue is shown in the center of the circle. layouts:
Customize Application
To assign page layouts:
Manage Users
To set how time displays in
the milestone tracker:
Manage Entitlements

24
Enforcing Service Levels Set Up the Milestone Tracker

If more than 24 hours remain on a milestone, the countdown displays in days (for example, 1d). When fewer than 24 hours remain, the
countdown format switches to hours/minutes/seconds.
1. Expose the milestone tracker to support agents.
You can expose the tracker in one of three ways:
Add it to the case feed. If you plan to use milestones on work orders, follow the same steps to add the tracker to the work order
feed.
a. From the object management settings for cases, go to Page Layouts.
b. In the Case Page Layouts section, click Edit, and then click Feed View in the page layout editor.
c. In the Other Tools and Components section, select the Milestone Tracker and specify where on the page you want it to
appear.
d. Click Save.

Add it to a custom Visualforce page using the <apex:milestoneTracker> component.

Add it as a component to the service console.

2. Set how the milestone tracker displays time remaining or time overdue on milestones.
By default, the tracker uses actual hours. To make it display time remaining or time overdue in business hours, follow these steps.
a. From Setup, enter Entitlement Settings in the Quick Find box, then select Entitlement Settings.
b. In the Milestone Tracker section, deselect Show the time remaining in actual hours, not business hours.
c. Click Save.

Example: Suppose an active milestones business hours are 9 a.m. to 5 p.m. Right now, its 4:30 p.m. and the milestones Target
Date is 11:00 a.m. tomorrow.
If the milestone tracker shows the remaining time in business hours (the default setting), it displays a countdown of 2 hours
and 30 minutes (4:30 to 5 p.m. today and 9 to 11 a.m. tomorrow).
If the milestone tracker shows the remaining time in actual hours, it displays a countdown of 18 hours and 30 minutes (4:30
p.m. today to 11:00 a.m. tomorrow).

25
Enforcing Service Levels Limit User Updates to Milestones

Limit User Updates to Milestones

Add validation rules to milestones to prevent users from updating milestones unless certain criteria
EDITIONS
are met.
1. From the object management settings for case milestones, go to Validation Rules. Available in: Salesforce
Classic
2. Click New.
3. Enter the rule details. Available in: Professional,
Enterprise, Performance,
4. Save your changes. Unlimited, and Developer
Example: This validation rule prevents users from selecting milestone completion dates Editions with the Service
Cloud
that are earlier than the case creation date. You can create a similar validation rule for work
orders from the object management settings for Object Milestones in Setup.
USER PERMISSIONS
Field Value
To define or change field
Rule Name milestone_completion_date validation rules:
Customize Application
Description A milestones completion date
must be later than the case To create or edit milestones:
creation date. Manage Entitlements

Error Condition Formula CompletionDate <

Case.CreatedDate

Error Message Error: The milestone

completion date must be later
than the case creation date.

Error Location Top of Page

26
Enforcing Service Levels Create a Milestone

Create a Milestone
Milestones represent required steps in your support process, such as case resolution time and first
EDITIONS
response time. Youll create master milestones in your org, then add them to entitlement processes
to enforce different service levels on support records like cases and work orders. Available in: Salesforce
Classic
Follow these steps to create a milestone. Walk Through It: Create a Milestone. Available in: Professional,
Tip: The Entitlement Management Trailhead module introduces you to common terms and Enterprise, Performance,
Unlimited, and Developer
walks you through the process of creating milestones. And, its fun! To get started, see
Editions with the Service
Entitlement Management.
Cloud
1. From Setup, enter Milestones in the Quick Find box, then select Milestones under
Entitlement Management.
USER PERMISSIONS
2. Click New Milestone.
To create milestones:
3. Enter a name and description. Try to name milestones after common support tasks, like First
Manage Entitlements
Response Time or Resolution Time. Descriptive names help users understand milestones
when they see them on cases, work orders, or entitlement processes. AND

4. Select a recurrence type. Customize Application

Recurrence Type Description Example

No Recurrence The milestone occurs only First Response
once on the record. Resolution Time

Independent The milestone occurs Response Time

whenever the milestone
criteria are met on the record.

Sequential The milestone occurs on Customer Contact Made

repeat whenever the
milestone criteria are met on
the record.

5. Click Save.
You cant apply milestones to a record by themselves; they must be part of an entitlement process. So after you create your milestone,
add it to an entitlement process.

Tip: You can add validation rules to milestones so users can only update a milestone if it meets specific standards. For details, see
Limit User Updates to Milestones.

27
Enforcing Service Levels Auto-Complete Case Milestones

Auto-Complete Case Milestones

Create an Apex trigger that automatically marks milestones Completed on cases that match unique
EDITIONS
criteria. In your trigger, define which events and related case criteria must be satisfied for a milestone
to be marked Completed. You can implement a similar trigger to auto-complete work order Available in: Salesforce
milestones. Classic
The following triggers mark specific types of milestones Completed when the case they are on
Available in: Professional,
meets unique criteria. Weve also provided a milestone utility Apex class and accompanying unit
Enterprise, Performance,
tests. Define the milestone utility class before you use any of the triggers. Unlimited, and Developer
Milestone Utility Apex Class Editions with the Service
Apex classes reduce the size of your triggers and make it easier to reuse and maintain Apex Cloud
code. To define this Apex class in your org:
1. From Setup, enter Apex Classes in the Quick Find box, then click Apex Classes. USER PERMISSIONS
2. Click New. To define Apex triggers and
3. Copy the class text and paste it into the text field. classes:
Author Apex
4. Click Save.

public class MilestoneUtils {

public static void completeMilestone(List<Id> caseIds,
String milestoneName, DateTime complDate) {
List<CaseMilestone> cmsToUpdate = [select Id, completionDate
from CaseMilestone cm
where caseId in :caseIds and cm.MilestoneType.Name=:milestoneName
and completionDate = null limit 1];
if (cmsToUpdate.isEmpty() == false){
for (CaseMilestone cm : cmsToUpdate){
cm.completionDate = complDate;
}
update cmsToUpdate;
}
}
}

Apex Class Unit Test

You can set up Apex unit tests in the developer console to scan your code for any issues.
/**
* This class contains unit tests for validating the behavior of Apex classes
* and triggers.
*
* Unit tests are class methods that verify whether a particular piece
* of code is working properly. Unit test methods take no arguments,
* commit no data to the database, and are flagged with the testMethod
* keyword in the method definition.
*
* All test methods in an organization are executed whenever Apex code is deployed
* to a production organization to confirm correctness, ensure code
* coverage, and prevent regressions. All Apex classes are
* required to have at least 75% code coverage in order to be deployed
* to a production organization. In addition, all triggers must have some code coverage.

28
Enforcing Service Levels Auto-Complete Case Milestones

*
* The @isTest class annotation indicates this class only contains test
* methods. Classes defined with the @isTest annotation do not count against
* the organization size limit for all Apex scripts.
*
* See the Apex Language Reference for more information about Testing and Code Coverage.
*/
@isTest
private class MilestoneTest {

static testMethod void TestCompleteMilestoneCase(){

List<Account> acts = new List<Account>();

Account myAcc = new Account(Name='TestAct', phone='1001231234');
acts.add(myAcc);

Account busAcc = new Account(Name = 'TestForMS', phone='4567890999');

acts.add(busAcc);
insert acts;
Contact cont = new Contact(FirstName = 'Test', LastName = 'LastName', phone='4567890999',
accountid = busAcc.id);
insert(cont);

Id contactId = cont.Id;

Entitlement entl = new Entitlement(Name='TestEntitlement', AccountId=busAcc.Id);

insert entl;

String entlId;
if (entl != null)
entlId = entl.Id;

List<Case> cases = new List<Case>{};

if (entlId != null){
Case c = new Case(Subject = 'Test Case with Entitlement ',
EntitlementId = entlId, ContactId = contactId);
cases.add(c);
}
if (cases.isEmpty()==false){
insert cases;
List<Id> caseIds = new List<Id>();
for (Case cL : cases){
caseIds.add(cL.Id);
}
milestoneUtils.completeMilestone(caseIds, 'First Response', System.now());
}
}

static testMethod void testCompleteMilestoneViaCase(){

List<Account> acts = new List<Account>();

Account myAcc = new Account(Name='TestAct', phone='1001231234');
acts.add(myAcc);

29
Enforcing Service Levels Auto-Complete Case Milestones

Account busAcc = new Account(Name = 'TestForMS', phone='4567890999');

acts.add(busAcc);
insert acts;
Contact cont = new Contact(FirstName = 'Test', LastName = 'LastName', phone='4567890999',
accountid = busAcc.id);
insert(cont);

Id contactId = cont.Id;

Entitlement entl = new Entitlement(Name='TestEntitlement', AccountId=busAcc.Id);

insert entl;

String entlId;
if (entl != null)
entlId = entl.Id;

List<Case> cases = new List<Case>{};

for(Integer i = 0; i < 1; i++){
Case c = new Case(Subject = 'Test Case ' + i);
cases.add(c);
if (entlId != null){
c = new Case(Subject = 'Test Case with Entitlement ' + i,
EntitlementId = entlId);
cases.add(c);
}
}

Sample Trigger 1
You can create a milestone named Resolution Time that requires cases to be closed within a certain length of time. Its a great way
to enforce case resolution terms in SLAs. This sample case trigger marks each Resolution Time milestone Completed when its case
is closed. This way, the support agent doesnt have to manually mark the milestone completed after closing the case.

Note: This trigger references the milestone utility test class, so be sure to define the test class first.

To define this trigger in your org:

1. From Setup, enter Case Triggers in the Quick Find box, then click Case Triggers.
2. Click New.
3. Copy the trigger text and paste it into the text field.
4. ClickSave.
trigger CompleteResolutionTimeMilestone on Case (after update) {
if (UserInfo.getUserType() == 'Standard'){
DateTime completionDate = System.now();
List<Id> updateCases = new List<Id>();
for (Case c : Trigger.new){
if (((c.isClosed == true)||(c.Status == 'Closed'))&&((c.SlaStartDate

<= completionDate)&&(c.SlaExitDate == null)))

updateCases.add(c.Id);
}
if (updateCases.isEmpty() == false)
milestoneUtils.completeMilestone(updateCases, 'Resolution Time', completionDate);

30
Enforcing Service Levels Auto-Complete Case Milestones

}
}

Sample Trigger 2
You can create a milestone named First Response that requires agents to get in touch with a case contact within X minutes or hours
of the cases creation. Its a nice way to ensure that your support team is communicating with case contacts as soon as possible. This
sample email trigger marks a First Response milestone Completed when an email is sent to the case contact. That way, the support
agent doesnt have to manually mark the First Response milestone Completed after they email the case contact.

Note: This trigger references the milestone utility test class, so be sure to define the test class first.

To define this trigger in your org:

1. From Setup, enter Email Triggers in the Quick Find box, then click Email Triggers.
2. Click New.
3. Copy the trigger text and paste it into the text field.
4. ClickSave.
trigger CompleteFirstResponseEmail on EmailMessage (after insert) {
if (UserInfo.getUserType() == 'Standard'){
DateTime completionDate = System.now();
Map<Id, String> emIds = new Map<Id, String>();
for (EmailMessage em : Trigger.new){
if(em.Incoming == false)
emIds.put(em.ParentId, em.ToAddress);
}
if (emIds.isEmpty() == false){
Set <Id> emCaseIds = new Set<Id>();
emCaseIds = emIds.keySet();
List<Case> caseList = [Select c.Id, c.ContactId, c.Contact.Email,
c.OwnerId, c.Status,
c.EntitlementId,
c.SlaStartDate, c.SlaExitDate
From Case c where c.Id IN :emCaseIds];
if (caseList.isEmpty()==false){
List<Id> updateCases = new List<Id>();
for (Case caseObj:caseList) {
if ((emIds.get(caseObj.Id)==caseObj.Contact.Email)&&
(caseObj.Status == 'In Progress')&&
(caseObj.EntitlementId != null)&&
(caseObj.SlaStartDate <= completionDate)&&
(caseObj.SlaStartDate != null)&&
(caseObj.SlaExitDate == null))
updateCases.add(caseObj.Id);
}
if(updateCases.isEmpty() == false)
milestoneUtils.completeMilestone(updateCases,
'First Response', completionDate);
}
}
}
}

31
Enforcing Service Levels Auto-Complete Case Milestones

Sample Trigger 3
While the previous trigger dealt with email messages, this sample case comment trigger marks a First Response milestone Completed
when a public comment is made on the case. You can use it if a public case comment is a valid first response in your support terms.

Note: This trigger references the milestone utility test class, so be sure to define the test class first.

To define this trigger in your org:

1. From Setup, enter Case Comment Triggers in the Quick Find box, then click Case Comment Triggers.
2. Click New.
3. Copy the trigger text and paste it into the text field.
4. Click Save.
trigger CompleteFirstResponseCaseComment on CaseComment (after insert) {
if (UserInfo.getUserType() == 'Standard'){
DateTime completionDate = System.now();
List<Id> caseIds = new List<Id>();
for (CaseComment cc : Trigger.new){
if(cc.IsPublished == true)
caseIds.add(cc.ParentId);
}
if (caseIds.isEmpty() == false){
List<Case> caseList = [Select c.Id, c.ContactId, c.Contact.Email,
c.OwnerId, c.Status,
c.EntitlementId, c.SlaStartDate,
c.SlaExitDate
From Case c
Where c.Id IN :caseIds];
if (caseList.isEmpty() == false){
List<Id> updateCases = new List<Id>();
for (Case caseObj:caseList) {
if ((caseObj.Status == 'In Progress')&&
(caseObj.EntitlementId != null)&&
(caseObj.SlaStartDate <= completionDate)&&
(caseObj.SlaStartDate != null)&&
(caseObj.SlaExitDate == null))
updateCases.add(caseObj.Id);
}
if(updateCases.isEmpty() == false)
milestoneUtils.completeMilestone(updateCases,
'First Response', completionDate);
}
}
}
}

32
Enforcing Service Levels Set Up an Entitlement Process

Set Up an Entitlement Process

Entitlement processes are timelines that include all of the steps (milestones) that your support team
EDITIONS
must complete to resolve cases or work orders. Set up an entitlement process to apply to
entitlements in your Salesforce org. Available in: Salesforce
Classic
1. Create an Entitlement Process
Available in: Professional,
Create an entitlement process to give support agents a timeline of required steps to follow Enterprise, Performance,
when solving support records. Each process includes the logic necessary to determine how to Unlimited, and Developer
enforce the correct service level for your customers. Editions with the Service
2. Customize Entitlement Process Fields Cloud
If you intend to use entitlement processes in your Salesforce org, customize page layouts to
ensure that support agents can see and interact with entitlement processes.
3. Add a Milestone to an Entitlement Process
Add milestones to entitlement processes to define required steps in your support process.
4. Add a Milestone Action to an Entitlement Process
Milestone actions are time-dependent workflow actions that occur at every step (milestone) in an entitlement process. After you
create an entitlement process and add milestones to it, add milestone actions to the milestones.
5. Apply an Entitlement Process to an Entitlement
Youve created an entitlement process; now its time to use it! Apply an entitlement process to a customers entitlement so all support
records linked to the entitlement use that process.

Create an Entitlement Process

Create an entitlement process to give support agents a timeline of required steps to follow when
EDITIONS
solving support records. Each process includes the logic necessary to determine how to enforce
the correct service level for your customers. Available in: Salesforce
Note: You must create milestones before you create an entitlement process. Classic

Available in: Professional,

Tip: The Entitlement Management Trailhead module introduces you to common terms and Enterprise, Performance,
walks you through creating an entitlement process. And, its fun! To get started, see Entitlement Unlimited, and Developer
Management. Editions with the Service
1. From Setup, enter Entitlement Processes in the Quick Find box, then select Cloud
Entitlement Processes under Entitlement Management.
2. Click New Entitlement Process. USER PERMISSIONS
3. Select an entitlement process type. If you intend to use the process to enforce milestones on To view entitlements:
cases, select Case. If you intend to use the process to enforce milestones on work orders, select Read on entitlements
Work Order. (If work orders arent enabled in your org, you only see the Case option.)
To change entitlements:
Note: If youre using entitlement processes, manage customers work orders and cases Edit on entitlements
on separate entitlements. This is because an entitlement process only runs on records To create and update
that match its type. For example, when a Case entitlement process is applied to an entitlement processes:
entitlement, the process only runs on cases associated with the entitlement. If a work Manage Entitlements
order is also associated with the entitlement, the process wont run on the work order.

33
Enforcing Service Levels Create an Entitlement Process

4. Enter a namefor example, Standard Support Processand a description.

5. If you want to enable the process, select Active.

Tip: We recommend waiting to activate an entitlement process until you add milestone actions to it. You cant update or
delete milestone actions on a process after its activated and applied to a record.

6. Optionally, if entitlement versioning is enabled, select Default Version to make this version of the entitlement process the default.
7. Choose the criteria for records to enter and exit the entitlement process.

Field Description More Actions to Take?

Record* enters the process Based on record created date No
Select if records should enter the process
when theyre created.

Based on a custom date/time field on Yes, a drop-down list displays for selecting
the record the custom date/time. You can only
Select if you want the value of a custom choose a custom date/time, not a custom
date/time field on the record to determine date.
when the record enters the process.

Record exits the process Based on when record is closed No

Select if records should exit the process
when they're closed.

Based on custom criteria Yes, select one of the following:

Select if records should exit the process Choose criteria are met and
based on criteria you define. select the filter criteria that a record
must meet for it to exit the process.
For example, set a case filter to
Priority equals Low if you
want cases with the Priority field
marked Low to exit the process.
Choose formula evaluates
to true and enter a formula that
returns a value of True or False.
Salesforce triggers the rule if the
formula returns True.

Choose formula evaluates

to true and enter a formula that
returns a value of True or False.
Records exit the process if the formula
returns True. For example, the
formula (Case: Priority
equals Low) AND(Case:
Case Origin equals
Email, Web) moves cases out of

34
Enforcing Service Levels Customize Entitlement Process Fields

Field Description More Actions to Take?

the process if their Priority field
is Low and the Case Origin field
is marked Email or Web.

*The field names you see will reflect the entitlement process type you selected.

8. Optionally, choose the business hours youd like to apply to the entitlement process. The business hours you set here calculate the
Target Date for all the milestones on this entitlement process. To learn more, see How Business Hours Work in Entitlement Management.
9. Save your changes.

Customize Entitlement Process Fields

If you intend to use entitlement processes in your Salesforce org, customize page layouts to ensure
EDITIONS
that support agents can see and interact with entitlement processes.
1. Add these fields to case and work order page layouts: Available in: Salesforce
Classic
Field Description
Available in: Professional,
Timeline (available only on case page How far along a case is to reaching an Enterprise, Performance,
layouts) entitlement processs milestones. You can click Unlimited, and Developer
or hover your mouse pointer over each Editions with the Service
milestone to view its details. These icons Cloud
represent milestones:
USER PERMISSIONS
Completed milestone To edit page layouts:
Customize Application

Violated milestone

You can drag the Handle icon ( ) along the

Timeline Zoom tool to view past and future
milestones. If an entitlement process applies
to the case, this field appears.

Stopped Lets you stop an entitlement process on a

record, which might be necessary if youre
waiting for a customers reponse.

Stopped Since The date and time the entitlement process

was stopped on the record.

2. Save your changes.

35
Enforcing Service Levels Add a Milestone to an Entitlement Process

Add a Milestone to an Entitlement Process

Add milestones to entitlement processes to define required steps in your support process.
EDITIONS
1. From Setup, enter Entitlement Processes in the Quick Find box, then select
Entitlement Processes. Available in: Salesforce
Classic
2. Click the name of an entitlement process.
3. If youre using versioning, click the name of the entitlement process again under Entitlement Available in: Professional,
Process Versions. Enterprise, Performance,
Unlimited, and Developer
4. Click New on the Milestones related list. Editions with the Service
5. Choose the milestone. Cloud

6. In Time Trigger (Minutes), enter the number of minutes in which users must
complete the milestone before it triggers an action. USER PERMISSIONS
Or, if youd like the trigger time for the milestone to be calculated dynamically based on the
To add milestones to
milestone type and properties of the case or work order, click Enable Apex Class for the Time entitlement processes:
Trigger (Minutes). Manage Entitlements
Note: You must have a custom Apex class that implements the
Support.MilestoneTriggerTimeCalculator Apex interface to use this
option.

7. If you selected Enable Apex Class for the Time Trigger (Minutes), use the lookup to specify an Apex class for the dynamically
calculated milestone.
8. Choose when the milestone starts:

Select To Use If
Milestone Criteria Calculate the milestone Target Date A milestones Target Date is based
when the milestone is applied to a support on when its applied to a record. Use if the
record (matches the record criteria). milestone is recurring.

Note: An entitlement process

usually starts when the record is
created, but its milestones arent
always applied right away.

Entitlement Process Calculate the milestone Target Date A milestone's Target Date is based
when the entitlement process starts (by on the start of the entitlement process. For
default, when a support record is created). example, first response and resolution
times on a case always calculate their
Target Date when the entitlement
process starts.

9. Optionally, select the business hours that you want to apply to the Target Date calculation for this milestone. If you dont specify
business hours for the milestone, then the Entitlement Process business hours are used. If neither are specified, then the business
hours on the case or work order are used.
10. Specify the order in which Salesforce should process the milestones. This applies to situations where a support record matches the
criteria of multiple milestones at the same time.

36
Enforcing Service Levels Add a Milestone Action to an Entitlement Process

11. Enter the criteria a record must match for the milestone to apply to it:
Choose criteria are met and select the filter criteria that a record must meet for a milestone to apply to it. For example,
set a case filter to Priority equals High if you want the milestone to apply to cases with the Priority field marked
High.
Choose formula evaluates to true and enter a formula that returns a value of True or False. Salesforce triggers
the rule if the formula returns True.

Choose formula evaluates to true and enter a formula that returns a value of True or False. The milestone
applies to records if the formula returns True. For example, the formula (Case: Priority equals High) AND
(Case: Case Origin equals Email, Web) applies the milestone to cases where the Priority field is High
and the Case Origin field is marked Email or Web. You cant use the Case Owner field in formulas.

12. Click Save.

Note: Milestones are measured in minutes and seconds, but their start and end times are only accurate to the minute. For example,
suppose a milestone is triggered at 11:10:40 a.m. and the time to complete the milestone is 10 minutes. In this case, the milestone
target time is 11:20:00 am, not 11:20:40. As a result, the remaining time for the agent to complete the milestone is 9 minutes and
20 seconds, not the full 10 minutes.

Add a Milestone Action to an Entitlement Process

Milestone actions are time-dependent workflow actions that occur at every step (milestone) in an
EDITIONS
entitlement process. After you create an entitlement process and add milestones to it, add milestone
actions to the milestones. Available in: Salesforce
1. From Setup, enter Entitlement Processes in the Quick Find box, then select Classic
Entitlement Processes.
Available in: Professional,
2. Click the name of an entitlement process. Enterprise, Performance,
3. Click the name of a milestone on the Milestones related list. Unlimited, and Developer
Editions with the Service
4. If you want to add a warning or violation action, add a time trigger first. After you add a trigger, Cloud
the option to add a workflow action appears. Success actions use the milestones time trigger.

Tip: If you want a violation action to fire immediately after the milestone is violated, set USER PERMISSIONS
the time trigger to 0 minutes.
To add milestone actions to
5. Click Add Workflow Action and select an option. entitlement processes:
Manage Entitlements
Workflow Action What It Does Example AND
New Task Create a workflow task Create a task for a support Customize Application
agent to call a customer when
a First Response milestone is
violated.

New Email Create an email alert Notify case owners when a

First Response milestone on
their case is near violation.

New Field Update Define a field update Update the case Priority field
to High when a First

37
Enforcing Service Levels Apply an Entitlement Process to an Entitlement

Workflow Action What It Does Example

Response milestone is near violation.

New Outbound Message Define an outbound message Send data about parts or services to an
external system after a First Response
milestone is completed.

Select Existing Action Select an existing action Use an existing email alert to notify a case
owner when their case is near violation of
a first response.

Note: Time-triggered actions only occur during your Salesforce orgs business hours. You can add up to 10 actions and 10 time
triggers to each type of milestone action.

Apply an Entitlement Process to an Entitlement

Youve created an entitlement process; now its time to use it! Apply an entitlement process to a
EDITIONS
customers entitlement so all support records linked to the entitlement use that process.
1. Go to the entitlement. Available in: Salesforce
Classic
2. In the Entitlement Process lookup field, select the process you want to apply.
Available in: Professional,
Important: If youre using entitlement processes, manage customers work orders and
Enterprise, Performance,
cases on separate entitlements. This is because an entitlement process only runs on
Unlimited, and Developer
records that match its type. For example, when a Case entitlement process is applied to Editions with the Service
an entitlement, the process only runs on cases associated with the entitlement. If a work Cloud
order is also associated with the entitlement, the process wont run on the work order.

3. Click Save. USER PERMISSIONS

Tip: If youve set up entitlement templates, you can associate an entitlement process with To edit entitlements:
a template so all entitlements created using that template automatically use the selected Edit on entitlements
entitlement process.

38
ENTITLEMENT VERSIONING

Updating an Entitlement Process

Entitlement versioning lets you create multiple versions of an entitlement process, even if its
EDITIONS
assigned to active entitlements and support records.
Watch a Demo (2:20 minutes) Available in: Salesforce
Classic
Use entitlement versioning if:
You want to make several versions of an entitlement process that have minor differences Available in: Professional,
Enterprise, Performance,
You want to update an entitlement process to reflect changes in your business processes Unlimited, and Developer
You might find that an entitlement process needs to be updated seasonally, or that you need to Editions with the Service
roll back to a previous version. Cloud

Note: To create multiple versions of entitlement processes, entitlement versioning must be

enabled in your org. Select Enable Entitlement Versioning on the Entitlement Settings
page in Setup.
When you create versions of entitlement processes with the same name, the version number
and notes help you differentiate between versions. Salesforce prevents you from disabling
entitlement versioning so you always know which version youre working with.

When you create a new version of an entitlement process, you can change any of the following:
Name
Description
Whether the process is active
Whether the version is the default
Entry criteria
Exit criteria
You can also add notes about the version. This makes it easy to differentiate between multiple versions of the same process, especially
if they have the same name.
On new versions of entitlement processes that are currently in use, you can add new milestones, but you cant edit existing ones. On
new versions of processes that arent currently in use, you can both add new milestones and edit existing ones.
Once you create a new version of an entitlement process, you can choose to apply it to all entitlements and support records assigned
to the previously used version, or only to new entitlements and support records. All versions of an entitlement process must be the same
type: Case or Work Order.

39
Entitlement Versioning Create a New Version of an Entitlement Process

Create a New Version of an Entitlement Process

Entitlement versioning lets you create multiple versions of an entitlement process, even if its
EDITIONS
assigned to active entitlements and support records. You can use multiple versions of an entitlement
process at the same time in your Salesforce org. Available in: Salesforce
Watch a Demo (2:20 minutes) Classic

Note: To create multiple versions of entitlement processes, entitlement versioning must be Available in: Professional,
enabled in your org. Select Enable Entitlement Versioning on the Entitlement Settings Enterprise, Performance,
page in Setup. Unlimited, and Developer
Editions with the Service
When you create versions of entitlement processes with the same name, the version number Cloud
and notes help you differentiate between versions. Salesforce prevents you from disabling
entitlement versioning so you always know which version youre working with.
USER PERMISSIONS
1. From Setup, enter Entitlement Processes in the Quick Find box, then select
Entitlement Processes. To create and update
entitlement processes:
2. Click the name of the entitlement process for which you want to create a new version. Manage Entitlements
3. In the Entitlement Process Versions list, click the version of the process from which you want
to create a new version.
4. On the Entitlement Process Detail page, click Create New Version.
5. Add details about the new version. Follow these best practices:
Use the Version Notes field to explain what makes the version youre creating different from others. This makes it easier
to differentiate between multiple versions of the same entitlement process.
Leave the name as is.
Click Active to be able to use the new version.
Click Default if you want to make the new version the default version of the process. This makes it easier to find in lookup field
searches.

6. Click Save.
After saving, you can modify the entitlement process milestones if needed.

Important:
On new versions of entitlement processes that are currently in use, you can add new milestones, but you cant edit existing
ones. On new versions of processes that arent currently in use, you can both add new milestones and edit existing ones.
All versions of an entitlement process must be the same type.

When you create a new version of an entitlement process, it isnt automatically applied to entitlements that were using the previous
version. To learn how to apply a new version of an entitlement process to existing and new entitlements, see Use a New Version of an
Entitlement Process.

40
Entitlement Versioning Use a New Version of an Entitlement Process

Use a New Version of an Entitlement Process

After you create a new version of an entitlement process, you can choose to apply it to all
EDITIONS
entitlements assigned to the previous version, or only to new entitlements. When you apply an
entitlement process to an entitlement, it also applies the process to that entitlements active support Available in: Salesforce
records. Classic
Watch a Demo (2:20 minutes)
Available in: Professional,
Note: To create multiple versions of entitlement processes, entitlement versioning must be Enterprise, Performance,
enabled in your org. Select Enable Entitlement Versioning on the Entitlement Settings Unlimited, and Developer
page in Setup. Editions with the Service
Cloud
When you create versions of entitlement processes with the same name, the version number
and notes help you differentiate between versions. Salesforce prevents you from disabling
entitlement versioning so you always know which version youre working with. USER PERMISSIONS

Applying an Entitlement Process to a New Entitlement To create and update

entitlement processes:
Scenario: Youre creating an entitlement and want to apply a particular version of an entitlement Manage Entitlements
process to it.
1. Choose the entitlement process you want in the Entitlement Process lookup field on the
entitlement.

Tip: After you click the lookup icon on the Entitlement Process field, select All Versions in the lookup dialog box. Otherwise, you
can only choose from the default versions of existing entitlement processes.
Applying an Entitlement Process to an Existing Entitlement
Scenario: You made a new version of an entitlement process, and you want to switch all the entitlements that were using the previous
version over to your new version.
1. From Setup, enter Entitlement Processes in the Quick Find box, then select Entitlement Processes.
2. Click the name of the entitlement process you want to work with.
The list on the main Entitlement Processes page shows the default version of each process. Click the name of a process to see a list
of all available versions of it.
3. On the detail page for the entitlement process, click the name of the new version that you want to apply to existing entitlements
(and by default, to cases or work orders linked to those entitlements).
4. Click New Update Rule.
5. Choose the version of the entitlement process you want to update from.
You can update from any other version of the process, whether or not its active.
6. Depending on the differences between the old and new versions of the entitlement process, updating an entitlement to the new
version can trigger milestone warning and violation actions on that entitlements support records (such as cases or work orders). To
avoid such warnings and violation actions, select Dont Trigger New Milestone Warnings and Violations. We recommend
selecting this so you dont trigger violation warnings on old entitlements and support records.
7. Click Save.
The update rule detail page shows the estimated number of entitlements and support records that will be updated to use the new
process.
8. Click Start to begin the update process.

41
Entitlement Versioning Use a New Version of an Entitlement Process

Usually the update process completes within an hour, but it depends on the number of entitlements and records being updated.
Throughout the update process, the update rule detail page refreshes periodically to show the number of entitlements and records
processed. To stop the update at any time, click Stop.
When the update rule displays a Completed status, all related entitlements and support records have been updated to use the new
version of the entitlement process. If the status is Completed With Exceptions, some records couldn't be updated to the new
version because of errors. To find out which records weren't updated and why, contact Salesforce Support.

42
LEARN MORE ABOUT ENTITLEMENT MANAGEMENT

Where to Learn More

You can find more helpful reference information about entitlement management features at help.salesforce.com.
Learn More About Entitlements
Search for these titles:
Entitlements
Guidelines for Working with Entitlements
Verify Entitlements
Entitlement Fields
Learn More About Service Contracts and Contract Line Items
Search for these titles:
Service Contracts
Guidelines for Working with Service Contracts
Service Contract Fields
Contract Line Items
Guidelines for Working with Contract Line Items
Contract Line Item Fields
Learn More About Milestones and Entitlement Processes
Search for these titles:
Milestones
Milestones: Supported Objects
Milestone Statuses
Milestone Actions
Milestone Recurrence Types
Entitlement Processes
How a Record Moves Through an Entitlement Process
How Business Hours Work in Entitlement Management

43