---
schema_version: "1"
id: cb1c241a848f40f7c86d174f168182bb2f82a5a78e0a9b27dd06a6e415b90683
title: ServicePresenceStatus
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_servicepresencestatus.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_servicepresencestatus.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: de0014465ffd79a229728f65c4f212e140b2407698f95ca0a93f855612631623
description: Represents a presence status that can be assigned to a service channel. This type extends the Metadata metadata type and inherits its fullName field.
---
# ServicePresenceStatus

Represents a presence status that can be assigned to a service channel. This type extends the Metadata metadata type and inherits its fullName field.

## File Suffix and Directory Location

ServicePresenceStatus components have the suffix .servicePresenceStatus and are stored in the servicePresenceStatuses folder.

## Version

ServicePresenceStatus components are available in API version 44.0 and later.

## Special Access Rules

This type is available only if Omni-Channel is enabled in your org.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| channels | [ServiceChannelStatus](#ServiceChannelStatus) | Represents the service channels assigned to the presence status. If no service channels are included, the presence status is automatically marked as 'Away' (where IsAway is set to true.) |
| label | string | The label of the presence status. |

## ServiceChannelStatus

| Field Name | Field Type | Description |
| --- | --- | --- |
| channel | string | Represents the channels assigned to the presence status. |

## Declarative Metadata Sample Definition

The following is an example of a ServicePresenceStatus component.

<?xml version="1.0" encoding="UTF-8"?>
<ServicePresenceStatus xmlns="http://soap.sforce.com/2006/04/metadata">
    <channels\>
        <channel\>Case</channel\>
    </channels\>
    <label\>Available for Cases</label\>
</ServicePresenceStatus\>

The following is an example package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>\*</members\>
        <name\>ServicePresenceStatus</name\>
    </types\>
    <version\>44.0</version\>
</Package\>

## Wildcard Support in the Manifest File

This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).