DocuSign
The DocuSign integration collects electronic signatures in two places. Applicants sign their application (the application PDF, an optional Terms and Conditions page and selected letters) as the last step of submitting it, and staff send letters from a profile for signature by the applicant and any number of additional signers. An administrator connects one DocuSign account for the whole institution; every envelope is sent on behalf of the DocuSign user who connected it.
Note: Full Fabric uses one signature provider at a time. When PandaDoc is enabled it is used instead, even if a DocuSign account is connected, and the Request signature action on letters is hidden.
Connect your DocuSign account
Go to Settings → Other integrations → DocuSign. DocuSign connects by signing in, not with typed credentials, and there is no separate enable switch: digital signatures are available as soon as an account is connected.
- Click Authenticate. The whole window moves to DocuSign's sign-in page.
- Sign in as the DocuSign user that should send the envelopes. It must be able to create envelopes and request signatures.
- Approve the access DocuSign asks for. Full Fabric requests permission to send signature requests and to act on behalf of this user, so it can create envelopes when nobody is signed in to DocuSign.
- DocuSign returns you to the DocuSign settings page, which now shows Active.
| Shown on the page | Meaning |
|---|---|
| Active / Inactive | Whether an account is connected |
| Account ID | The DocuSign account Full Fabric uses: the default account of the user who authenticated |
| Impersonated profile ID | The DocuSign user envelopes are sent on behalf of |
Click Re-authenticate to switch to another DocuSign user, or after changing a setting in your DocuSign account. Each authentication replaces the previous user and checks your DocuSign account settings again. The page has no disconnect action.
Signatures on applications
Signing is set per application template, in Settings → Templates & documents → Application templates, on the template's Digital Signature tab. The tab is not offered on registration templates or on locked templates, and its controls stay disabled until a DocuSign account is connected.
| Setting | Effect |
|---|---|
| Sign Application PDF | The applicant signs the application PDF. The signature goes on the cover, or on the Terms and Conditions page when one is included |
| Include a Terms and Conditions page | Adds a page to the application PDF with your own Title for the page and Page content; the signature is placed below the content |
| Sign Letter Templates | Adds letters to the same signing session. Select Letter templates lists only letter templates marked Requires digital signature, and each letter needs a signature merge field (see Signatures on letters) |
| Digital signature email subject | Subject of the DocuSign envelope, per language. Defaults to "Please sign your application" |
What applicants see
When signing is required, the application's submit button reads sign & submit. Clicking it:
- Checks the application is complete. If anything is missing, the usual errors are shown and nothing is sent to DocuSign.
- Generates the PDF of the application and of each selected letter, and creates a DocuSign envelope for the applicant.
- Sends the applicant straight into the DocuSign signing session in the same window. No email is needed for this step.
- When the applicant finishes, DocuSign returns them to Full Fabric, which checks with DocuSign that the envelope is completed and then submits the application.
If the applicant leaves DocuSign before finishing, the application stays unsubmitted and they can click sign & submit again. Full Fabric reuses their envelope: it replaces the documents with the latest answers when your DocuSign account allows envelope correction, and otherwise creates a new envelope if the application changed since the last attempt.
- An application submitted by a staff member is accepted without a signature; the requirement applies to applicants.
- When an application is unsubmitted, its signature is cleared and the applicant signs again when resubmitting.
Signed application documents
Open the application on the applicant's profile and choose to download it. The Download application window has a Signed documents section with Download signed Application PDF and Download signed Letter (name) links, or "This application hasn't been signed yet." Full Fabric does not keep its own copy of the signed PDF: each link fetches the signed document from DocuSign at the time you click it.
Signatures on letters
Staff can send an individual letter for signature from a profile's Letters tab.
- Mark the letter template as signable: in Settings → Templates & documents → Documents → Letter Templates, open the template and tick Requires digital signature ("Enable digital signatures for this template.").
- Place signature merge fields in the template.
signature.full,signature.initials,signature.dateandsignature.locationbelong to the applicant;signature2.full,signature2.initialsand so on belong to the first additional signer,signature3.*to the second, and so on. - On the profile's Letters tab, create the letter and click Request signature.
- In the Request signature window, Applicant/Student (required) is always included and signs first. Tick Additional signer and enter the EXTERNAL PERSON NAME and EXTERNAL PERSON EMAIL; ticking a signer adds a box for the next one. Click Send signature request.
DocuSign then emails each signer in turn, the applicant first and each additional signer in the order listed, with the subject "Please sign: " followed by the letter name. No webhook setup is needed in DocuSign: each envelope tells DocuSign where to report progress, and the Signature status column updates as each signer finishes.
| Signature status | Meaning |
|---|---|
| Not required | The letter's template does not require a signature |
| Signature pending | Sent; not every signer has finished |
| Signature pending (1/2 signed) | With additional signers: how many have signed so far |
| Letter signed | Every signer has signed |
Once a request is sent, Request signature shows the signers read-only. When the applicant is the only signer it also offers Copy DocuSign Link, a Full Fabric link the applicant can open while signed in to Full Fabric to sign straight away. When the letter is signed, its PDF icon downloads the signed copy from DocuSign.
Warning: Deleting a letter does not cancel its DocuSign request. The signers can still sign, and the signed copy will not reach Full Fabric.
Common failures
| What you see | Usual cause | Fix |
|---|---|---|
| Warning "Allow Envelope Correct" is disabled in DocuSign on the settings page | Envelope correction is turned off in your DocuSign account. The warning explains that applicants who leave signing before finishing cannot resubmit | Ask your DocuSign account manager to enable the setting, then click Re-authenticate |
| Status Inactive, and the template's Digital Signature tab says digital signature must first be enabled | No DocuSign account is connected | Click Authenticate |
| "No impersonated profile. Re-authenticate to set one." | The connection has no DocuSign user to send as | Click Re-authenticate |
| An applicant comes back from DocuSign but the application is not submitted | They left the signing session before finishing | Ask them to click sign & submit again |
| "Please enter the name for additional signer" or "Please enter a valid email address for additional signer" | A ticked additional signer is incomplete | Complete or untick that signer |
| "Failed to send signature request. Please try again.", or DocuSign's own message, in the Request signature window | DocuSign rejected the envelope | Check the letter and its merge fields, then try again |
| "Letter isn't signed" or "Application isn't signed" when downloading | Not every signer has finished | Wait for the remaining signatures |
Permissions
| Action | Who can do it |
|---|---|
| Connect or re-authenticate DocuSign | Staff with Global integrations, see Integrations |
| Configure the Digital Signature tab of an application template | Staff with applics.application_templates_change |
| Send a letter for signature | Staff with core.institutions.profile_letters_change |
| Download a signed letter | Users with documents.letters_access |
| Download a signed application | Staff with applics.applications_download |