In order to send agreements to your prospects for E-Signature, you will need to upload your PDF form into the CRM and map it to the lead. 

The mapping procedure consists of four steps:

1. Preparing your PDF form
2. Uploading your PDF application to the CRM
3. Mapping the PDF fields to the Lead fields
4. Testing the E-Sign process

In this article, we provide detailed instructions for completing each of the four steps using real-life examples.

There is also a video playlist that covers each part of the setup.

Note: You will need to have Adobe Acrobat or a similar PDF editing software in order to edit your PDF form fields. 

 

Step 1. Preparing Your PDF Form

Before you can start mapping your PDF forms to the lead, you will need to change the names of PDF checkboxes and some special fields (such as the signature and email fields) in order to conform to the CRM and Adobe E-Sign naming conventions. 

Your CRM supports the following four different types of field mappings:

1. Text-To-Text (lead text field mapped to a PDF text field)
2. Dropdown-To-Text (lead dropdown mapped to a PDF text field)
3. Checkbox-To-Checkbox (lead checkbox mapped to a PDF checkbox)
4. Dropdown-To-Checkboxes (lead dropdown options mapped to PDF checkboxes)

For the first three types of mappings, you don't have to make any changes in the PDF file.

For the Dropdown-To-Checkboxes mapping though, you will need to edit the PDF checkbox names using a special naming convention.

 

Dropdown-To-Checkboxes Mapping

To map the Lead dropdown options to PDF checkboxes, you’ll need to change the names of the PDF checkboxes so that they correspond to the correct Lead dropdown options.

To illustrate this procedure, we’ll use the Type Of Ownership lead dropdown and the PDF checkboxes that are being mapped to it:

 

Lead Dropdown:	PDF Checkboxes:

 

The first step is to open the lead dropdown options in order to expose the ID numbers for each menu option:  

 

  

Note: The option settings for any dropdown can be accessed from the Manage Lead Fields page. After you open the page, locate the dropdown field you wish to view and click Edit Field > Options. 

In the above example, we can see that the dropdown options have the following ID numbers:

 

Lead Dropdown Option	ID
(Please Select)	1
Sole Proprietorship	2
Limited Liability	3
Corporation	4
Partnership	5
Government	6
Non-Profit	7

 

Now that we've found the option ID numbers, we need to add them to the corresponding PDF checkbox names using the following naming convention: <group name>_<ID>

<group name> can be any name that you choose. All checkboxes that are being mapped to the same dropdown menu must have the same group name.

<ID> is the ID number of the dropdown option that we identified earlier.

Tip: It is possible to use underscore characters in the <group name>, however, the final underscore must always be placed right before the <ID> number. For example, Type_Of_Ownership_1 is a valid checkbox name.

Returning to our example, we can now rename the PDF checkboxes as follows:

 

Lead Dropdown Option	ID	New PDF Checkbox Name
(Please Select)	1
Sole Proprietorship	2	TypeOfOwnership_2
Limited Liability	3	TypeOfOwnership_3
Corporation	4	TypeOfOwnership_4
Partnership	5	TypeOfOwnership_5
Government	6	TypeOfOwnership_6
Non-Profit	7	TypeOfOwnership_7

 

Note that the first option in the dropdown menu ("Please Select") was intentionally not mapped to a PDF checkbox.

This is normally done so that the users may retain the option of NOT selecting any of the checkboxes in the PDF document (for example when none of the provided options apply to a client).

With this, we have successfully re-named the PDF checkboxes, and the checkbox group is now ready to be mapped to the lead dropdown (as described further down in this article).

 

Special Fields

Several text fields in your PDF file are special and must be renamed using a special naming convention. Here is a description of those fields:

 

Signature Fields

All PDF signature fields must be regular text fields and named using the following format: <custom name>_es_:signer1:signature

For example, a signature field may be named as First_Signer_es_:signer1:signature 

To enable multiple signers in your PDF application simply add multiple signature fields and increase each signer's number by one.

For example, here is how to name three signature fields for three different signers:

• First_Signer_es_:signer1:signature
• Second_Signer_es_:signer2:signature
• Third_Signer_es_:signer3:signature

 

Signer Email Fields

Your PDF application must contain at least one field for the primary signer's email address which is named using the following format: <custom name>_es_:signer1:email

For example, the email field may be named as First_Signer_es_:signer1:email 

If you're setting up an application for multiple signers, then you must add an email field for each signer. 

For example, here is how to name three email fields for three different signers:

• First_Signer_es_:signer1:email
• Second_Signer_es_:signer2:email
• Third_Signer_es_:signer3:email

Tip: If your form doesn’t have a field for email, you can put it directly under the Signature field.

Note: The primary signer's email is always pulled from the lead's email special field (even if you map the signer field to a different lead field).

 

Signer Initials

All signer initials fields must be regular text fields and named using the following format: <custom name>_es_:signer1:initials

