Hello, I am working on a Docusign Webform connected to a template and I’ve run into an issue with field mapping. Specifically my Webform includes a “Phone Number Field” which is required under recipient connections (this is the phone number field type in webforms), but when I try to map it to a field on my template, it does not link. I believe this is because the phone number type field on the webform does not connect to a text field on a template. When I looked the template does not have a phone number validation field. I have confirmed:the recipient roles match between the webform and template Other text and email fields map correctly between the webform and template The issue only occurs with the webforms “phone” type field. Could you confirm if the webforms “phone” fields are supported for mapping to template fields? If not, what is the recommended approach to solve this? If I replace the webform phone field with a text field, it will no longer map to my recipient connections under webforms which is required. Thank you, Ally

Hello @a.21.klaThank you for reaching out, and welcome to the Docusign Community! We appreciate your question and assure you that we are fully committed to providing you with the best service possible.Phone number fields are for stand-alone web forms only, not those tied to a template/envelope. For your reference, you may check this article:Add or Edit Properties for a Web Forms Phone Number Field.Your recipients can add a phone number, including the country calling code, to a form. The country calling code is a string of 1, 2, or 3 numeric digits representing the country or region where the phone number is assigned. It displays on the form as a default.Note:You can add the Phone Number field to a standalone form, but you can't add it to a template-based form.You can add the Phone Number field and add or edit the country calling code using the following procedure.Create a standalone form or select one from theWeb Formslist.Add thePhone Numberfield to the web form.ThePhone Numberfield properties display on thePropertiestab.Enter a descriptive name in theField namefield.Enter a description or instruction in theField descriptionfield. This description displays on the field. For example:To make the field Required, select theRequired fieldtoggle.TheRequired fieldchanges color and an asterisk (*) displays on thePhone Numberfield in the center panel. Make the field optional by selectingRequired fieldagain. The asterisk disappears.To make the field read only, select theRead Onlytoggle.Select a default country calling code for thePhone Numberfield, if necessary. For example, the country code for the United States is "+1". At theDefault valuefield:Select the down-arrow in the field.In theSearchfield, begin typing the country name to select the country calling code.The default country calling code is saved to the web form. If necessary, the recipient can modify it when they complete the form.Save the web form.If you found the response to be a useful solution to your question, please “like” and mark it as the best answer by clicking “Select as Best” to make it easier for other users to find. Thank you!Sincerely,Ma. Cassandra | Docusign Community ModeratorIf this helped, feel free to Like👍and click "Best Answer"

Question

Webform Phone Number Field Not Mapping to Template

Forum|Forum|3 months ago
August 20, 2025
6 replies
62 views

a.21.kla
New Voice

Hello,

I am working on a Docusign Webform connected to a template and I’ve run into an issue with field mapping. Specifically my Webform includes a “Phone Number Field” which is required under recipient connections (this is the phone number field type in webforms), but when I try to map it to a field on my template, it does not link. I believe this is because the phone number type field on the webform does not connect to a text field on a template. When I looked the template does not have a phone number validation field.

I have confirmed:

the recipient roles match between the webform and template
Other text and email fields map correctly between the webform and template
The issue only occurs with the webforms “phone” type field.

Could you confirm if the webforms “phone” fields are supported for mapping to template fields? If not, what is the recommended approach to solve this? If I replace the webform phone field with a text field, it will no longer map to my recipient connections under webforms which is required.

Thank you,

Ally

+13

Ma.Cubio
Community Moderator
Forum|Forum|3 months ago
August 21, 2025

Hello @a.21.kla
Thank you for reaching out, and welcome to the Docusign Community! We appreciate your question and assure you that we are fully committed to providing you with the best service possible.

Phone number fields are for stand-alone web forms only, not those tied to a template/envelope. For your reference, you may check this article: Add or Edit Properties for a Web Forms Phone Number Field.

Your recipients can add a phone number, including the country calling code, to a form. The country calling code is a string of 1, 2, or 3 numeric digits representing the country or region where the phone number is assigned. It displays on the form as a default.

Note: You can add the Phone Number field to a standalone form, but you can't add it to a template-based form.

You can add the Phone Number field and add or edit the country calling code using the following procedure.

Create a standalone form or select one from the Web Forms list.
Add the Phone Number field to the web form.

The Phone Number field properties display on the Properties tab.
Enter a descriptive name in the Field name field.
Enter a description or instruction in the Field description field. This description displays on the field. For example:
To make the field Required, select the Required field toggle.
The Required field changes color and an asterisk (*) displays on the Phone Number field in the center panel. Make the field optional by selecting Required field again. The asterisk disappears.
To make the field read only, select the Read Only toggle.
Select a default country calling code for the Phone Number field, if necessary. For example, the country code for the United States is "+1". At the Default value field:
1. Select the down-arrow in the field.
2. In the Search field, begin typing the country name to select the country calling code.
  The default country calling code is saved to the web form. If necessary, the recipient can modify it when they complete the form.
Save the web form.

If you found the response to be a useful solution to your question, please “like” and mark it as the best answer by clicking “Select as Best” to make it easier for other users to find. Thank you!

Sincerely,

Ma. Cassandra | Docusign Community Moderator
If this helped, feel free to Like👍and click "Best Answer"

a.21.kla
Author
New Voice
Forum|Forum|3 months ago
August 22, 2025

How do I connect the phone number field on my webform to my template?

+13

Ma.Cubio
Community Moderator
Forum|Forum|3 months ago
August 22, 2025

Hello @a.21.kla
Instead of using the Phone number field in your template, you may use the Number field or the Text field on the right-click “validation”, click the dropdown, and click custom. This will let you enter a line of code.
Here is the code for the phone number.

^(\$[0-9]{3}\$|[0-9]{3}-)[0-9]{3}-[0-9]{4}$

For more details on how to work with Data Validation and how to set Custom Data Validation, see:

Data Validation for Text Fields

Custom data validation

Ma. Cassandra | Docusign Community Moderator
If this helped, feel free to Like👍and click "Best Answer"

a.21.kla
Author
New Voice
Forum|Forum|2 months ago
September 2, 2025

The recipient connections under the webform require it to be a phone number field type, but the template does not allow for it. How can I map my webform phone number field to both recipient connections and the template without having to add two phone number fields?

+13

Ma.Cubio
Community Moderator
Forum|Forum|2 months ago
September 2, 2025

Hello @a.21.kla
Have you tried editing your template and using either the “Text” or “Number” field before uploading it to the webform?

Sincerely,

Ma. Cassandra | Docusign Community Moderator
If this helped, feel free to Like👍and click "Best Answer"

+13

Ma.Cubio
Community Moderator
Forum|Forum|2 months ago
September 19, 2025

Hello @a.21.kla

How are you? I'm checking in to see if you still need assistance. If yes, kindly reply here with more context or confirm if the issue has been resolved.

If you run into any problems, we're happy to help with those here. Wishing you a smooth rest of your day!

Sincerely,

Ma. Cassandra | Docusign Community Moderator

If this helped, feel free to Like👍and click "Best Answer"

Sign up

You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.

Docusign Community

You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.

Scanning file for viruses.

This file cannot be downloaded