1. Help Center
  2. Workflow automation

Which variables can be used in Word templates?

Document templates can be created and uploaded on Ledgy to be filled in with the information from the corresponding transactions. Here is a list of the supported variables that can be used in your document templates.

General variables

Name Example
{today} 18 Mar 2020
{currency} EUR

Option, warrant and phantom grant variables

Name Example
{stakeholder}  Stakeholder variables
{amount} 10,000
{strikePrice} 3.1415926535
{date} 12 July 1969
{expiryDate} 13 Mar 2100
{notes} *  
{vesting} Vesting variables

Share issuance variables

Name Example
{stakeholder}  Stakeholder variables
{amount} 10,000
{sharePrice}  3.1415926535
{class} Common
{date} 12 July 1969
{notes} *   
{vesting} Vesting variables

 

Option exercise variables

The same variables as for share issuance template are available for option exercise transactions.

Stakeholder variables

Name Example
{stakeholder.name}  Elon Must
{stakeholder.email} elon@must.com
{stakeholder.nationality} US
{stakeholder.birthdate} 28 Jun 1971
{stakeholder.notes}  
{stakeholder.address.line1} Rocket Road 1
{stakeholder.address.line2} c/o SpaceX Corp.
{stakeholder.address.postcode} 9808
{stakeholder.address.city} Hawthorne
{stakeholder.address.country} US

Usage

Stakeholder variables can be used wherever a stakeholder is involved. Just reference the sub-fields of the stakeholder like {stakeholder.name}, as shown in the example below.

  • Option grant
  • Share issuance and share certificate
  • Option exercise transaction

Vesting variables

{vesting.startDate} 12 July 1969
{vesting.duration} 48
{vesting.interval} 1
{vesting.cliff} 12

Usage

Stakeholder variables can be used wherever vesting or reverse vesting can be added. Just reference the sub-fields of the vesting like {vesting.duration}, as shown in the example below. Currently templating only supports simple vesting schedules.

  • Option grant
  • Share issuance and share certificate
  • Option exercise transaction

Quick Tips : 

Is your variable not working?: Ledgy will automatically fill in with “undefined” if the variable cannot be found. 

  • Make sure that the information to replace the variable is on Ledgy: if you use the variable {stakeholder.address.city} but you have not input the stakeholder’s city information on Ledgy, it will show up as “undefined”!
  • Make sure the variable is written exactly as stated above: if you have written {stakeholder.adress.city} (with a missing d), it will show up as “undefined”!

* You would like to have other customisable information in the document and the variable is not available for replacement on Ledgy in the list above? 

Ledgy has all the usual variables needed for document templates, but sometimes there could be a small difference from some companies to others, for such cases there is a quick work-around: 

An existing variable is {notes}, and it describes whatever might be in the Notes section of the transaction on Ledgy. If you have a variable that needs to be on the documents used in our workflow automation, but that variable is not available in workflow automation, you can still input the value of the variable in the Notes section, and use {notes} to replace it in the document. For example, if you would like to input the amount of money paid when exercising a particular transaction, you can put that number in the Notes section of the transaction and put {notes} in the document where you would like the variable to be replaced. 

Example

Let’s put the following text in a Word document for an option grant template:

Berlin, {today}

Dear {stakeholder.name},

We hereby grant you the following number of Virtual Options according to the terms and conditions contained in the Agreement and in this Grant:

Number of Options:     {amount}
Grant Date:                    {date}
Exercise Price:               {currency} {strikePrice}
Vesting:                           {vesting.duration} years, {vesting.cliff} months cliff, vests every {vesting.interval} months

Sincerely yours,

Gwynne Sheetwell, Tom Baker

The resulting PDF will contain:

Berlin, 18 Mar 2020

Dear Elon Must,

We hereby grant you the following number of Virtual Options according to the terms and conditions contained in the Agreement and in this Grant:

Number of Options:     10,000
Grant Date:                    14 Mar 2020
Exercise Price:               EUR 3.1415926535
Vesting:                           4 years, 6 months cliff, vests every 6 months

Sincerely yours,

Gwynne Sheetwell, Tom Baker