Admin Tutorial · Tickets & Release Management

Connect ticket pipelines to release management in CrmLeaf

Two linked tutorials for admins and product managers configuring CrmLeaf for software product teams - ticket-to-task conversion, split SLAs, and release notifications.

Converting tickets to tasks & linking to releases

The outcome
What you will achieve

A configured ticket-to-task conversion workflow where support agents can convert any ticket to an engineering task with one click, full context is preserved, the link is bidirectional, and duplicate tickets across clients are surfaced and merged automatically.

Before you start

Prerequisites

  • ·Admin access to CrmLeaf (Settings > System Admin)
  • ·Ticket categories configured (see Tutorial T-01 for ticket pipeline setup)
  • ·Project board created for engineering work (at least one active project in Project Management)
  • ·Release cadence defined (sprint length, release frequency - needed for Step 4)
  • ·SLA profiles configured per client tier (see Tutorial T-01)
Step-by-step
1
Step 1

Configure ticket types for engineering triage

Navigate toSettings → Ticket Management → Ticket Types
  1. 1

    Create three ticket types relevant to a software product context:

    Bug Report

    Description
    Client-reported software defect or unexpected behaviour
    Default Routing
    Engineering liaison queue

    Feature Request

    Description
    Client request for new functionality or enhancement
    Default Routing
    Product Manager queue

    Configuration / How-To

    Description
    Setup help, settings question, usage guidance
    Default Routing
    Support agent queue - resolved in helpdesk

    Integration Issue

    Description
    Third-party API or connector problem
    Default Routing
    Senior support + engineering liaison

    Performance Issue

    Description
    Slow load times, timeouts, system degradation
    Default Routing
    Engineering liaison - P2 minimum priority
  2. 2

    For Bug Report and Performance Issue types, enable the Requires Engineering Review flag. This flag triggers an additional triage step in the ticket workflow.

  3. 3

    Enable the Convertible to Task toggle for Bug Report, Integration Issue, and Performance Issue types. Only these types will show the Convert to Task button. Feature Requests follow a separate product intake process.

Pro Tip

Configuration / How-To tickets should never be converted to tasks. If your support team is regularly converting config questions to engineering tasks, that is a knowledge base gap - not an engineering issue. Review your KB article coverage for any category where config ticket-to-task conversion rate exceeds 10%.

2
Step 2

Set up the split SLA for bug tickets

Navigate toSettings → SLA Management → SLA Profiles → [Select Profile] → Advanced
  1. 1

    Enable Split SLA Mode for each client SLA profile. This unlocks separate response and resolution SLA targets:

    Platinum - Bug

    P1 Response
    30 min
    P1 Resolution
    Next release (max 14 days)
    P2 Response
    1 hour
    P2 Resolution
    Next release (max 21 days)

    Gold - Bug

    P1 Response
    1 hour
    P1 Resolution
    Next release (max 21 days)
    P2 Response
    2 hours
    P2 Resolution
    Next-next release (max 35 days)

    Standard - Bug

    P1 Response
    4 hours
    P1 Resolution
    Next release (max 35 days)
    P2 Response
    8 hours
    P2 Resolution
    Backlog - estimated date TBC
  2. 2

    Under Resolution SLA Behaviour, select Release-Aligned. This means the resolution SLA countdown pauses once a ticket is linked to a release with a set target date. The resolution SLA becomes 'by the release date' rather than a generic number of days.

  3. 3

    Configure Response SLA separately - response time is always calendar-based and applies regardless of ticket type. A Platinum client's bug must be acknowledged within 30 minutes even if the fix takes two weeks.

  4. 4

    Under Client Communication, enable the Auto-notify on Task Creation message: when a bug ticket is converted to a task, the client automatically receives a message: 'We have confirmed this is a software issue and our engineering team is investigating.'

3
Step 3

Configure the ticket-to-task conversion flow

