Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.raleyapps.com/llms.txt

Use this file to discover all available pages before exploring further.

Event Monitoring

Raley listens to a comprehensive set of Jira and JSM events: Issue events: Created, Updated, Assigned, Unassigned, Workflow Transition, Comment Added, Comment Deleted, Resolved, Closed, Reopened, Deleted Project events: Created, Updated, Deleted Version events: Created, Updated, Released, Unreleased, Merged, Deleted JSM-specific: Internal vs. external comment distinction, customer request events

Notification Types

Event-Triggered Notifications

Fires immediately when a defined event occurs and the configured conditions are met.

Digest Notifications

Collects changes to a group of issues over a defined time period and sends them as a single summary email. Useful for:
  • Issues commented during a specified period
  • High-priority issues approaching deadlines, grouped by assignee
  • Issues with no activity for N days
Digests run on a schedule — the minimum interval is 1 hour (sub-hourly scheduling is not supported).

Canned Notifications

Pre-built templates available directly from the Jira issue view, allowing any authorized user to trigger a notification on demand without admin configuration.

Recipients

Notifications can be sent to any combination of:
Recipient TypeDescription
ReporterThe user who created the issue
AssigneeThe currently assigned user
WatchersAll users watching the issue
Mentioned usersUsers @mentioned in the issue
Group membersAll members of a specified Jira group
Project roleAll users in a project role
Component leadsLead of the issue’s component
Service Desk participantsCustomers and participants on JSM requests
OrganizationsJSM organization members
External emailAny static email address or distribution list
Dynamic (template)Any email address resolved from a Jira field or Velocity expression
All destination types support To, CC, and BCC fields.

Email Customization

  • Full HTML control for message body and styling
  • Inline image support (embed images within the email body)
  • Issue attachment delivery — attach Jira issue files to outgoing emails
  • Issue PDF snapshot — attach a PDF export of the Jira issue
  • Company logo and branding
  • Dynamic From name and address per notification
  • Custom email headers

Template Engine

Uses a Velocity-based template language to insert dynamic content:
  • Any standard Jira field
  • Custom fields
  • Asset fields (JSM Assets)
  • Conditional logic (#if, #foreach, etc.)
  • Date formatting helpers
  • Linked issue data
See Templating for the full reference.

JSM-Specific Features

  • Approve / Decline buttons — embed one-click approval links in JSM service request notification emails
  • Customer and participant notifications
  • Internal vs. external comment routing
  • Request type filtering

Sending Options

MethodDescription
Raley shared mail serverNo configuration needed — send immediately
Custom SMTP serverUse your own domain; supports OAuth2 (Gmail, Office 365) and legacy password auth
Gmail OAuthEnables email threading via Message-ID tracking

Audit and Monitoring

  • Send Audit tab — log of all sent notifications with status, recipient, and error details
  • Audit comment — optional: stores a copy of each sent notification as a private comment on the Jira issue
  • Admin delivery alerts — hourly digest emails sent to configured admins when delivery failures occur
See Monitoring for setup details.

Access Control

By default, only users with ADMINISTER or JIRA_ADMIN permissions can configure notification rules. Additional Jira user groups can be granted access through the app’s Settings. The Raley issue panel (for canned / instant notifications) is available to any Jira user with access to the issue.

Need Help?


Explore Other RaleyApps

Raley Intake Forms

Create powerful intake forms directly inside Jira and JSM.

Raley Procurement and Quotation

Manage purchase orders and sales quotes from within Jira.

Raley Bookman

Asset booking management inside the JSM portal.

Raley Favorites

Save and quickly access your most important Jira issues.
Browse all RaleyApps on the Atlassian Marketplace →