From 66844dd9846cbc44dc7cb7dce301130714229620 Mon Sep 17 00:00:00 2001
From: Lasse Hay-Schmidt <36488481+haysch@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:25:52 +0100
Subject: [PATCH] Add section on document ID templating in seal footer

Add section on "Variable Templating"
---
 src/pages/signatures/graphql/examples.mdx | 30 +++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/src/pages/signatures/graphql/examples.mdx b/src/pages/signatures/graphql/examples.mdx
index 165fe80..e3642ad 100644
--- a/src/pages/signatures/graphql/examples.mdx
+++ b/src/pages/signatures/graphql/examples.mdx
@@ -148,6 +148,26 @@ import createSignatureAppearanceExample from '../../../examples/createSignatureO
 
 <GraphQLExample example={createSignatureAppearanceExample} />
 
+### Variable Templating
+
+Templating in signature seals can happen in either the left side of the header or the footer.
+
+Variable templating works by enclosing the referenced variable curly brackets, e.g. `{{my-identifier}}`
+
+In addition to templating values from claims (see [Seal display name](#seal-display-name)), we enable use of some additional variables, such as:
+
+* Timestamp (see [Seal timestamp](#seal-timestamp)):
+  * Year: `$timestamp.YYYY`
+  * Month: `$timestamp.MM`
+  * Day: `$timestamp.DD`
+  * Hour: `$timestamp.hh`
+  * Minutes: `$timestamp.mm`
+  * Seconds: `$timestamp.ss`
+  * Milliseconds (1 digit): `$timestamp.z`
+  * Milliseconds (2 digit): `$timestamp.zz`
+  * Milliseconds (3 digit): `$timestamp.zzz`
+* Document ID (see [Seal document ID](#seal-document-id)): `$document.id`
+
 ### Seal timestamp
 
 By default the seal renders a timestamp in the left side of the seal header.
@@ -174,6 +194,16 @@ import addSignatoryDisplayNameExample from '../../../examples/addSignatory/displ
 
 <GraphQLExample example={addSignatoryDisplayNameExample} />
 
+### Seal document ID
+
+By default the seal does not render the document ID.
+
+The document ID can be added to the seal by templating as shown in the following example:
+
+import addSignatoryFooterExample from '../../../examples/addSignatory/footer';
+
+<GraphQLExample example={addSignatoryFooterExample} />
+
 ## Closing a signature order
 
 When all signatories have signed the signature order you can close it to retrieve your signed PDFs.