Navigate toSettings → Ticket Management → Task Conversion → Configuration
  1. 1

    Enable Task Conversion. This activates the Convert to Task button on eligible ticket types.

  2. 2

    Configure what gets carried across when a ticket is converted. These fields map from the ticket to the task:

    Ticket title

    Maps to Task Field
    Task title (editable)
    Notes
    Pre-filled; PM should refine to engineering-friendly language

    Ticket description + attachments

    Maps to Task Field
    Task description + attachments
    Notes
    Full content carried across; no re-entry needed

    Client SLA tier

    Maps to Task Field
    Task priority weighting
    Notes
    Platinum client ticket → High task priority by default

    Ticket category

    Maps to Task Field
    Task label / tag
    Notes
    Enables filtering tasks by issue category in the project board

    Ticket ID

    Maps to Task Field
    Task - Linked Ticket reference
    Notes
    Bidirectional link created; visible in both views

    Client name + account

    Maps to Task Field
    Task - Client impact field
    Notes
    Visible to engineers without exposing full ticket history

    Linked duplicate ticket IDs

    Maps to Task Field
    Task - Additional affected clients
    Notes
    Shows engineers total client impact of this bug
  3. 3

    Set the Default Project for converted tasks: navigate to the project the engineering team uses for their sprint board and mark it as the Default Conversion Target. Converted tasks land in the Backlog column of this project automatically.

  4. 4

    Enable Bidirectional Status Sync. Configure the status mapping between ticket and task:

    Backlog

    Linked Ticket Status Update
    In Queue - Engineering
    Client Visibility
    Visible in portal as 'Under Review'

    In Sprint / In Progress

    Linked Ticket Status Update
    In Development
    Client Visibility
    Visible in portal as 'Fix in Progress'

    In Review / QA

    Linked Ticket Status Update
    In Testing
    Client Visibility
    Visible in portal as 'Fix in Testing'

    Done (in staging)

    Linked Ticket Status Update
    Fix Ready - Pending Release
    Client Visibility
    Visible in portal as 'Fix Ready, Awaiting Release'

    Released (release published)

    Linked Ticket Status Update
    Resolved - auto-closed
    Client Visibility
    Portal shows resolved with release version reference
Common Mistake

Leaving Bidirectional Status Sync disabled. Without it, support agents have to manually check the project board to update ticket statuses - which they won't do consistently. When clients check their portal and see a ticket stuck on 'In Progress' for three weeks, they escalate.

4
Step 4

Set up duplicate ticket detection

Navigate toSettings → Ticket Management → Duplicate Detection
  1. 1

    Enable Duplicate Detection. Configure detection parameters:

    • Text similarity threshold: 65% match on ticket description triggers a duplicate suggestion (not auto-merge - always requires agent confirmation)
    • Feature tag matching: tickets with identical feature area tags submitted within 14 days are flagged
    • Error message matching: identical error codes or error message strings in the description trigger an immediate flag
  2. 2

    Under Merge Behaviour, configure what happens when an agent merges duplicate tickets:

    • Primary ticket retains its ID and SLA clock
    • Secondary tickets are linked to the primary and marked as Merged Duplicate
    • All secondary ticket clients are added to the notification list for the primary ticket
    • When the primary ticket's linked task is resolved, all merged ticket clients receive the resolution notification
  3. 3

    Set the Duplicate Alert Display: when an agent opens a new ticket in a category that has similar open tickets, a banner appears at the top showing similar open tickets so the agent can review before creating a new task.

  4. 4

    Configure the Duplicate Dashboard: add a Potential Duplicates widget to the support team dashboard. Review this daily during the first month of operation - it trains the team to spot duplicates before they create separate tasks.

5
Step 5

Test the full ticket → task → release chain

  1. 1

    Create a test bug ticket from a test client account. Verify: ticket is classified as Bug Report, SLA clock starts, Convert to Task button is visible.

  2. 2

    Create a second test ticket with similar description. Verify: duplicate detection banner appears on the second ticket.

  3. 3

    Merge the two test tickets. Verify: both clients appear in the notification list on the primary ticket.

  4. 4

    Convert the primary ticket to a task. Verify: task appears in the engineering project Backlog with all context fields populated and a link back to the originating ticket.

  5. 5

    In the project board, move the task to In Progress. Verify: linked ticket status updates to In Development automatically.

  6. 6

    Move the task to Done. Verify: ticket status updates to Fix Ready - Pending Release.

  7. 7

    Publish a test release containing the task (see T-04R). Verify: ticket auto-closes, both test clients receive resolution notification.

Release pipeline & client notification setup

The outcome
What you will achieve

