Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Enable Dev Hub Features in Your Org
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Track Changes Between Your Project and Org
Development
Develop Against Any Org
Assign a Permission Set
Ways to Add Data to Your Org
Create Lightning Apps and Aura Components
Create Lightning Web Components
Create an Apex Class
Create an Apex Trigger
Create a Custom Object
Execute Anonymous Apex
Run Apex Tests
Build and Release Your App
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Assign a Permission Set

After creating your scratch org and deploying the source, you must sometimes give your users access to your application, especially if your app contains custom objects.
  1. If needed, create the permission set in the scratch org.
    1. Open the scratch org in your browser. 
      1sf org open --target-org <scratch org username/alias>
    2. From Setup, enter Perm in the Quick Find box, then select Permission Sets.
    3. Click New.
    4. Enter a descriptive label for the permission set, then click Save.
    5. Under Apps, click Assigned Apps | Edit.
    6. Under Available Apps, select your app, then click Add to move it to Enabled Apps.
    7. Click Save.
  2. Retrieve the permission set from the scratch org to your project. 
    1sf project retrieve start --target-org <scratch org username/alias>
  3. Assign the permission set to one or more users of the org that contains the app: 
    1sf org assign permset --name <permset_name> --target-org <username/alias>

    The target username must have permission to assign a permission set. Use the --on-behalf-of flag to assign a permission set to non-administrator users.

    1sf org assign permset --name <permset_name> --target-org <admin-user> --on-behalf-of <non-admin-user>
You can also assign permission set licenses to users using the org assign permsetlicense command. It works similarly to the org assign permset command.