For example, a signer initials field may be named as First_Signer_es_:signer1:initials

You can also add signer initials fields for multiple signers.

For example, here is how to name three signer initials fields for three different signers:

• First_Signer_es_:signer1:initials
• Second_Signer_es_:signer2:initials
• Third_Signer_es_:signer3:initials

 

Signature Date Fields

All signature date fields must be regular text fields and named using the following format: <custom name>_es_:signer1:date

For example, a signer initials field may be named as First_Signer_es_:signer1:date

You can also add signature date fields for multiple signers.

For example, here is how to name three signer initials fields for three different signers:

• First_Signer_es_:signer1:date
• Second_Signer_es_:signer2:date
• Third_Signer_es_:signer3:date

 

Each date field will show the date when the document was signed by a corresponding signer. 

To show the signed date in a specific date format simply append the formatting expression to the field name (shown in red color in the below example):

First_Signer_es_:signer1:date:format(date, "mm/dd/yyyy")

 

 

File Attachment Field

To have the signer attach files while signing the document, you can add a Text field in the PDF that becomes an upload button. Here's an example of the naming:

*File_es_:signer1:attachment:label("Voided Check")

• The asterisk(*) at the beginning indicates that uploading a file is required. If left off, the file upload will be optional.
• The text in the "quotes" is what will show to the signer, in this example. "Click to attach Voided Check".
• You can use multiple file upload fields in your document.
• When the document is signed, the file(s) attached will be appended to the document and everything will be saved as one file in the lead.

More info:  Enabling Attachment Uploads In E-Signature Apps

 

Additional Notes

Here are a few additional notes on the special fields in a multiple signers scenario: 

• All fields for the first signer should be set as required fields in the PDF. The fields for all other signers must be set as optional fields. In this way, you can ensure that there is always a minimum of one signer for your applications and a varying number of additional signers. 
• The signature, date, and initials special fields do not need to be mapped to the lead as these fields are either filled in by the signers or automatically by the system.
• Any field on the PDF form can be assigned to a specific signer. For example, to make the field First_Name fillable by the second signer only, add the suffix "_es_:signer2" to that field (the final field name will be "First_Name_es_:signer2"). 
• All required fields not assigned to a specific signer will need to be filled in by the first signer.
• Optional fields not completed by the first signer will be available and editable for the next signer.
• Fields completed by one signer are not editable by the next signer.
• The additional signer emails can be mapped to a lead field. The primary signer email does not have to be mapped since it will always default to the primary lead email field (the email special).
• In addition to the special fields listed above, you may also use additional fields that are supported by Adobe. More info: Adobe Sign Text Tag Guide
• The contact name for signers (e.g. Second_Signer_es_signer2:fullname) will be pulled from the Contact Field that is associated with that email field in the field's settings: 

 

After editing your PDF form in accordance with the above conventions your PDF will be ready to upload into the CRM.

 

Step 2. Uploading Your PDF Application

To upload your PDF application go to Manage > Administration > E-Signature > Import PDFs where you can create a new application or edit an existing one. 

For a detailed overview of this process please see our Manage Lead Applications article. 

 

Step 3. Creating Your Mapping

To create your mapping follow these steps:

1. Go to Manage > Administration > E-Signature > PDF Mappings.
2. Select the application you wish to map in the Choose Application dropdown.
3. Click Add All and a report will be generated showing all of your PDF fields on the left and all of your Lead fields on the right.

Your mapping page should now look similar to the below example:

 

 

To save a new mapping, locate the PDF field you wish to map on the left side of the report, and then select the corresponding Lead field on the right side.

For Dropdown-To-Checkboxes and Dropdown-To-Text field mappings you will need to set the MapSpecial option to Checkbox/Radio or Dropdown-to-text respectively.

 

 

If the lead field you are mapping is a part of a recordset, then you will also need to select the Record number. 

Here is an example of two recordsets with two First Name fields (one for each owner):

 

 

In order to map these two fields correctly, the Record numbers must be set as shown in this example:

 

 

 

After you finish editing the mapping settings click Save next to the mapping pair to save your changes.

 

Tip: In order to locate a lead field faster, click on the field selection dropdown and start typing the name of the field. The dropdown will then automatically display the closest matches which you can select:

 

 

Mapping examples

In this section, we provide examples of creating different types of field mappings using some of the most commonly used PDF and Lead fields.

 

Text-To-Text Mapping

To map the Corporate Address text field from the PDF to the Address text field on the Lead first find the Corporate Address field on your report, and then select the Address field using the dropdown on the right. When finished, click Save and the mapping will be saved.

The image below shows an example of how to map the Corporate Address PDF field to the Address field on the Lead correctly:

 

 

Dropdown-To-Text Mapping

To map the Title PDF text field to the Title dropdown menu on the Lead first find the Title field on your report, and then select the Title lead form field using the dropdown on the right.

