A signable web form can be created to embed on your website (or send as a web link), allowing multiple people to easily access your form or document and create an agreement.

A web form can be configured to have one or more participants, multiple counter-signers, and multiple CC'd parties as well. The signature flow for a web form is:

  • An agreement is created once the first participant completes and verifies their signature/action
    • If the web form allows for multiple participants, all partricipants will complete their action on the agreement in the order they are listed
  • After the participants have completed their actions, the counter-signers are notified in the order they are listed
  • Once the agreement is completed, all parties (including CCs) are notified of the completed agreement

Create a web form

  1. From the Home page, click Publish a web form 

    Create Web forms
  2. On the Create a web form page, enter the Web Form Name

    • You cannot edit the name of a web form once created, so make sure it's named correctly
    • If you add a file without setting the web form name, the web form will adopt the name of the file
  3. Configure the experience for the first participant:

    (The first participant is the person that initially interacts with the web form. In the case where multiple participants are allowed, the first participant supplies the email addresses for all subsequent participants.)

    • Participant Role:
      • Signer - Signers must apply a signature in addition to any other fields that are required
      • Approver - Approvers can fill fields, but are not required to apply a signature
      • Acceptor - Acceptors, like Approvers, can fill field content but are not obligated to provide a signature
      • Form Filler - Form Fillers can only fill fields, and may not have a signature field applied to them
    • Authentication:
      • None - This option uses only the email verification after the web form is submitted (If configured to do so)
      • Password - The password option requires that the recipient enter a password before they can view the document
      • Knowledge-based Authentication (KBA) - KBA can be enabled as an authentication method if your account is configured to allow unlimited KBA transactions. Keep in mind that KBA is only valid in the United States


    Adobe Sign Authentication and Government ID are not supported for web form authentication.

    Roles and authentications
  4. (Optional) Add Participant

    Clicking the Add Participant link adds an additional participant to the web form.

    • Additional participants are defined by the first participant who will supply all email addresses for the subsequent participants
      • Instructions can be provided via the template to guide the first participant
    • Additional participants can be optional or required
    Add additional participants


    • Add Participant - The Add Participant link allows for the addition of one or more subsequent participants (Participant 2, Participant 3, and so on) that are to be defined by the first participant
      • Clicking the link adds another Participant line to the page
      • Additional Participant can be optional or required
        • If optional, Participant 1 is requested to assign the next participant. If no new participant is identified, the signature flow moves to the counter-signers (if any)
        • If required, Participant 1 is required to provide a name and email address for Participant 2 to progress the agreement. If they do not, the agreement stalls at this point
      • Participant 2 is configured the same as Participant 1
        • Participant 2 has two additional roles that can be assigned: Certified Recipient and Delegator

    When Participant 1 has completed their required actions and clicks Submit, they are prompted to Assign the next participant:

    • Participant 1 is requested to provide the name and email address of Participant 2
      • Adding Participant 2 then allows for the option to add Participant 3 and so on...
    • If Participant 2 is included, Participant 1 must first verify their email address before the system notifies Participant 2
    Request to identify Participant 2
  5. If you want your web form to be counter-signed:

    • Enter the email addresses of the parties you want to counter-sign or approve the agreement under the Counter-Signers section:
      • You can include yourself (the creator of the web form) by clicking the Add Me link on the right
      • Configure the appropriate Role for each recipient. All roles enabled by the admin will be available
      • Define the correct authentication method for each counter-signer
      • All defined counter-signers need to complete their signature/approval in the order you list them for the agreement to complete


    Keep in mind, the counter-signers will always be the final signers. The process always starts with the individual who visits the web form.

  6. Drag and drop the files you want to use as a the base for your web form into the Files section, or click Add Files, and navigate to the document on any networked drive or integrated file storage.

    Existing Libary templates can also be imported (with authored fields intact).

  7. Configure the Options 

    • Password Protect - If you would like to apply a password to open the final PDF produced by the web form signing, check this box.  You will be prompted for the password
    • Recipient's Language (Business and Enterprise service levels only) - This setting will dictate the language used for the on-screen instructions, as well as the email notifications related to the web form
  8. Check the Preview & Add Signature Fields option, and then click Next.

    Create a web form page - exploded
  9. The page will refresh and display the uploaded files in the Authoring environment.

    Drag the necessary fields from the right side of the page, on to the document as needed.

    Make sure that you place at least one signature for each signer, including the initial participants and all counter signers.

  10. Once all of the fields are placed, click the Save button in the bottom-right corner.

    Place fields
  11. You'll arrive at the web form post creation page. Here you can get the URL to the web form, and the iframe/JavaScript code you can use to embed it.

    You can also test sign your web form.