A configured release pipeline where the product manager creates releases, assigns tasks, tracks completion, publishes releases, and automatically notifies affected clients - eliminating the post-release support spike and manual release note writing.

Step-by-step
1
Step 1

Configure the release pipeline structure

Navigate toProject Management → Releases → Settings
  1. 1

    Enable Release Management for your engineering project.

  2. 2

    Configure Release Stages. These are the gates a release passes through before production:

    Planning

    Description
    Tasks being selected and assigned to this release
    Exit Criteria
    All selected tasks have owners and estimates

    In Development

    Description
    Engineering sprint active; tasks being worked
    Exit Criteria
    All tasks in Done or moved to next release

    Code Freeze

    Description
    No new code; only bug fixes for release-blocking issues
    Exit Criteria
    Zero open P1 tasks in this release

    QA & Staging

    Description
    Release deployed to staging; QA testing active
    Exit Criteria
    QA sign-off from designated QA lead

    Ready for Release

    Description
    All checks passed; awaiting publish approval
    Exit Criteria
    Product Manager approval

    Released

    Description
    Published to production; clients notified
    Exit Criteria
    All linked tickets auto-closed
  3. 3

    Configure Stage Gate Approvals: set who must approve the transition from QA & Staging to Ready for Release (typically QA Lead) and from Ready for Release to Released (typically Product Manager).

2
Step 2

Create and populate a release

Navigate toProject Management → Releases → New Release
  1. 1

    Click Create Release. Fill in:

    • Release name: use semantic versioning (e.g. v3.5.0) or date-based naming (2026-Q2-R1)
    • Target release date: the date you plan to publish to production
    • Release description: internal summary of the release theme (e.g. 'Performance improvements + 12 bug fixes')
    • Linked project: select the engineering sprint project
  2. 2

    Add tasks to the release by navigating to the project backlog and selecting tasks → Assign to Release → [Release Name]. Tasks with linked tickets automatically bring their ticket references into the release.

  3. 3

    Review the Linked Tickets panel on the release detail page. This shows every client ticket that will be resolved by this release.

  4. 4

    Set the Release Visibility for clients: Internal Only (clients cannot see the release in their portal) or Announced (clients with linked tickets see the release in their portal with its target date). Announced releases set the expected resolution date for all linked tickets automatically.

Pro Tip

Set releases to Announced as soon as tasks are added and the target date is confirmed. Clients whose tickets are linked to an Announced release can see their expected resolution date in the portal. This single action eliminates the majority of ‘when will my issue be fixed?’ support queries for that release cycle.

3
Step 3

Configure client release notifications

Navigate toSettings → Communications → Release Notifications
  1. 1

    Enable Release Notifications. Configure three notification triggers:

    Release announced

    When It Fires
    When a release moves to Announced stage
    Content
    'Your issue [#X] is scheduled for resolution in [Release Name], targeted for [Date].'

    Release delayed

    When It Fires
    When target date changes on an Announced release
    Content
    'We need to update you: [Release Name] has been rescheduled to [New Date].'

    Release published

    When It Fires
    When PM publishes the release to production
    Content
    'Your issue [#X] has been resolved. It was included in [Release Name].'
  2. 2

    Configure the Notification Template for each trigger. Use merge fields to personalise: {{client_name}}, {{ticket_id}}, {{ticket_summary}}, {{release_name}}, {{release_date}}, {{release_version}}.

  3. 3

    Under Notification Audience, set: send to the Primary Contact on the client account plus any additional contacts who are cc'd on the original ticket. Do not send release notifications to contacts who had no open tickets in the release - they are noise to anyone not affected.

  4. 4

    Enable Release Notes Generation: when a release is published, CrmLeaf automatically generates a release notes document containing all resolved tickets, grouped by category. The release notes are attached to the Published notification email and available in the client portal.

4
Step 4

Manage the release lifecycle

