Best practice to match a core Dropdown field between modules

Hi Tony ,

If you're referring purely to the use case of lead conversions, it is an easy code-level change to the ./custom/modules/Leads/clients/base/layouts/convert-main/convert-main.php file. In that file you can map any field from the lead record to another field in the account, contact, etc. For each module enabled for lead conversion, there will be a corresponding fieldMapping array. Locate the array for the module you want to update and add the new mapping to the bottom like the following:

'fieldMapping' => 
array (
  'name' => 'account_name',
  'billing_address_street' => 'primary_address_street',
  'billing_address_city' => 'primary_address_city',
  'billing_address_state' => 'primary_address_state',
  'billing_address_postalcode' => 'primary_address_postalcode',
  'billing_address_country' => 'primary_address_country',
  'shipping_address_street' => 'primary_address_street',
  'shipping_address_city' => 'primary_address_city',
  'shipping_address_state' => 'primary_address_state',
  'shipping_address_postalcode' => 'primary_address_postalcode',
  'shipping_address_country' => 'primary_address_country',
  'phone_office' => 'phone_work',
  'industry' => 'industry_c',
),

Chris

hi Chris Raffle 
I downloaded the Custom directory, and the path you mentioned doesn't see to exist?

and the convert-dashboard.php file has the following contents;

<?php
// created: 2025-10-03 14:00:50
$viewdefs['Leads']['base']['layout']['convert-dashboard'] = array (
  'components' => 
  array (
    0 => 
    array (
      'view' => 'product-catalog',
    ),
    1 => 
    array (
      'view' => 'product-quick-picks',
    ),
  ),
);

hi Chris Raffle 
I downloaded the Custom directory, and the path you mentioned doesn't see to exist?

and the convert-dashboard.php file has the following contents;

<?php
// created: 2025-10-03 14:00:50
$viewdefs['Leads']['base']['layout']['convert-dashboard'] = array (
  'components' => 
  array (
    0 => 
    array (
      'view' => 'product-catalog',
    ),
    1 => 
    array (
      'view' => 'product-quick-picks',
    ),
  ),
);

Hi Tony ,

Your screenshot is showing the ./custom/modules/Leads/clients/base/layouts/convert-dashboard/ directory which does not apply to this functionality. If you don't have the ./custom/modules/Leads/clients/base/layouts/convert-main/ directory, you should be able to generate it by going to Admin > Studio > Modules > Leads > Layouts > Convert Lead and then clicking 'Save'.

Regarding your question of Prospect > Lead conversions, this same method would not apply since there isn't a 'convert' layout to configure. When converting a prospect, Sugar redirects you to the standard lead creation flow with fields populated. If you want custom field mappings where the field names are not identical between the two modules to show during the conversion process, I believe you would need custom coding to achieve that outcome. If you are ok with having those custom field mappings populate after prospect conversion, you can achieve that with SugarBPM for some field types. 

Chris