---
schema_version: "1"
id: 91f464eb1ed46468a9391cd0a745ae9af991656f6e473c42d59cbe4a8fee1636
title: PathAssistant
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_pathassistant.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_pathassistant.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 031f3621058b2e8e9c70334732f36a37e7d0cda4777920b90fa13216067eb6a1
description: Represents Path records.This type extends the Metadata metadata type and inherits its fullName field.
---
# PathAssistant

Represents Path records.This type extends the Metadata metadata type and inherits its fullName field.

![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Note the following when working with PathAssistant:

- Only one path can be created per record type for each object, including \_\_Master\_\_ record type.
- Rich text guidance information cannot be retrieved or deployed from or to translation workbench.
- The preference does not need to be on to retrieve or deploy PathAssistant.

## File Suffix and Directory Location

PathAssistant components have the suffix .pathAssistant and are stored in the pathAssistants folder.

## Version

PathAssistant components are available in API version 34.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| active | boolean | Indicates whether the path is active (true) or not (false). |
| entityName | string | Required. The entity name. This is hard coded for Opportunity, Lead, and Quote. For a custom object, this field must be specified and should be the name of the custom object. This field is not updateable. |
| fieldName | string | Required. The field name. This is hard coded for StageName and Status. For a custom object, this field must be specified and should be the name of the picklist field that determines the steps in the path. This field is not updateable. |
| masterLabel | string | Required. The label of the path. |
| pathAssistantSteps | [PathAssistantStep](#SubTypeID) | List of all the steps that have been configured with fields and guidance information. Note that a missing step in the .xml file means it has not been configured, not that it doesn’t exist. |
| recordTypeName | string | Required. The name of the record type associated with the path. This field is not updateable. |

## PathAssistantStep

Represents the steps or stages in a Path.

| Field Name | Field Type | Description |
| --- | --- | --- |
| fieldNames | string | All the fields in entityName that will display in this step. |
| info | string | The guidance information displayed in this step. |
| picklistValueName | string | Required. The picklist value associated with the step. |

## Declarative Metadata Sample Definition

The following is an example of a PathAssistant component.

<?xml version="1.0" encoding="UTF-8"?>
<PathAssistant xmlns="http://soap.sforce.com/2006/04/metadata">
    <active\>true</active\>
    <entityName\>Opportunity</entityName\>
    <fieldName\>StageName</fieldName\>
    <masterLabel\>Test Path</masterLabel\>
    <pathAssistantSteps\>
        <fieldNames\>Amount</fieldNames\>
        <fieldNames\>CloseDate</fieldNames\>
        <info\>Some Text</info\>
        <picklistValueName\>Id. Decision Makers</picklistValueName\>
    </pathAssistantSteps\>
    <pathAssistantSteps\>
        <fieldNames\>Amount</fieldNames\>
        <fieldNames\>CloseDate</fieldNames\>
        <info\>Some Text</info\>
        <picklistValueName\>Proposal/Price Quote</picklistValueName\>
    </pathAssistantSteps\>
    <recordTypeName\>Test\_Record\_Type</recordTypeName\>
</PathAssistant\>

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\>Opportunity.Test\_Busines\_Process</members\>
        <name\>BusinessProcess</name\>
    </types\>
    <types\>
        <members\>Opportunity.StageName</members\>
        <members\>Lead.LeadSource</members\>
        <members\>Opportunity.Type</members\>
        <name\>CustomField</name\>
    </types\>
    <types\>
        <members\>Test\_Path</members\>
        <name\>PathAssistant</name\>
    </types\>
    <types\>
        <members\>Opportunity.Test\_Record\_Type</members\>
        <name\>RecordType</name\>
    </types\>
    <types\>
        <members\>PathAssistant</members\>
        <name\>Settings</name\>
    </types\>
    <version\>68.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).