Once a release is created and populated, the product manager's workflow is:

  1. 1

    Daily: check the Release Progress dashboard. This shows task completion percentage per release, any tasks that have moved to blocked status, and the SLA at-risk count.

  2. 2

    SLA at-risk response: if tickets are at risk of breaching before the release date, the PM has three options: move the task to an expedited release, negotiate a resolution SLA extension with the client, or escalate to engineering for a hotfix outside the sprint cycle.

  3. 3

    Code freeze gate: advance the release to Code Freeze when all planned tasks are Done. Review any remaining In Progress tasks - either move them to the next release or escalate to get them finished.

  4. 4

    QA gate: assign QA Lead as the approver. They test the staging deployment and approve the gate. Any QA-discovered bugs are either fixed (new tasks added) or documented as known issues for the next release.

  5. 5

    Publish: PM approves the Ready for Release gate. CrmLeaf publishes the release: all linked tickets auto-close, all affected clients receive their personalised notification, release notes are generated and distributed.

5
Step 5

Analytics: ticket volume as sprint priority input

Navigate toReports → Ticket Management → Engineering Impact Dashboard
  1. 1

    Enable the Engineering Impact Dashboard. This surfaces ticket data in a format useful for sprint planning:

    Top 10 bug categories by ticket volume

    What It Shows
    Which feature areas generate the most bug reports
    Sprint Planning Use
    Prioritise fixes in highest-volume areas

    Client impact score per open task

    What It Shows
    Ticket count × client tier weight per unresolved task
    Sprint Planning Use
    Objective priority ranking for backlog grooming

    Repeat reporter analysis

    What It Shows
    Clients submitting 3+ tickets on the same issue
    Sprint Planning Use
    Flag for dedicated engineering investigation

    SLA at-risk by release

    What It Shows
    Tickets at risk of breach before their linked release date
    Sprint Planning Use
    Identify which tasks to expedite

    Resolution time by ticket type

    What It Shows
    Average days from ticket open to task release
    Sprint Planning Use
    Benchmark for setting client expectations
  2. 2

    Share the Engineering Impact Dashboard with the engineering lead before each sprint planning session. The objective data from client ticket volume should inform but not fully dictate engineering priority - some low-ticket-volume bugs may be architecturally critical.

Pre-flight check

Validation checklist

  1. 01.Bug ticket shows Convert to Task button

    Open a test Bug Report ticket; verify button visible

  2. 02.Task conversion carries all context

    Convert a test ticket; verify task has description, client, priority

  3. 03.Bidirectional status sync working

    Move test task to In Progress; check ticket status updates

  4. 04.Duplicate detection fires

    Submit two similar test tickets; verify duplicate banner on second

  5. 05.Split SLA configured correctly

    Check a bug ticket's SLA panel shows response + resolution separately

  6. 06.Release stage gates require approver

    Attempt to advance test release without approver; verify blocked

  7. 07.Client notification fires on release publish

    Publish test release; verify test client receives notification email

  8. 08.Tickets auto-close on release publish

    Publish test release; verify linked tickets show Resolved status

  9. 09.Release notes generated

    Check published release for auto-generated release notes document

✓ Ready to launch when all items are checked

FAQ

Ticket & release management setup - frequently asked questions

Use the Client Impact Score in the Engineering Impact Dashboard. A bug with low engineering complexity but high client impact (multiple clients affected, Platinum SLA tier accounts) should surface near the top of the priority ranking even if the engineering effort is small. The one-click complexity of the fix actually makes it a good candidate for early resolution.

Feature requests should be acknowledged quickly (meeting response SLA) and then routed to a dedicated product intake process rather than the engineering task board. CrmLeaf supports a separate Feature Request workflow: the PM reviews submitted feature requests, votes on them, and adds high-priority ones to the product roadmap.

Yes. CrmLeaf's release management tracks the delivery pipeline at the task and ticket level - not the code level. Engineers push code to GitHub/GitLab as normal. CrmLeaf tracks which tasks (and therefore which client tickets) are included in each release.

Create a Hotfix release type in CrmLeaf with an expedited pipeline (no sprint planning stage). Hotfix releases have their own SLA configuration: all linked tickets get a P1 response and resolution SLA, and the client communication fires immediately when the hotfix is scheduled.

When a release date is updated, CrmLeaf checks whether any linked tickets' resolution SLA windows expire before the new release date. If they do, the PM receives an at-risk alert immediately. The options are: negotiate an SLA extension with the affected clients, expedite the fix into an earlier release, or escalate to engineering for a hotfix.

Ready to put this tutorial into practice?

Start free, migrate from any tool, and configure your service-desk workflows in days, not weeks.

Free 14-day trial · Free onboarding · Free data migration · Cancel anytime