---
schema_version: "1"
id: b7e875828a5b505440ef740ebaf95a9346aca5d889ca24a1b9886adf4cd2eec4
title: setSoftphoneItemLabel() for Lightning Experience
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/api-cti/guides/sforce-api-cti-setsoftphoneitemlabel-lex.md
canonical_url: https://developer.salesforce.com/docs/service/api-cti/guide/sforce-api-cti-setsoftphoneitemlabel-lex.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 093acdc77f7c853dee6de46c8353d75a77ee457e5814c397f5132c615a8d240b
products:
  - Open CTI Developer Guide
  - Service Cloud Developer Content
---

# setSoftphoneItemLabel() for Lightning Experience

## Usage

Sets the label for the softphone component item in the utility bar. Returns `true` if the function is successfully executed, and `false` when there is a failure. This method is available in API version 38.0 or later.

The softphone label in the utility bar.

![Screen shot of softphone in utility bar.](https://developer.salesforce.com/docs/media/softphone_item_label_lex.png)

## Syntax

```javascript
sforce.opencti.setSoftphoneItemLabel({
     label: STRING, 
     callback:FUNCTION //Optional
});

```

## Arguments

|Name|Type|Description|
|------|------|-------------|
|`label`|string|The string you want to use for the softphone label in the utility bar.|
|`callback`|function|JavaScript method executed when the API method call is completed.|


## Sample Code–HTML and JavaScript

<!-- html set_clipboard -->
```html
<html>
  <head>
    <script type="text/javascript" src="https://domain:port/support/api//lightning/opencti_min.js"></script>
    <script type="text/javascript">
      var callback = function(response) {
         if (response.success) {
            console.log('API method call executed successfully! returnValue:', response.returnValue);
         } else { 
            console.error('Something went wrong! Errors:', response.errors);
         }
      };

      function setSoftphoneItemLabel() {
          sforce.opencti.setSoftphoneItemLabel({label: "MySoftphone", callback: callback});
      }
     </script>
  </head>
  <body>
    <button onclick="setSoftphoneItemLabel();">setSoftphoneItemLabel()</button>
  </body>
</html>

```

## Response

This method is asynchronous. The response is returned in an object passed to a callback method. The response object contains the following fields.

|Name|Type|Description|
|------|------|-------------|
|`success`|boolean|Returns `true` if the API method call was invoked successfully, `false` otherwise.|
|`returnValue`|object|This API method doesn’t return this object. The `returnValue` is always `null`.|
|`errors`|array|If the API call was successful, this variable is `null`. If the API call failed, this variable returns an array of [error messages](https://developer.salesforce.com/docs/service/api-cti/guide/sforce-api-cti-error-messages-lightning.md).|