Field Mapping & Required Fields 

In this Article
Related Articles

About Field Mapping

The purpose of the field mapping process is to describe what information should be sent and where it should be stored in Salesforce.

You must first select an object to work with before fields are available to map. All required fields for the object will be shown automatically.

Mapping Options

Here you have four choices: a field in your form, a formula or text, a lookup result, or the ID of an object above.

  • A field in your form the default selection, so if that's where the value should come from, simply select the form field from the list.
  • Use the formula or text option if you have a formula that you'll use for the value, or if you want to submit a static value (for example, if you always want to use a certain Owner ID).
  • The lookup option can only be used after you've created a lookup step in the connector.
  • The ID option has to refer to an existing object, so it can't be used on the first object.

Map your form fields to Salesforce

  1. Select the Salesforce field from the These Salesforce Fields: list.
  2. Then, choose where the value will come from in the Get Their Value From: drop-down. Click OK, then map any additional fields by clicking the Map Another Field button. You'll notice that fields you've already mapped will be grayed out in the Salesforce field list.
Note: You can also use the Formula Editor to make inserting aliases easier. Use the  to launch the editor and begin inserting custom aliases from your form. 

Note: If you are mapping checkbox fields, you should use "TRUE" or "1" for checked and "FALSE" or "0" for unchecked. Please note that this is different than the prefill connector, which requires you to use lowercase "true" and "false"

Editing Field Mappings

In order to edit a field mapping you have already created, simply hover your mouse over the field you would like to edit and the Edit Mapping button will appear.

Navigating the Salesforce Submit Connector

When working with the Salesforce Submit Connector there are a few features to keep in mind that can help make your process easier.

Collapsing Connector Steps

If you find yourself working with multiple objects in your connector, it may be helpful to collapse certain steps that you are not working with currently in order to free up space on your screen.

This can be done by clicking the small triangle next to each connector step. To re-expand the step, simply click the triangle again.

Adding a Comment

At times it can be helpful to add a comment to a step in a connector. This could be a short summary on the purpose of the step, a reminder note yourself about the mappings, or anything you would like to make note of.

To add a comment to a step in the connector, hover your mouse over the triangle drop down menu next to "Edit" and click "Add a Comment."

You'll then be able to add a comment at the top of the connector step in order to document your setup. You can also choose to delete the comment later if you'd like to by clicking the Delete Comment button at the top right.

Copying an Object

You might also find it useful to make a copy of an object you have already created, so that you can use the mappings you have previously setup, rather than starting from scratch.

To do this, hover your mouse of the triangle dropdown menu next to "Edit" and select the "Copy Object" button. Once you click the button, a copy of the object will appear directly below the object you have just created. After you new object has been created, you can choose to Reorder Objects at the bottom of the connector if you would like to change the order of steps.

Note: You cannot use this feature to copy an object from one connector to a different connector. The only way to accomplish this is to make a copy of your form, which will copy your connector setup by default.

Removing an Object

If you ever need to remove an object in your connector, you can hover your mouse over the triangle dropdown menu next to the "Edit" button and select Remove Object.

Accessing the Connector Logs

The Connector Logs can be an incredibly helpful tool for troubleshooting errors and monitoring how your connector is functioning. These logs can be accessed from the "Go To..." dropdown menu at the top right of the connector. This article provides additional details on using and reading the connector log.

This link can also be used to view your Salesforce Objects, Get New Salesforce Objects (in case you've made any updates to your Salesforce records), view our documentation, and view the field aliases for the form. 

Terms of Service · Privacy Policy