I am struggling to figure out how to -- or if it's even possible to -- create a DX scratch org with the "Field Service Lightning" (FSL) feature installed. Based on the feature list here I'm guessing the answer is no and I'll just have to wait. But I'm not sure I'm interpreting that source correctly or missing something entirely since I'm just wrapping my head around DX.

Background: we have a production org with FSL installed and active, along with it's accompanying managed packages. I can create sandboxes from it and do development using standard Metadata API tools, but I was hoping to start a new project using DX. But I'm stuck configuring a scratch org with the proper features.


I heard from the DX team that as of today (October 2017), this is not possible, as I suspected. However, I was told that it is possible via a new process called "shape orgs", which is currently in pilot.

  • Do we know when shape org will be GA? – Mystery Jul 2 '18 at 9:13
  • No, no new information since the Spring '18 release notes, which stated: "Org Shape for Scratch Orgs Pilot Has Been Suspended. Removed information regarding how to sign up for the Org Shape for Scratch Orgs pilot. Due to outstanding bugs, we aren’t accepting any new pilot participants." – ArtieBrosius Jul 2 '18 at 14:38
  • FWIW - FSL is still not working in my "preview" Winter '20 scratch org. I can turn it on manually after creating the org. I do not know of a method programmatically – bkwdesign Sep 20 '19 at 15:50

Salesforce has updated their syntax for some features. This is now possible if you specify the feature, values for those features, and settings in your project-scratch-def.json file like so:

    "features": ["FieldService:1"],
    "settings": {
        "fieldServiceSettings": { "fieldServiceOrgPref": true }

This allocates 1 Field Service Lightning license to your scratch org.

You can find the list of features and values at the Salesforce documentation here.

  • You can also automate to further install the Field Service managed packages after you create a scratch org with with the above scratch definition: sfdx force:package:install --package [pacakge id] --apexcompile package --securitytype AllUsers --noprompt --wait 15 -u [org alias] using these ids: 04t0M000001i20fQAA (FSL Package) - 04t1R0000016YZtQAM (Salesforce Field Service App Package) – Christian Menzinger Jan 13 '20 at 14:21
  • Using the markup above in my projectc-scratch-def.json gives me the following error: The feature value FieldService requires a quantity. – bkwdesign Jan 29 at 4:28
  • 1
    @bkwdesign I have edited my answer to reflect the updated syntax. You just have to provide a value with field service to tell it how many licenses you want. – Kyle Feb 1 at 21:52
  • Thank you @Kyle. I saw this in the SF docs but didn't have the reputation here to edit your anwer. I'm noticing your SF architect credentials. Would you mind augmenting either your answer, or simply here in the comments: What the need is for a number of licenses? As a dev-head who is not as connected to the functional side of things as much, I can't understand why my scratch org that is meant for trying things out needs to trifle with this detail. Isn't licensing a production concern? – bkwdesign Feb 2 at 18:38
  • 1
    @bkwdesign Starting to get into 'outside of the scope of this question' territory but I'll bite. Scratch orgs can be used as a part of the dev lifecycle instead of a standard dev sandbox. In the case where you have a complicated scenario requiring two users with field service licenses on different profiles, as an example, it would be beneficial to be able to completely model the scenario in your scratch org while developing rather than relying on approximations. – Kyle Feb 3 at 20:22

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.