---
schema_version: "1"
id: c60a9023951faa6ae36f25313724699097c1e9cc3d70f349981165ccfd5b6862
title: Naming and Description Conventions
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/external_services_schema_def_naming_description.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.external_services_schema_def_naming_description.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: fb08072f96658a3c49da4f30dd762104b72ced8d26dd110a25cb392522dd48f5
description: Learn about support for component names and descriptions defined in your schema.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Naming and Description Conventions

Learn about support for component names and descriptions defined in your schema.

### 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: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

The operation name is derived from the schema's path `operationId`. If missing, it's derived from the HTTP method and resource path.

Implement case consistently for object name definitions, property names, parameter names, and field names in a schema.

The derived Apex class name and Apex object property names require valid Apex identifier characters. Ensure that the object name in the schema object definition section matches the naming convention and the object property names.

External Services can handle up to 1,333 characters for any optional description string used to describe operations and parameters in your JSON or YAML schema definition. If the description string exceeds this limit, External Services stores only the first 1,333 characters of the description. Truncating the operation or parameter description doesn’t affect the integrity of your schema definition.

#### See Also

- [Schema Examples](https://help.salesforce.com/s/articleView?id=platform.external_services_examples.htm&release=264.0.0&type=5 "Explore various scenarios with OpenAPI 2.0 and OpenAPI 3.0 compliant JSON or YAML schemas supported by External Services. The examples cover schema elements like HTTP header as input parameters, and include example usage in Apex. Understanding the examples helps with proper syntax and code placement.")
- [Apex Class Names and Developer Names](https://help.salesforce.com/s/articleView?id=platform.external_services_schema_def_apex_class_names.htm&release=264.0.0&type=5 "Learn how External Services derives Apex class names from your schema.")