Skip to navigation

Updated Signer Experience

View as Markdown

Updated Signer Experience

We’re excited to introduce the updated Dropbox Sign signer experience, now featuring a modernized design and enhanced functionality. The new signer experience makes updates to our Signer App, which powers signature requests generated through your Dropbox Sign API calls and your Dropbox Sign account user interface. With this release, we’ve improved accessibility, streamlined navigation, and delivered a cleaner look and feel — making it easier than ever for signers to send and complete requests through both mobile and web experiences.

This update also introduces Mobile Form, a new signing option that presents all required signature fields in a clear, structured order. Mobile Form simplifies the signing process, helping signers complete documents more quickly and easily on any device. At any time, signers can switch between Mobile Form and the full document view, giving them more flexibility and control over their signing experience.

What’s Changed

Please see the changes we will introduce in our embedded signing and non-embedded flows in detail below:

Mobile Form: Prep and Send for Signature

Update DetailsCurrent DesignUpdated Design
New “Mobile Form” section allowing requesters to enable the Mobile Form feature.Current signer appUpdated signer app
When Mobile Form is enabled (via checkbox) and the requester adds a field from the Standard Fields group to the document, an interactive popover with an active cursor appears, prompting the user to define a custom field name.

Important Notes:
  • Enabling Mobile Form removes the default field names from the Standard Fields group. Each field must be assigned a custom name.
  • The custom field name is displayed to the signer, giving them the necessary context about what information is required.
  • Every field requires a name — the field name input cannot be left empty. An empty field triggers a validation error.
  • The Next button remains disabled until all fields have been named.
Current signer appUpdated signer app
Fields added before the Mobile Form is enabled from the Standard Fields group will be highlighted in red and must be given a name.

If those fields were already named, their existing names remain unchanged.
Current signer appUpdated signer app
New “Preview Mode” lets the requester toggle between the Desktop and Form views.Current signer appUpdated signer app

Mobile Form: Signing

Update DetailsCurrent DesignUpdated Design
The Get Started button has changed locations and is now in the top left corner.Current signer appUpdated signer app Updated signer app
Within the signing flow, a new Mobile Form toggle is displayed in the top-left corner if the requestor enabled the signature request for Mobile Form signing.Updated signer app
When the modal to add your signature is open there are 4 options to add signature available in tabs:
  • Draw
  • Type
  • Upload
  • Saved
Note: The Saved Signatures option displays a single signature at a time. Additional saved signatures can be navigated using the left and right arrow icon buttons. The total number of saved signatures is displayed in the top left corner of the input field.
Current signer appUpdated signer app
The new Mobile Form displays all fields in a clear, organized layout.

Important Notes:
  • The “Continue” button becomes enabled once all required fields are filled.
  • If attachments are required, an upload option appears at the end of the form. Selecting “Click to upload attachments” opens a side drawer panel with options to upload.
  • Uploaded attachments are immediately reflected in the Mobile Form.
Updated signer app Updated signer app
With the new Mobile Form toggled, signature fields are active and a signature can be added by selecting “Insert” in the field or by clicking on “Fill all signature fields” to fill all the signature fields in the document.

Important Notes:
  • Signatures can be adjusted using the toolbar options that appear in the active signature field.
  • Once the signature is inserted, you’ll have the options to “Edit” or “Clear” the signature.
Current signer app Current signer appUpdated signer app Updated signer app Updated signer app

Signer Experience

Update DetailsCurrent DesignUpdated Design
Access code: the access code page displays clearer instructions: “To access this document, enter the code provided by the sender. Contact the sender for more information.” The access code is case sensitive and there is a limited number of attempts to access the document.Current signer appUpdated signer app
With Mobile Form enabled on a mobile device, the “Get started” button appears in a drawer at the top of the document view. This also displays the number of filled out fields in the left corner.Updated signer app Updated signer app Updated signer app
With Mobile Form enabled, the default document view on mobile devices keeps the placement of the “Legal agreement” checkbox above the “Get started” button in the drawer at the top of the document with an updated design. Additionally, the options for “Decline” and “Download” have moved to the bottom right of drawer.Current signer appUpdated signer app Updated signer app
With Mobile Form enabled on a mobile device, selected input fields within the document view will also be displayed in the bottom drawer. When the field is filled out in the bottom drawer, it’s content is reflected in the actual field on the document.

The bottom drawer input field will indicate “Required field” or “Optional field” below the input. The “Next” button and the left arrow icon button in the right corner of the drawer allows the signer to navigate between fields on the document.

Important Notes:
  • Selecting the input in the drawer triggers the mobile device keyboard to allow for filling in the field. The drawer will be pushed up and below it keyboard will appear.
  • Names given to the fields will be visible on the drawer as the input label for clarity.
Current signer app Current signer appUpdated signer app Updated signer app
With Mobile Form enabled on a mobile device, the bottom drawer of the document view will also display all checkboxes in a group.

Important Notes:
  • Names provided for the fields will be visible on the drawer as the checkbox label with the group name.
  • ”Required field” / “Optional field” will also be displayed below the grouped checkbox input. The “Next” button and the left arrow icon button in the right corner of the drawer allows the signer to navigate between fields on the document.
