Release Notes

Jira Sync

Connect Jira Cloud to automatically publish eligible issues as release notes.

How It Works

  1. You mark issues in Jira with a special "Release Notes" field
  2. rlse.dev detects these via webhook in real-time
  3. Eligible issues become changes in your rlse dashboard
  4. Status changes sync automatically

Setup

1. Connect Jira

  1. Go to Settings → Integrations
  2. Click Connect Jira
  3. Authorize rlse.dev to access your Jira instance

2. Create a Mapping

Mappings tell rlse which Jira issues to watch:

  • By Project: Watch all issues in a Jira project
  • By Label: Watch issues with specific labels (e.g., release-notes)

3. Configure the Release Notes Field

In Jira, add a custom field called "Release Notes" to your issues.

  • When populated, the issue becomes eligible for publishing
  • The field content becomes the change description
  • Supports full markdown

Eligibility Rules

An issue only becomes a change when:

  • It matches your mapping (project or label)
  • It has content in the Release Notes field
  • You explicitly mark it as eligible (human-gated)

Status Sync

When an issue's Jira status changes:

  • To Do → Draft
  • In Progress → In Progress
  • Done → Released

Troubleshooting

  • Issues not appearing? Check the Release Notes field is populated and the issue matches your mapping.
  • Status not syncing? Webhooks can take a few moments. Check the issue has a status transition in Jira.