To insert values into a web form field, there are two things you need to know:

  • How to mark a field as available for URL parameters
  • How to construct the URL parameters to be inserted


How to mark a field as available for URL parameters

To make a field available for URL parameters:

  1. Create or edit a web form to gain access to the fields

  2. Add the text field you want to populate through the URL

    •  Only Text fields can accept values
  3. Open the properties of the field by double clicking it

  4. Edit the field name to something meaningful. The field name is the first part of the parameter you will use, so shorter is usually better

  5. Check the box that says Default value may come from URL

    • Optionally check the Read Only box if you don't want the value to be editable
  6. Click OK to save the parameters

  7. Repeat for all fields that will need to accept a parameter from the URL

  8. Click Save to save the web form


In this example we are creating two fields to be filled by the URL:

  • Branch_Office - A field that accepts the branch office string (shown above)
  • Emp_ID - A field that accepts the employee ID


How to construct the URL parameters to be inserted

An easy way to construct the URL is to:

  1. Copy the URL from the web form. The easiest way to do this is to:

    • Edit the web form from the Manage page
    • Click the Copy Web Form URL link

    Web form URLs are very long, so an abbreviated one is used here for an example (yours will look different):

    Example URL:


  2. Paste the web form URL into a text editor (like Notepad)

  3. Add your parameters  

    • The start of the parameters are identified by adding a hash (pound, #) symbol at the end of the web form URL.
    • Then add the parameters in the format of  {field_name}={value} 

    Example URL with one parameter

    https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621

    • Multiple values are added by inserting an ampersand (&) between field values.

    Example URL with two parameters

    https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

  4. Once all of the field=value pairs are added to the URL, copy the full string and paste it into your browser.

    The web form will render with the fields populated:


Properties and Limitations

  • You only use the hash mark once to define the beginning of the paramater(s)
    • Using a subsequent hash mark in a value does not negatively impact the result
  • Using spaces in values is acceptable
  • Using spaces in the field name is only acceptable if you explicitly insert %20 as the space character in the URL
    • This will work: https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • This will not work: https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • It is generally recommend that an underscore be used in field names instead of spaces. It will ultimately save you time
  • There is no space allowed between the Field Name, the equals mark, and the beginning of the value (Fieldname=Value)
  • No space to either side of the ampersand if you have multiple values
  • There is no limit (other than perhaps URL length limits) to the number of fields that can get their value from URL parameters
  • Calculated text fields can not be overridden and do not have the checkbox displayed in their field properties.
  • URL parameters do not work with authenticated web forms. Due to the use of URL Hash Fragments, if a web form is protected via a password or other authentication, the URL parameters are not passed back to the client after authentication is complete (the server never sees that part of the URL). 


Error handling

  • Any URL parameter that does not match a form field name exactly is ignored
  • Any URL parameter that tries to assign a value to a non-text field or a text field that does not have Default value may come from URL enabled is ignored

Setting the dimensions of a web form requires a bit of knowledge of HTML, but the process is simple. This process allows you to customize how the web form fits on your web page.


This procedure only applies to the JavaScript code for a web form.

  • URL web forms cannot be resized.

By default, a web form's height and width scale with the size of the browser. This dynamic property makes it so the web form can be viewed in most screen resolutions.

default web form window size

To adjust the dimensions of the web form, add a style <div> to the code surrounding your web form. This step is done with HTML, making the widget frame appearance fully customizable.

The code for the web form appears below, as provided by clicking the corresponding get code link on the Manage page:

<script type='text/javascript' language='JavaScript' src='https://secure.echosign.com/public/embeddedWidget?wid=2AAABLblqZhCb3ZNyEbi1ywHYaBw893IPRafJOjVvgE44n4Kb36XRArp5QgTpBhUWhLa7x81ek18*'></script> 


To adjust the size, add the following code before the web form code. This code sets the width to 500 pixels and the height to 600 pixels.

The border for the web form frame can also be adjusted by changing the border properties.

<div style="height:500px; width:600px; border:1px solid black;">


The code to put in the website that hosts the web form follows:



<div style="height:500px; widget:600px; border: 1px solid black;">


<script type='text/javascript' language='JavaScript' src='https://secure.echosign.com/public/embeddedWidget?wid=2AAABLblqZhCb3ZNyEbi1ywHYaBw893IPRafJOjVvgE44n4Kb36XRArp5QgTpBhUWhLa7x81ek18*'>


Resized web form

As you can see, the resulting web form is displayed with the stated dimensions.

Obviously, these dimensions aren't ideal, but it shows how setting the height and width values affects the posted web form.

Full screen 1

<body style="margin: 0; padding: 0;">

<script type='text/javascript' language='JavaScript' src='https://secure.echosign.com/public/embeddedWidget?wid=[yourwidgteId goes here]'>



Full screen 2

<div style="height:100%; width:100%; border:0px solid black;">

<script> </script>


Disable a web form

When you disable a web form, it is longer accessible by signers, but is visible in your account. You can re-enable the web form under your authority at any time.

To disable a web form:

  1. Click the Manage tab

  2. Select the Web Forms filter

  3. Single-click the web form you want to disable

  4. Click Disable

    • An options window pops out
  5. Select the experience that you want to provide for any user that attempts to access the web form URL

    • Redirect signers to another web page - You can redirect the signers to another web page, like a current version of the web form
    • Enter a custom message to signers - You can enter a message that will be displayed in place of the web form
      • You can add hyperlinks to the message by enclosing them in brackets [ ]
      • You can add labels by using the | (pipe) symbol after the URL

    e.g: [https://www.sign.adobe.com/ | Adobe Sign] displays as Adobe Sign.

  6. Click Disable

    • A success message is displayed
    • The status changes 
    • The redirect method is inserted under the status
    • The ability to edit the web form is removed

Enable a web form

Disabled web forms can be re-enabled at any time and resume function.


To enable a disabled web form:

  1. Click the Manage tab 

  2. Select the Web Forms filter

  3. Single-click the web form you want to enable

  4. Click the Enable button 

  5. Click Enable when you are challenged 

Hide a web form

If you would like to remove a web form from the Manage page view, you can hide it.

Hiding a web form only hides it on your view, any other users that have access (via share) will still be able to see it.

  1. Click the Manage tab scroll down to the Web Form section. 

  2. Select the Web Forms filter

  3. Single-click the web form you want to hide

  4. Click the Hide link located in the right rail options.

    • If the web form is still enabled, you are presented with a screen warning you that the web form is still enabled and can be signed by signers.


    If you do not disable the web form before hiding it, people can still access and sign it.

How to enable/disable user access to web forms

Business and Enterprise service levels have the option to configure the web form access and signer options.

Web form access and signer options can be enabled or disabled at the account or group level by navigating to Account > Account Settings > Global Settings > Web Forms


Configuration options

Web forms have four optional configurations:

  • Allow CCs within Web Forms:
    • When enabled, email addresses can be added as CC'd parties to the web form. Otherwise, the option to add CC'd parties is removed from the creation process
  • Allow PDF preview of Web Forms:
    • When enabled, a PDF link is exposed on the web form, allowing the recipient to view the web form as a PDF
      • Be aware that the PDF is a document the recipient can save to their local system
  • Require an email address in the signature block of Web Forms:
    • When enabled, an Email address field is required for each signer within the bounds of the document
      • Adobe Sign will automatically place a signature block for any recipient that does not have an email field on the document
    • When false, the recipient is prompted to provide an email address on an interstitial page
  • Require Signer to verify their email address:
    • When enabled, the recipient is required to verify their signature before the agreement is completed (Signed)
    • When disabled, the recipient does not need to verify their signature, and the agreement progresses to the next recipient or completes
      • If an additional recipient is included by the first recipient, then an email verification must be completed before the second recipient is notified (regardless as to this setting)
      • Unverified signatures are subject to repudiation


If you disable the email authentication of the signature, and you require a legally binding signature, ensure that you are using some form of authentication that identifies a unique person (eg: KBA, Password).

Find the URL and Embed Code for your web form

If you need to access the URL code for your web form:

  1. Click the Manage tab

  2. Select the Web Forms filter

  3. Single-click the web form to select it

    • This opens the Action rail on the right
  4. Click the Get Code action

    Navigate to Get Code
  5. The page refreshes to show the web form with the URL code at the top of the page:

    Get Code

FAQ & Known issues


After a web form is created, the name of the web form can not be updated.

The web form creator always receives the completed agreement (unless settings are in place to suppress the notification).

If another party is required to be notified when the web form agreement is signed, the CC field can be used to ensure that party is automatically included.

CC Field


After a web form is created, the CC'd parties can not be updated.


Templates in the Adobe Sign library can not be used as the base for a web form.


Instruction for disabling the email verification process can be found in the Configuration section.


If you disable the email authentication of the signature, and you require a legally binding signature, ensure that you are using some form of authentication that identifies a unique person (eg: KBA, Password).

Second factor authentications for a Web form


The URL to a web form is just a URL like any other.

Adding the URL to a web form as a hyperlink does not logically link any agreement generated by the web form to the source agreement.