Macros
The Contract Signatures Macros for Jira allow users to create structured contracts directly within Jira tickets using code-formatted blocks in the Description field of a work item (issue). Users can quickly define key contract components such as Signature, Signer, Visibility, and other Field macros to customize the content and behavior of the contract.
Signature Macro
The Signature macro allows for the inclusion of signatures and inputs in a contract.
Users may include the following parameters inside the Signature macro,
Full name
Email addresses
Providing these parameters makes the contract creation form easier to use, as it will automatically pre-fill the signer's legal name and email address.
Additionally, users can choose the type of filed to be added using the Signature macro including,
Signature
Initials
Date
Text
Checkbox
The signer will have to populate the fields.
Here is an example:[Signature A, Jessica Smith, jsmith@example.com] [Initials B, John Doe, jdoe@example.com] [Date C, Mencia Bishop, mbishop@example.com] [Text D, Marcia Benz, mbenz@example.com][Checkbox E, Sarah Dean, sdean@example.com]
[meta contract expiration date]
[meta contract expiration date and time]
If users do not include the required parameters, they will be prompted to fill out a contract creation form before the contract can be created. However, users can still use the Signature macro to identify where the signature and other fields should be placed within the contract.
Signer Macro
The Signer macro displays information about the signers in the contract.
The information displayed may include:
Legal name
Email address
Phone number
Signing date
Signing date and time
The Signer macro cannot be interacted with or altered when the contract is created.
Here is an example:[Signer A, legal name] [Signer B, email address][Signer C, phone number][Signer D, signing time][Signer E, signing date and time]
Field Macro: Supported Field Types
Field macro enables you to pull in dynamic data from Jira fields into the contract. It supports a variety of field types, allowing contracts to reflect current issue details.
Supported field types:
User
Date
Date time
Number
Priority
Status
Issue type
Labels
Text (Single Line)
Select List (Single choice)
Select List (Multi choice)
Version
Component
Example usage:
[Field priority]
[Field status]
[Field labels]
Visibility Macro
The Visibility macro allows the user to control the visibility of certain content in the contract.
Any content wrapped by the macro will be hidden when the contract is created.
Here is an example:[Hide start] This text will be hidden. [Hide end]
Example Jira Contract using macros
Below is an example of a Jira ticket with macros to create a contract:
Jira Ticket - Used macros to create a contract
Contract PDF View - Macros are applied