Control Who Gets Read Access to Custom Settings

You can now control the visibility of custom settings at a granular level. Admins can grant direct read access to specific custom settings through profiles and permission sets for users without Customize Application permission.

Where: This change applies to Lightning Experience and Salesforce Classic in Professional, Enterprise, Performance, and Unlimited editions.

Who: Admins with the Customize Application permission can grant read access to specific custom settings through profiles and permission sets.

How: To grant a profile or permission set read access to specific custom settings, enable the Restrict access to custom settings org permission. Then enable access to specific custom settings.

  1. From Setup, search for Schema Settings and make sure that the Restrict access to custom settings org permission is enabled.
    Schema settings menu for restricting access to custom settings.

    This permission can also be enabled through the critical update: Require Customize Application permission for direct read access to custom settings.

  2. From Setup, search for Profiles or Permission Sets and click Custom Setting Definitions.
    Profiles menu for granting access to custom settings.
  3. Add the custom setting to the Enabled Custom Setting Definitions list.
    Enable custom setting definitions menu.
With Restrict access to custom settings enabled, permissions are enforced as follows:
  • Customize Application permission—Read and write access to all custom settings.
  • Custom Setting Definitions—Read access to specific custom settings outside of System context. Users must be granted access through profiles and permission sets.
  • View All Custom Settings permission—Read access to all custom settings outside of System context.
  • View Setup and Configuration permission—Read access to custom settings in Setup. Users must be granted access to specific custom settings through profiles and permission sets, or be granted the View All Custom Settings permission.