After that, select the Dropdown-to-text option in the MapSpecial dropdown. Finally, click Save and the mapping will be saved.

The image below shows an example of how to map the Title PDF field to the Title field on the Lead correctly:

 

 

With the Dropdown-To-Text mapping, the PDF text field will show the actual text of the option that was selected on the lead form dropdown menu (for example Owner, President, CEO, Partner etc.).

 

Checkbox-To-Checkbox Mapping

To map the "Seasonal Merchant_yes" checkbox from the PDF to the "Seasonal Merchant" checkbox on the Lead first find the "Seasonal Merchant_yes" checkbox on your report, and then select the "Seasonal Merchant" lead form checkbox using the dropdown on the right. When finished, click Save and the mapping will be saved.

The image below shows an example of how to map the "Seasonal Merchant_yes" PDF field to the "Seasonal Merchant" field on the Lead correctly:

 

 

Dropdown-To-Checkbox Mapping

To map the TypeOfOwnership PDF checkboxes from the PDF (discussed earlier in this article) to the Type Of Ownership dropdown menu on the Lead first create a new Lead field called "TypeOfOwnership" (i.e. the name of your checkbox group).

Next, click on the Create Fields button, and in the pop-up which appears enter the name of your checkbox group (it is also possible to enter and create multiple group names all at once).

When finished, click on the Create Fields button in the pop-up and the new field will be created. Here is an image showing the TypeOfOwnership field being created:

 

 

Next, click on the Add All button (also shown in the above image) in order to show the newly created field in a report. Then find the TypeOfOwnership PDF field and select the Type Of Ownership Lead field using the dropdown on the right.

Finally, select the Checkbox/Radio option in the MapSpecial dropdown and click Save.

The image below shows an example of how to map the TypeOfOwnership PDF checkbox group to the Type Of Ownership dropdown on the Lead correctly:

 

 

Note that your mapping report will also show individual checkbox fields (e.g. TypeOfOwnership_2, TypeOfOwnership_3, TypeOfOwnership_4 etc.).

These fields don't need to be mapped, but instead, you will always only map the checkbox group name to the Lead dropdown, as shown in the above example.

 

 

 

Step 4. Test Your Application

Once your mapping has been completed, it is recommended that you generate a PDF copy of your application in order to verify that all of the fields have been mapped correctly and that the PDF file is showing the correct information across the entire form.

Before generating your test PDF, you should go to your lead form and enter some test data in all of the fields (as well as select random options in the available dropdowns and select any checkboxes that have been mapped).

When done, save the newly entered data using the Save button on the lead form.

Next, go to the Attachments tab, select your document (in this example it’s First Data) and hit the Generate button:

 

 

A PDF file will now be created and automatically downloaded to your disk.

You can now open the PDF file and compare the data and the checkbox selections in the PDF with the values you entered/selected on the lead form.

 

Cheat Sheets

The below cheat sheets provide you with a quick reference to the MapSpecial options you need to select in different mapping scenarios, as well as the rules for renaming the PDF fields or changing their settings.

 

PDF Mapping Cheat Sheets

This table shows the MapSpecial options that you need to select for each of the four supported types of mapping:

 

For This Mapping Type:	Select This In MapSpecial:
Text-To-Text	None (Default)
Dropdown-To-Text	Dropdown-to-text
Checkbox-To-Checkbox	None (Default)
Dropdown-To-Checkboxes	Checkbox/Radio

 

 

PDF Field Editing Cheat Sheets

This table shows the field naming and/or field setting rules for each supported type of PDF field:

 

To Map This PDF Field:	To This Lead Field:	Do This In PDF:
Text Field	Text Field	No special actions
Text Field	Dropdown	No special actions
Single Checkbox	Checkbox	Set Export Value to "Yes". Append "_yes" to checkbox name.
Checkbox Group	Dropdown	Set Export Value for all checkboxes to "Yes". Name all checkboxes as <group name>_<ID>

 

This table shows the field naming rules for the common special field types:

 

Special PDF Field:	Field Name Format:
Date	<custom name>_es_:signer1:date
Email	<custom name>_es_:signer1:email
Signature	<custom name>_es_:signer1:signature
Signer Initials	<custom name>_es_:signer1:initials

 

Note: Replace <custom name> with any test that you wish. The second part of the field name (which starts with _es_) should not be altered though. 

In case your document requires multiple signers, simply add additional signer fields and change the signer1 portion in the above examples to signer2, signer3, etc.

 

Legacy Special Fields

The following is a list of special fields that have will be deprecated in the future, but are currently still supported for backward compatibility. 

• email_es_signer_email
• first_es_signer_signature
• merchantinitials_es_signer_initials
• <custom name>.date (the date field needs to be mapped by selecting a custom date format in the MapSpecial dropdown and leaving the lead field dropdown unassigned)

 It is strongly recommended not to use these fields in any new applications.