✍️ Signatures [Custom Field]

The Digital Signature Custom Field is a Jira custom field type that stores a legally defensible electronic signature directly on an issue.

Setup

Create the Custom Field

1. Jira Administration → Issues → Custom Fields

2. Click "Create custom field"

3. Select "Signature" as field type

   Open

   

4. Choose Field configuration scheme expected
   
   

5. Open

   

   Click “…” and choose Add field to screen to select proper screens you want to associate.
   
   

   Open

   

6. Click “…” and Choose Contexts and field values → Custom field config: Edit custom field config
   
   
   

   Open

   

Inviting Signatories (Permission Control)

When Multiple Signatory Invitations is enabled:

1. The signature field shows "📨 Invite Signatory" when unsigned

2. Jira users can search and invite colleagues to sign

3. Invited users receive a Jira comment mention with instructions

4. Only invited users can sign the field

To invite users:

• Click field → "Invite Signatory" tab

• Search for Jira users by name

• Select user(s) → Send invitation

💡 If Multiple Signatory Invitations is disabled, only the user who opens the field can sign (no invitations).

End-User Experience

Field States

Signing the Field

1. Click on the signature field in issue view

2. Signature modal opens with tabs:

3. Optional: Check "Save as my default signature"

4. Click "Apply Signature"

After Signing

The field displays:

• Top area: Large signature preview (image or typed name)

• Bottom bar: Signer name + timestamp + green verification checkmark

Viewing Signature Details

Click the signed field → Verification modal opens showing:

• ✅ Status: "SECURE SIGNATURE VERIFIED" or "⚠️ SIGNATURE DECLINED"

• Signatory name

• Full timestamp (date + time)

• Signature topic

• Declined reason (if applicable)

Declining to Sign

1. Click signature field

2. Select "Decline to Sign" tab

3. Enter reason (e.g., "Not authorized for this approval")

4. Click "Confirm Decline to Sign"

Result: Field shows "⚠️ DECLINED: [reason]" – Permanent audit record.

Clearing a Signature (Admin only)

If Allow Signature Removal is enabled AND you have admin permissions:

1. Click signed field

2. Look for "Clear & Re-invite" button

3. Confirm → Field resets to unsigned state

4. Invitation list is cleared

5. Re-invite users as needed

Receiving an Invitation

When someone invites you to sign:

1. Jira comment mentions you: "You have been invited to provide a Digital Signature for [field name]"

2. The signature field becomes active for you

3. Click field → Sign normally

🔒 Only invited users can sign. Uninvited users see: "Only the invited user can sign"

Workflow Validator Integration

Setup

1. Jira Administration → Issues → Workflows

2. Edit target workflow

3. Select transition → Add validator

4. Choose "Digital Signature Validator"

5. Publish workflow

Behavior

When user attempts to transition issue:

🔍 Validator automatically detects ALL Digital Signature custom fields on the issue. Each must be signed.