Back to Blog Tour Status

Mapping Salesforce to Mavenlink Project Custom Fields



Mavenlink's Salesforce integration gives you the ability to custom fields between Mavenlink and Salesforce projects. This can be helpful when many of your workflows are in Salesforce. This article outlines how to map custom fields from Mavenlink to Salesforce and vice versa.

How to Create a Custom Field in Salesforce

  1. Navigate to the Setup page.SFSetupButton.png
  2. In the Quick Find box, search for object. Under Build > Create, select Object. CreateMLProjCF.gif
  3. A list of Custom Objects displays. Find and select Mavenlink Project.SFMLProj.gif
  4. Under the Custom Fields & Relationships section, click New.SFMLProjectCF.png
  5. Specify the type of information the custom field will contain. The Salesforce types that can be synced with Mavenlink types are:
    • Number
    • Picklist
    • Text
    • Currency
    • Date
  6. Click Next.
  7. Give the custom Salesforce field a name.SFCF.png
    • Field Label The field name that shows up in displays, page layouts, reports, and list views.
    • Field Name The field name used for integration purposes, such as custom links, custom s-controls, and the API. This field auto-populates when you click outside of the Field Label box.
  8. Click Next.
  9. Select permissions for who can view and edit the field.SFTextCFSec.png
    • Visible — Enabled only for users who can edit the field.
    • Read-Only — Enabled for users who can view the field, but not edit.
      Note: Visible is auto-selected with this, but the user cannot edit when Read-Only is also enabled.
  10. Click Next.
  11. Select page layouts that should include this field.mceclip0.png
  12. Click Save. The new custom field is now created.
  13. Navigate to your Mavenlink Project in Salesforce and make sure it is there.VerifyNewSFCF.png

How to Map Your Mavenlink and Salesforce Custom Fields

  1. Navigate to Mavenlink Configuration > Custom Field Mappings.SFMLConfig.png
  2. Click Edit, and then Add Row.SFCFMappings.pngAddRow.png
  3. Leave the Subject Type as Project.
  4. Under Custom Field, enter the name of the Mavenlink custom field that you want to map to the new Salesforce custom field.SFMLCFMapping1.png
  5. Under Applicable Object Types, select the Salesforce object that initiates the creation of a project in Mavenlink.SFApplicableObjectTypes.png
    • Opportunity
  6. Under Custom Field Data Type, select the data type of the custom Salesforce field you created in the previous How to Create a Custom Field in Salesforce section.SFCFMappingDataType.png
  7. Under SalesForce Object, select mavenlink__Mavenlink_Project__c.SFCFMappingsSFObject.png
  8. Under SalesForce Field, select the custom field you just created. In this image, the newly created custom field is at the bottom of the list.2021-10-28_11-34-35__1_.gif
  9. Leave Custom Object Field Path empty.
  10. Select the Mapping Direction for your custom field.SFCFMappingsDirection.png The mapping direction is the direction the information is between Salesforce and Mavenlink.
    • Outbound: When you update the custom field in Salesforce, it will be synced in Mavenlink.
    • Inbound: When you update the custom field in Mavenlink, it will be synced in Salesforce.
    • Bi-Directional: Updates are synced both ways (not available for choice fields at this time)
  11. Leave Default Value empty, unless you want the custom field to have a default value.
  12. Select whether you want One Time Mapping, or consistent mapping.
    • Yes: Sets the custom field only upon project creation.
    • No: Consistently updates the custom field.
  13. Click Save. Your Mavenlink and Salesforce custom fields should be synced now.

    Note: New custom fields mappings are are not applied to existing projects unless the projects are synchronized through normal processing. To force an update on existing projects...

    1. Navigate to Mavenlink Configuration > Syncing.
    2. Stop the sync job by clicking on Cancel Current Job.SFCancelCurrentJob.png

    3. Backdate the Updated After date back far enough to apply to all projects.SFSyncing.png

    4. Click Save Sync Job.

How to Test Your Mappings

  1. Navigate to a Mavenlink project in Salesforce.VerifyNewSFCF.png
  2. Update your new Salesforce custom field.
  3. Click Sync with Mavenlink.
  4. Make sure your new custom field in Salesforce matches the mapped custom field in Mavenlink.

If you are still having issues with mapping your Salesforce and Mavenlink Project Custom Fields, please email


Related Articles

Created on