Introduction
Dynamic grant dates allow you to automatically update a grant's effective date in Ledgy based on when signature requests are completed. This ensures your grant dates accurately reflect when agreements are fully executed, without manual updates.
This article explains what dynamic grant dates are and how to use them with Ledgy's document templating and signature workflow.
Who can use dynamic grant dates: You need to be an account admin in Ledgy and use document templating with signature workflows to implement dynamic grant dates.
How document templating variables work
When you create a document through document templating, Ledgy pulls information from your cap table using variables. Variables are placeholders in your template that get replaced with actual data when the document is generated.
Example of a standard variable:
Variable | Example Output | Description |
{stakeholder.name} | John Smith | Name of the stakeholder |
{date} | 27/02/2016 | Date of the grant |
{grant.quantity} | 10,000 | Number of shares or options granted |
For a complete list of available variables, see the full variables reference.
What is a dynamic grant date?
A dynamic grant date is a special variable that automatically updates the grant date in your Ledgy cap table when all signature requests are completed. Unlike standard variables that simply display information, dynamic variables trigger actions in Ledgy based on specific conditions.
Variable | Description |
{automation:updateGrantDateFromSignature} | The grant date of the grant transaction is automatically updated when fully signed by all associated parties |
When the Dynamic grant variable is included within a document template and generated on Ledgy with a signature request, the grant date of the grant transaction will automatically update and change the date when all applicable signers have completed the signature. We will not update the grant date in the document.
How it works:
When you include the dynamic grant date variable {automation:updateGrantDateFromSignature} in your document template and send signature requests, Ledgy automatically updates the grant's effective date to match the date when the last signer completes their signature.
Key characteristics:
The grant date in Ledgy updates automatically when all parties sign
The variable is hidden in the generated document (signers don't see it)
The document itself is not modified—only the grant date in Ledgy changes
This ensures your cap table reflects the actual execution date, not just the initial grant date
Dynamic grant dates are useful when:
You want grant dates to reflect actual agreement execution dates rather than initial creation dates
There's a delay between creating the grant and collecting all signatures
You need accurate grant dates for tax, compliance, or legal purposes
You want to eliminate manual updates to grant dates after signatures are collected
How to add a dynamic grant date
Step 1: Create or edit your document template
Go to Documents > Templates in your Ledgy dashboard.
Step 2: Upload a template with the dynamic variable
Click Upload and select your document template file (Word).
Step 3: Add the dynamic grant date variable
Include the variable
{automation:updateGrantDateFromSignature}anywhere in your document template.
Step 4: Use the template with signature workflow
When creating a grant, use this template and activate the signature workflow. Send signature requests to all required signers (typically the company representative and the stakeholder).
Example workflow
Here's how dynamic grant dates work in practice:
Initial setup:
You create a grant transaction on January 1, 2022, with a grant date of 01/01/2022
You generate a document using your template that includes
{automation:updateGrantDateFromSignature}You send signature requests to the stakeholder and company representative
The stakeholder signs on January 10, 2022
The company representative signs on January 15, 2022
All signature requests are now complete
Ledgy automatically updates the grant date in the cap table from 01/01/2022 to 15/01/2022 (the date when the last signer completed their signature)
The grant document itself remains unchanged, only the grant date in Ledgy is updated
Result: Your cap table now shows the grant date as 15/01/2022, accurately reflecting when the agreement was fully executed.
Frequently Asked Questions
What happens if signatures are completed on different days?
The grant date updates to the date when the last signer completes their signature. For example, if three people need to sign and the first two sign on January 10 but the third signs on January 20, the grant date will be updated to January 20.
Can I use dynamic grant dates without sending signature requests?
No, the dynamic grant date feature only works when you use Ledgy's signature workflow. If you generate a document without signature requests, the grant date will not automatically update.
Will the grant date in my document change to match Ledgy?
No, the document itself is not modified. Only the grant date in the Ledgy cap table is updated. If you want the document to show the updated date, you would need to regenerate the document after signatures are completed.