•••
 
Documentation   /   Reference: templates   /   Signature blocks
 
 

Signature blocks

 

Signature blocks are set up in the template editor. Behind the editor, each block is a --#: header followed by directive lines, which you can edit directly. There are two types:

  • auto: Plainly applies the signature automatically at the right point.
  • manual: someone clicks to sign.

Automatic signature

--#:
---id:{unique_string}
---type:auto
---party:{entity_signing}
---name:{person_signing_name}
---title:{person_signing_job_title}
---color:{#hex_colour}
Directive Description
---id A unique ID for the block. Generated automatically if blank.
---type Always auto.
---party Required. The entity signing, shown as "Signed by or on behalf of" that party. If blank, {{c_entity}} is used.
---name The person signing. If blank, the account's default signatory is used.
---title Their job title. If blank, the account's default title is used. If the directive is missing, no title is shown. Ignored unless ---name is set.
---color A colour, so the block is easy to find while editing.
--#:
---id:our_signature
---type:auto
---party:My Company Ltd

Manual signature

--#:
---id:{unique_string}
---type:manual
---party:{entity_signing}
---name:{person_signing_name}
---email:{person_signing_email}
---title:{person_signing_job_title}
---acceptable:{list_of_emails}
---block:{true|false}
---2fa:{none|email}
---color:{#hex_colour}
Directive Description
---id A unique ID. Generated automatically if blank. Use it to pass the signer's details: see below.
---type manual. If blank or missing, the block is manual.
---party Required, with a value. The entity signing.
---name Required directive; the value is optional. The signer's name.
---email Required directive; the value is optional. The signer's email address.
---title Optional. If present but empty, an empty job title field is shown. If missing, no job title field is shown.
---acceptable Optional. Limits who can sign: a comma-separated list of email addresses or wildcard domains, such as *@mydomain.com. If blank, anyone can sign.
---block Optional. true means later signature blocks can't be signed until this one is, so signatures happen in order.
---2fa Optional. email asks the signer to verify their email address with a code. none turns verification off. If missing, verification is used when Plainly detects you are signing your own document.
---color Optional. A colour for finding the block while editing.
--#:
---id:counterparty_signature
---party:{{a_counterparty_name}}
---name:
---email:

Passing signer details from a workflow

Each signature block's details can be set in ---pass_variables using the block's ID:

Variable Sets
{signature_id}:name The signer's name
{signature_id}:email The signer's email address
{signature_id}:title The signer's job title
---pass_variables:counterparty_IS_{{client}}_AND_counterparty_signature:name_IS_{{client_contact}}_AND_counterparty_signature:email_IS_{{client_email}}

Placing signature blocks

Signature blocks go at the end of the document unless you place [[SIGNATURE_BLOCK]] in the text.