Current signer appUpdated signer app
Mobile devices display the legally bound agreement at the top of the document view. The “I agree” button that will finalize the signing process and the left arrow icon for navigation appear below the agreement text.Current signer appUpdated signer app
When attachments are required with Mobile Form enabled, an attachments panel appears in a drawer at the bottom of the document view (or at the end of the form when toggled). Clicking “Click here to upload attachments” opens a modal showing:
  • All required attachments
  • Upload instructions
  • Options to select and upload files
The modal can be closed using X, Close, or Done, and uploaded files are saved automatically. The number of uploaded files is shown in the drawer or under the Attachments label, and files can be updated using the Edit icon.
Current signer appUpdated signer app Updated signer app Updated signer app Updated signer app Updated signer app
Signature fields appear in the drawer at the bottom of the document view or in a clear, organized layout when Mobile Form is toggled. Selecting “Click here to add your signature” (or clicking in the active signature field) opens a modal with signature options. You can:
  • Add a signature by clicking Insert (or Insert in the field)
  • Insert it into all signature fields by clicking Fill all signature fields
  • Adjust it using the toolbar options in the active field
Once inserted, the signature can be edited by clicking Edit or removed by clicking Clear.
Current signer app Current signer appUpdated signer app Updated signer app Updated signer app Updated signer app Updated signer app

Mobile Form in the API: Usage Guide

The API now supports Mobile Form settings for both template and signature request endpoints. This enhancement introduces a consistent contract update across all affected endpoints, adding a new nested field within the signer_experience object.

New Field Specification

Mobile Form field specification

Example JSON

"signer_experience": {
"form_view": "enabled"
}

Affected Endpoints

Template Endpoints

Signature Request Endpoints

Default Behavior

The form_view field is optional and defaults to disabled, preserving the current signer-facing experience. Specifying any supported non-default value enables the updated Mobile Form.

Note:

  • The signature request setting will override the template setting if there is a mismatch.
  • If template setting is set to "form_view":"enabled_by_default" and a signature request is initiated from this template, then you can override the template setting by passing in "form_view":"forced".
Request SchemaExpected Behavior
"form_view": "disabled"
  • Mobile Form is disabled for the template / signature request.
  • E.g. Current state templates and signature requests
"form_view": "enabled"
  • Mobile Form is enabled for the template / signature request.
  • The toggle is toggled off by default and will be visible to signers.
  • Note: signer has option to toggle on.

Mobile Form toggle default behavior
"form_view": "enabled_by_default"
  • Mobile Form is enabled for the template / signature request.
  • The toggle is toggled on by default and is visible to signers.
  • Note: signer has option to toggle off.

Mobile Form toggle default behavior
"form_view": "forced"
  • Mobile Form is enabled for the template / signature request.
  • The toggle is toggled on by default and is not visible to signers.
  • Note: signer does not have the option to toggle on or off.

Mobile Form toggle default behavior

Template vs. Signature Request Behavior

When a signature request is created using a Send With Template endpoint, the signature request will, by default, inherit the Mobile Form configuration from the associated template or templates. When multiple templates are included in a single signature request, the following rules apply:

1

Inheritance from Templates

  1. If all templates included in the request specify the same form_view value, that value is applied to the resulting signature request.
  2. If the values are conflicting the setting is set to the “lowest” version and a warning is added to the response
2

Conditions for Enabling Mobile Form

  1. To have Mobile Form enabled on the signature request:
    • None of the templates used in the request may have form_view explicitly set to disabled.
    • If even one template sets form_view: "disabled", the signature request cannot use Mobile Form.
3

Overriding via Signature Request Payload

  1. A form_view value may be passed directly in the payload of the Send With Template endpoint.
    • When provided, this value overrides the template-level Mobile Form settings.
    • However, this override is not allowed if any of the templates in the request have form_view set to disabled. In that case, validation will fail, and the request cannot enable Mobile Form.

This behavior ensures that Mobile Form is only enabled when all participating templates are compatible with the Mobile Form experience.

Validation Requirements and Updating Templates

To support Mobile Form, all fields within a template or signature request must include a non-empty name attribute. Field names serve as the labels in Mobile Form and should clearly communicate each field’s context.

Labels in Mobile Form

Updating Existing Templates

A new template update endpoint allows teams to:

  • Enable Mobile Form on existing templates
  • Add or update field names to meet validation requirements

Formal documentation for this endpoint is forthcoming. In the meantime, please refer to the following reference image and example payload.

Update Template Endpoint

Update template endpoint

Example Update Payload

{
"signer_experience": {
"form_view": "enabled"
},
"title": "Test Title",
"subject": "Test Subject",
"message": "Test Message",
"cc_roles": ["CC Role 1", "CC Role 2"],
"form_fields": [
{
"api_id": "uniqueIdHere_1",
"name": "New name 1"
},
{
"api_id": "uniqueIdHere_2",
"name": "New name 2"
}
]
}

Questions

If you have any questions, please reach out to our support team for further assistance.