# Feature JIM-180 - Migrate watchers 

Project: Stream Jira to OpenProject data Migrator
Status: merged
URL: https://community.openproject.org/work_packages/JIM-180

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.0.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List | RM Jira Migrator |
| Roadmap | 2026 Q4 |
| Relevance | Showstopper — Go-Live Blocker |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan | Community (COM) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Wieland Lindenthal |
| Product manager | Kristine Jetzke |
| Developers | Max Mulatz |
| Designer | Marc Alcobé |
| Ordered by |  |
| Signed off by |  |
| Interest by | Express (8754), Home (224196000003952096) |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** a user coming from Jira by a Jira migration  
**I want to** to watch the same issues that I watched in Jira  
**so that** I get notified of changes

**Acceptance criteria**

*   The migrator migrates the watchers
    

**Technical notes**

*   In Jira DC, "watching" an issue is a way to receive notifications for an issue.  
    The feature overlaps with roles like "reporter" or "assignee", but it's stored in a dedicated field on the issue. Users can add themselves as watchers by explicitly clicking "Start watching this issue". If the autowatch setting is turned on for the user / the instance, certain interactions such as creating an issue or commenting on it, will automatically make the user a watcher.
    
    <figure class="image image_resized op-uc-figure" style="width:398px;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/926057/content"></div></figure>
    
*   The search query the importer makes to retrieve issues includes basic information about whether an issue has watchers, how many they are and were to retrieve further information about them:
    

```json
"watches": {
  "self": "https://jira-software.localhost/rest/api/2/issue/TA-22/watchers",
  "watchCount": 1,
  "isWatching": true
}
```

*   To retrieve information about the actual watchers of an issue, the only documented option is to do another request to the `/watchers` endpoint for each issue that has a `watchCount > 0`:
    

```json
{
  "self": "https://jira-software.localhost/rest/api/2/issue/TA-22/watchers",
  "watchers": [
    {
      "self": "https://jira-software.localhost/rest/api/2/user?username=admin",
      "name": "admin",
      "key": "JIRAUSER10000",
      "emailAddress": "max@here.net",
      "avatarUrls": {
        "48x48": "https://www.gravatar.com/avatar/4b4a0dab29deb51118f57bfc87316551?d=mm&s=48",
        "24x24": "https://www.gravatar.com/avatar/4b4a0dab29deb51118f57bfc87316551?d=mm&s=24",
        "16x16": "https://www.gravatar.com/avatar/4b4a0dab29deb51118f57bfc87316551?d=mm&s=16",
        "32x32": "https://www.gravatar.com/avatar/4b4a0dab29deb51118f57bfc87316551?d=mm&s=32"
      },
      "displayName": "max",
      "active": true,
      "timeZone": "Etc/UTC"
    }
  ],
  "isWatching": true,
  "watchCount": 1
}
```

**Permissions and visibility considerations**

*   _\-_
    

**Translation considerations**

*   _\-_
    

**Out of scope**

*   \-