TasklocTaskloc/ Documentation

Jira Cloud — connecting

One-click OAuth sign-in — connecting Jira Cloud

The Jira Cloud connector shows issues from your Jira projects and lets you comment, change status, move an issue through the workflow and log time (worklog).

Only Jira Cloud (*.atlassian.net) is supported. Jira Data Center / Server is not supported yet.

How to connect (regular user)

There is nothing to copy — sign-in goes through OAuth:

  1. In the app: Settings → Organizations → organization → Integrations → "+" → Jira Cloud (or the Jira Cloud tile on the sign-in screen).
  2. Tap Connect — a browser opens with the Atlassian screen.
  3. Tap Accept — the app gets access, and you return to Taskloc.
  4. The issues will appear in the list.

If your Atlassian account has several Jira sites, the first available one is used for now. Choosing the site is planned.

What it can do

  • Creating an issue — ✅, the "+" button on the task list; the app takes the first issue type available in the project (more).
  • Comments (Atlassian Document Format — plain text).
  • Status change — through the issue's workflow transitions.
  • Time entries — worklog (/worklog, in seconds).
  • Labels, subtasks, priorities.
  • Attachments — files and photos to an issue (including several photos at check-in).
  • Ready-made filters — Jira saved filters.

What is not supported

  • Jira Data Center / Server (Cloud only).
  • Auto-pause of an idle session in the tracker (the token lives on the device).
  • Assigning an assignee from the app. The connector does not write the assignee: Jira expects a string accountId, and the app does not send it. If you change the assignee in the app, the change is silently lost — there will be no error, but in Jira the issue stays with the previous person. The assignee is visible in the list and in the card; change it in Jira itself. The "Assign the task to me on start" switch does not work for Jira for the same reason.

For the administrator

The Atlassian OAuth app is registered once — the Taskloc team does it. End users only tap "Connect": they do not need to copy keys or fill in addresses.

The administrator guide (registering the app in the Developer Console, callback URL, scopes) is the internal document docs/setup-trackers/setup-JiraCloud-for-Taskloc.md. If you deploy Taskloc yourself, request it from the Taskloc team.