--- title: "Creating a Custom Consent Document" slug: "creating-a-consent-document-1" updated: 2026-11-05T19:41:27Z published: 2026-11-05T19:41:27Z canonical: "docs.onespan.com/creating-a-consent-document-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating a Custom Consent Document A consent document is a document used to confirm that a person agrees to the terms of the transaction and wishes to continue with the process. OneSpan Sign automatically includes the Electronic Disclosures and Signatures Consent agreement in all its transactions. All signers must accept the terms of this agreement before they can access transaction documents. OneSpan Sign provides Electronic Disclosures and Signatures Consent agreements in English and French. You can also upload your own consent documents with multiple language variants. Publishing a new consent document only affects transactions created after that point. Existing transactions are never changed. ## How consent documents work - Each account has one consent document, which can have several language versions. Each language version is a separate PDF file. - Uploading a file doesn't make it active. Signers only see a consent document after you publish it. - Each language can have only one active (published) file at a time. When you publish a new file for a language, it replaces the old one for new transactions only. - If you haven't published a custom consent document, transactions use the OneSpan default consent document. Transactions are never blocked because a custom document is missing. - If consent is turned off (set to No) for your account, signers don't see any consent document, custom or default. This setting overrides any document you've uploaded. ### File requirements - **Format**: PDF only. Word (.docx) files aren't supported. - **Maximum file size**: 16 MB OneSpan Sign checks each file when you upload it. If a file isn't a valid PDF or is corrupted, it's rejected with an error message, and your currently active document doesn't change. ## Uploading a consent document To upload a consent document: 1. Navigate to **Admin > Account Configuration > Consent Documents**. 2. Click **Add language override**. ![OSS_ConsentDocument_LanguageOverride.png](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OSS_ConsentDocument_LanguageOverride.png?sv=2026-02-06&spr=https&st=2026-11-10T03%3A34%3A33Z&se=2026-11-10T04%3A34%3A33Z&sr=c&sp=r&sig=zm6ZB0MFGxCGzuWLugoW2tcegPoGUGr3%2Be38jtV2MS0%3D) 3. Choose the language you want to upload a document for. ![Language override dialog within a scrollable list of available languages.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OSS_ConsentDocument_LanguageSelection.png?sv=2026-02-06&spr=https&st=2026-11-10T03%3A34%3A33Z&se=2026-11-10T04%3A34%3A33Z&sr=c&sp=r&sig=zm6ZB0MFGxCGzuWLugoW2tcegPoGUGr3%2Be38jtV2MS0%3D) 4. Upload the PDF file for that language using the Browse button, or alternatively drag and drop the file. 5. Enter a name for your consent document. 6. Optionally, click **Set as default fallback** to use this document as the consent document for languages that do not have their own consent document. 7. Optionally, click **Skip consent for this language** if you do not need a custom consent document. ![Add Language Override dialog with language selection, fallback options, consent document upload, display name, and save button.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OSS_ConsentDocument_LanguageDialog.png?sv=2026-02-06&spr=https&st=2026-11-10T03%3A34%3A33Z&se=2026-11-10T04%3A34%3A33Z&sr=c&sp=r&sig=zm6ZB0MFGxCGzuWLugoW2tcegPoGUGr3%2Be38jtV2MS0%3D) 8. Click **Preview**, or click **Save** to publish your consent document. Once saved, the consent document becomes effective immediately for all new transactions. ## Viewing and Editing Consent Documents Consent documents can be previewed by clicking the preview icon in the list of existing consent documents. You can also edit an existing consent document by clicking the ellipsis next to the consent document you wish to edit. From there you can - Edit the consent document. Clicking edit allows you to configure optional settings, replace the document with an updated one, or rename it. - Download the document. - Remove the document so that it is no longer available. ## What happens to existing transactions? The following table outlines what happens to transactions after you apply a new consent document: | Transaction state | What happens when you publish a new document | | --- | --- | | Draft (created before publishing) | Keeps the consent document it had when it was created. | | In progress (signing has started) | Keeps the consent document it started with. | | Completed | No change. | | New (created after publishing) | Uses the newly published document. | ## What will recipients see? The following table outlines the languages your recipients will see, depending on your transaction settings: | Scenario | Consent document shown | | --- | --- | | The transaction language has a published version | The published file for that language. | | The transaction language has no published version | A warning appears, and the English file is used instead. | | The transaction language and the recipient's language are different | The transaction language version. | | Recipients have different languages | The transaction language version. | | No custom document has been published | The OneSpan default consent document. | | Consent is set to No | No consent document. | ## Limitations - You can have only one consent document per account. You can't assign different consent documents to individual templates or business lines. - You can't go back to a previously published document. To restore older content, upload it again and publish it. - You can't change the OneSpan default consent document. - You can't edit documents in OneSpan Sign. To make changes, edit the PDF and upload it again. - You can't schedule a publish for later.