---
schema_version: "1"
id: 2de57b0846af9eb21f53c346546dac063a464eb68cd1adca1c1733bc87fce1d9
title: Edit an OAuth Custom Scope
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/remoteaccess_oauth_customscopes_edit.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.remoteaccess_oauth_customscopes_edit.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 4d97c649c9109a9ca2501a6ff78e647f0f1241c61c7639075627c35970666691
description: You can change the name and description of a custom scope, and update your selection to include the custom scope in the OpenID Connect discovery endpoint.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Edit an OAuth Custom Scope

You can change the name and description of a custom scope, and update your selection to include the custom scope in the OpenID Connect discovery endpoint.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and
              Lightning Experience</td>
          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>External client apps can be created in: <strong>Group</strong>, <strong>Essentials</strong>, <strong>Professional</strong>,
                <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong>
                Editions
              </p>
              <p style="margin-bottom:0;">External client apps can be installed in: All editions</p>
            </td>
          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d83136e61">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d83136e61 ">To manage, create, edit, and delete OAuth apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d83136e61 ">Manage external client apps</td>
          </tr>
        </tbody>
      </table>

1. From Setup, enter Custom Scopes in the Quick Find box, and select **OAuth Custom Scopes**.
2. Find the OAuth custom scope to update, and click **Edit**.
3. Edit the custom scope’s values, as needed.
    
    - The name must be unique, begin with a letter, and include only alphanumeric characters and underscores. You can’t use spaces in custom scope names. The corresponding policy in your external entity must have the exact name as the custom scope.
    - The description must be unique, include only alphanumeric characters, and not be more than 60 characters. You can enter a custom label in place of a description. An advantage of custom labels is that you can maintain reusable text in a single location and translate the text into multiple languages. See [Custom Labels](https://help.salesforce.com/articleView?id=cl_about.htm&language=en_US).
        
        ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)
        
        Note The same description formatting requirements apply to the custom labels that are associated with custom scopes.
    - To include the custom scope in the external client app’s OpenID Connect discovery endpoint (`https://<your_domain_name>.my.salesforce.com/.well-known/openid-configuration`), select **Include on well known endpoint**.
4. After completing your edits, click **Save**.

#### See Also

- [Create an OAuth Custom Scope](https://help.salesforce.com/s/articleView?id=xcloud.remoteaccess_oauth_customscopes_create.htm&release=264.0.0&type=5 "To define permissions about the data that an external client app can access from an external entity, create an OAuth custom scope in Salesforce. The custom scope tells the external entity which information the external client app is authorized to access.")