{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Signature Layouts (Imprint Configuration)","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"signature-layouts-imprint-configuration","__idx":0},"children":["Signature Layouts (Imprint Configuration)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A signature layout defines what information appears in the visual signature imprint stamped on a document when a recipient signs. NSE lets you configure one ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["default layout"]}," that applies organization-wide, plus ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom layouts"]}," that can be applied to individual signature fields via the API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--configure-layouts-in-the-ui","__idx":1},"children":["Step 1 — Configure Layouts in the UI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Organization Settings → General → Signature Layouts"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/imprint.61d37da90a126af3d638c9253267fc872e8aa3d93dbe14bb7586ca9ddce8c145.4d07ae9a.png","alt":"No image","framed":false,"withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"default-layout","__idx":2},"children":["Default Layout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The default layout applies to every signature field where no custom layout is specified. Use the toggles to enable or disable each piece of information:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Toggle"},"children":["Toggle"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it shows in the imprint"},"children":["What it shows in the imprint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display given name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signer's first name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display surname"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signer's last name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display custom text"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A static custom text string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display date and time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date and time of signing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signer's email address"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also upload a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["background image"]}," that appears on the imprint content on every signature."," ","If a background image was uploaded it is possible to configure where the image should be displayed. See the following options:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Full background"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Above the text"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Below the text"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Left of the text"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Right to the text"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"custom-layouts","__idx":3},"children":["Custom Layouts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom layouts let you define alternative imprint configurations — for example a layout without a date, or one with a different background image for a specific brand or document type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a custom layout:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom layout"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Layout Name"]},". This name is what you reference in the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure what should be displayed as imprint for the signature."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create multiple custom layouts. Each is identified by its name."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," The layout name is case-sensitive and must match exactly what you pass in the API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2---add-a-custom-text-optional","__idx":4},"children":["Step 2 - Add a custom text (optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the custom layout has the custom text enabled it is possible to define a custom text on the stage recipient level. See the following sample configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"Automatic\",\n  \"languageCode\": \"en\",\n  \"signatureProfile\": \"Automatic Profile\",\n  \"signatureReason\": \"I agree to the terms.\",\n  \"metadata\": [\n    {\n      \"name\": \"customText\",\n      \"value\": \"First Signature\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--reference-a-layout-in-the-api","__idx":5},"children":["Step 3 — Reference a Layout in the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom layouts are applied at the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["signature field level"]},", inside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]},", when you place field tasks on a document."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a complete overview of the envelope creation workflow, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-envelope-workflow"},"children":["Basic Envelope Workflow"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-layoutname-parameter","__idx":6},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," Parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each signature type beside of the BiometricSignature entry in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," accepts an optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," field. Set it to the name of a custom layout defined in the UI. When the signer completes that field, the specified layout is used for the imprint instead of the organization default."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  {\n    \"signatureType\": \"TypeToSignSignature\",\n    \"layoutName\": \"TEST1\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," is omitted, the organization's default layout applies."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"full-example--signature-field-with-custom-layout","__idx":7},"children":["Full Example — Signature Field with Custom Layout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request below places a single signature field on page 1 and applies the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TEST1"]}," custom layout to the imprint:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks\nAuthorization: Bearer {jwt_token}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tasks\": [\n    {\n      \"field\": {\n        \"fieldType\": \"Signature\",\n        \"id\": \"signature\",\n        \"page\": 1,\n        \"positionX\": 100,\n        \"positionY\": 650,\n        \"width\": 200,\n        \"height\": 60,\n        \"allowedSignatureTypes\": [\n          {\n            \"signatureType\": \"TypeToSignSignature\",\n            \"layoutName\": \"TEST1\"\n          }\n        ]\n      },\n      \"recipientId\": \"{recipientId}\",\n      \"sortOrder\": 1\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multiple-signature-types-with-the-same-layout","__idx":8},"children":["Multiple Signature Types with the Same Layout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you allow the signer to choose between multiple methods, add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," to each entry:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  { \"signatureType\": \"ClickToSignSignature\", \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"DrawToSignSignature\",  \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"TypeToSignSignature\",  \"layoutName\": \"TEST1\" }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"different-layouts-per-signature-type","__idx":9},"children":["Different Layouts per Signature Type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can assign a different layout to each signing method — for example a branded layout for type-to-sign and a minimal one for click-to-sign:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  { \"signatureType\": \"ClickToSignSignature\", \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"TypeToSignSignature\",  \"layoutName\": \"TEST2\" }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Signature Layouts (Imprint Configuration)","id":"signature-layouts-imprint-configuration","depth":1},{"value":"Step 1 — Configure Layouts in the UI","id":"step-1--configure-layouts-in-the-ui","depth":2},{"value":"Default Layout","id":"default-layout","depth":3},{"value":"Custom Layouts","id":"custom-layouts","depth":3},{"value":"Step 2 - Add a custom text (optional)","id":"step-2---add-a-custom-text-optional","depth":2},{"value":"Step 3 — Reference a Layout in the API","id":"step-3--reference-a-layout-in-the-api","depth":2},{"value":"The layoutName Parameter","id":"the-layoutname-parameter","depth":3},{"value":"Full Example — Signature Field with Custom Layout","id":"full-example--signature-field-with-custom-layout","depth":2},{"value":"Multiple Signature Types with the Same Layout","id":"multiple-signature-types-with-the-same-layout","depth":3},{"value":"Different Layouts per Signature Type","id":"different-layouts-per-signature-type","depth":3}],"frontmatter":{"seo":{"title":"Signature Layouts (Imprint Configuration)"}},"lastModified":"2026-08-06T13:57:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/imprint-configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}