index

ThreadFlow is a user-facing integration that keeps Jira and Slack aligned by syncing Jira issue comments with replies in a linked Slack thread—so the discussion stays consistent in both tools.

Available only for Jira Cloud

Overview

What it does

  • Two-way comment sync: replies in the linked Slack thread and comments on the Jira issue stay in sync.
  • Issue updates reflected in Slack: when the Jira issue is updated, ThreadFlow updates the original Slack message in the channel.
  • Single source of truth: the Jira issue remains the canonical place to review the full discussion and decisions.
  • Less context switching: stakeholders can follow updates from either tool.

Typical workflow

  1. Bind a Jira project to a Slack channel in ThreadFlow settings.
  1. When a Jira issue is created, ThreadFlow posts a message to the configured Slack channel.
  1. Replies in the Slack thread under that message are synced to the Jira issue comments (and kept aligned going forward).

Who it’s for

  • Teams using Jira to track work and Slack to collaborate day-to-day.
  • Stakeholders who want visibility without jumping between tools.

Initial setup

Prerequisites

  • Jira admin access (at least at the project level where ThreadFlow will be enabled).
  • Slack workspace admin/owner access (to create and configure a Slack app).
  • ThreadFlow installed in Jira (Marketplace or internal distribution).

1) Install the app in Jira

  1. Open Jira → Apps / Manage apps.
  1. Install ThreadFlow.
  1. Confirm the app is available in the target project.

2) Create and configure the Slack app

2.1 Create the Slack app from the manifest (recommended)

  1. In Jira, open Jira Settings (⚙️) > Apps > ThreadFlow Global Settings.
  1. In Create a Slack Bot, copy the Slack App Manifest (JSON).
  1. Go to the Slack API dashboard (Your Apps) and click Create New App.
  1. Choose From an app manifest and select your Slack workspace.
  1. Paste the manifest and replace YOUR_WEBHOOK_URL with the Slack Event Request URL shown in ThreadFlow Global Settings.
  1. Create the app and install it to your workspace.

2.2 Paste the Slack Bot Token into ThreadFlow

  1. In Slack, go to OAuth & Permissions and copy the Bot User OAuth Token (starts with xoxb-).
  1. Paste it into ThreadFlow Global Settings > Slack Bot Token and save.

2.3 Add the bot to the channel

To enable synchronization, invite the Slack bot to the channels where you want ThreadFlow to sync messages — both public and private channels.

3) Bind a Jira project to a Slack channel

  1. Open Jira project → Project settings.
  1. Find ThreadFlow configuration.
  1. Select the Slack channel that should be associated with this project.
  1. Save changes.

4) Verify (smoke test)

  1. Create a new Jira issue in the configured project and confirm a message appears in the configured Slack channel.
  1. Reply in the Slack thread under that message and confirm it appears on the Jira issue as a comment.
  1. Add a comment in Jira and confirm it appears in Slack (in the linked thread).

Jira Service Management (JSM) projects

  • Jira → Slack: all comments are synced to Slack.
  • Slack → Jira: all synced Slack replies are created as Internal notes.

Roadmap (Upcoming Features)

We are actively working on improving ThreadFlow. Here is what is coming next:

  • User mentions: When a Slack user and a Jira user share the same email address, ThreadFlow will render @mentions as real user mentions in both systems.
  • Slack Emoji Actions: Change Jira issue statuses directly from Slack by reacting to messages with specific emojis (e.g., 👀 for In Progress, ✅ for Done).
  • And much more to come! We are constantly working on new features and improvements. Stay tuned for future updates!


Support & Feedback

If you encounter any issues, have feature requests, or need assistance with the setup, please reach out to us:


Atlassian Marketplace (EULA & Privacy)

  • End User License Agreement (EULA)

    ThreadFlow is distributed under the Bonterms Standard End User Agreement (Version 1.0), subject to the following Provider-Specific Terms:

    Provider Entity: Tim Maierle
    Standard Agreement: Bonterms Standard End User Agreement Version 1.0
    Governing Law: The laws of the Federal Republic of Germany.
    Courts: The competent courts located in Düsseldorf, Germany.
    Support Policy: Support is provided via our Jira Service Management Portal.

    By installing or using ThreadFlow, you agree to the Standard Agreement as modified by these Provider-Specific Terms

  • Privacy Policy

    Effective Date: May 28, 2026

    This Privacy Policy explains how Tim Maierle ("we", "our", or "us") collects, processes, stores, and protects data when you install and use the ThreadFlow integration ("the App") for Jira and Slack.

    1. Data Controller
      The data controller responsible for processing your data under the General Data Protection Regulation (GDPR) is:
      Name: Tim Maierle
      Location: Düsseldorf, Germany
      Contact Email: tim@maierle.xyz
    1. Data We Process
      To provide two-way synchronization between Jira and Slack, ThreadFlow processes only the minimum necessary data, which includes:
      Jira Data: Issue identifiers (keys, IDs), issue summaries, descriptions, and comments.
      Slack Data: Channel identifiers, message text, user names/identifiers, timestamps, and thread metadata.
      Technical Logs: Temporary system logs containing API request metadata to ensure service stability and debugging.
    1. Purpose of Processing
      We process this data solely to perform the core functionality of the App:
      • Syncing comments from Jira issues to designated Slack threads.
      • Syncing replies from Slack threads back to Jira issues as comments.
      • Updating Slack messages when the status or details of a Jira issue change.
    1. Legal Basis for Processing (GDPR)
      We process personal data based on Article 6(1)(b) of the GDPR (processing is necessary for the performance of a contract / providing the service you requested by installing the App).
    1. Data Retention and Storage
      No Permanent Storage of Message Content: ThreadFlow acts as a conduit. We do not permanently store the text of your Jira comments or Slack messages on our servers. Content is processed in real-time to facilitate transmission between Atlassian and Slack systems.
      Configuration Data: We securely store infrastructure configuration data (such as encrypted Slack Bot OAuth tokens and Jira project mappings) using the secure Atlassian Forge Storage API. This data resides entirely within the Atlassian Cloud infrastructure.
      Logs: Technical debugging logs are automatically deleted after 14 days.
    1. Data Transfers to Third Parties
      Data is shared exclusively with Atlassian and Slack via their official, secure APIs to fulfill the integration's purpose. We do not sell, rent, or share your data with any other third parties.
    1. Your Rights (GDPR)
      As a user located in the European Economic Area (EEA), you have the following rights under the GDPR:
      • Right of access, rectification, or erasure of your data.
      • Right to restrict or object to processing.
      • Right to data portability.

    To exercise any of these rights, or if you have questions regarding your data, please open a ticket on our Support Portal or contact us via email at tim@maierle.xyz.

    Changes to This Policy
    We may update this Privacy Policy from time to time. Any changes will be posted directly on this documentation page with an updated "Effective Date".