---
schema_version: "1"
id: 28a7aef9b6e39179cc1fcd2191b3f2b618c3f4346c7154ac77ffb79817ebd9b0
title: Guidelines for Mapping Custom Lead Fields for Lead Conversion
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/sales/264-0-0/customize_mapleads_guidelines.md
canonical_url: https://help.salesforce.com/s/articleView?id=sales.customize_mapleads_guidelines.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f7cdc14a5beb46fd7dd3218c35ac83c1754cf79eca295f61cd8cb366bbef3137
description: Learn the best practices for mapping custom lead fields to custom fields in contacts, accounts, and opportunities. Mapping custom fields helps your sales reps retain that important information when they convert qualified leads to track new potential deals.
products:
  - Sales Cloud
release: "264"
---
# Guidelines for Mapping Custom Lead Fields for Lead Conversion

Learn the best practices for mapping custom lead fields to custom fields in contacts, accounts, and opportunities. Mapping custom fields helps your sales reps retain that important information when they convert qualified leads to track new potential deals.

### 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 and Salesforce Classic</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Starter</strong>, <strong>Essentials</strong>, <strong>Group</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, <strong>Pro Suite</strong>, and <strong>Developer</strong> Editions with Sales</td></tr></tbody></table>

- The following Lead custom field types can only be mapped to custom fields of the same data type.
    - Checkbox
    - Currency
    - Date
    - Date/Time
    - Email
    - Geolocation
    - Encrypted (Classic)
    - Number
    - Percent
    - Phone
    - Multi-select Picklist
    - Long Text
    - Rich Text
    - URL
- Each target field can have only one source field mapped to it.
- You can map auto-number fields to field types text or text area.
- You can map text and text area fields to custom field types of text, text area, long text, and picklist. If you map to a picklist field, the picklist must be unrestricted.
- You can map custom picklist fields to custom field types of text, text area, and picklist (unrestricted), but not long text.
- When mapping between picklist and text fields, your data truncates if the source field value is longer than the target field allows.
- Custom lookup fields can be mapped to a lookup field pointing to the same object. For example, a lead custom lookup field pointing to the Account object can be mapped to a contact custom lookup field that also points to the Account object.
- When mapping custom lead fields, the selected account, contact, or opportunity field must be of equal or greater length.
- You can’t delete lead, account, contact, or opportunity fields included in Lead Custom Field Mapping. To delete a field, first remove its mapping.
- You can’t change the field type of a field that’s included in Lead Custom Field Mapping. To change a field’s type, remove its mapping first.
- When you uninstall a package that references fields included in Lead Custom Field Mapping, those custom field mappings are deleted automatically.
- When mapping lead custom number, currency, or percent fields, the target field must have the same length and number of decimal places.
- If you have more than 2000 lead, account, contact, or opportunity fields in total, the lead field mapping page can become unresponsive. To improve performance, delete fields that aren’t in use. You can also use Metadata API, Salesforce CLI, or VS Code Extensions to manage your lead mappings.
- Dependent picklist fields on leads can’t have a default value assigned. These fields are driven from the value selected in the controlling picklist field. Field mappings defined between a controlling and dependent picklist are validated during lead conversion. These mappings don’t allow any values other than the current value of the controlling picklist to be assigned to the dependent picklist.
- In Lightning Experience and Salesforce Classic, custom field mapping for lead conversion is available in orgs that use APEX Lead Convert. Custom field mapping for lead convert is not available in orgs that use the older PLSQL Lead Convert.
- In orgs that use APEX Lead Convert, contact, account, and opportunity fields with field-level security settings are populated from mapped lead fields.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-sales_core-264-0-0-production-enus/3c339c40-ca6c-49ba-9c6e-684be7a55f80/images/icon_note.png)

Note Don’t map custom formula fields to other formula fields or any other type of field.