TestKase Docs
Jira Plugin

Troubleshooting

Common issues, error screens, and solutions for the TestKase Jira Plugin.

Error Screens

The plugin displays specific error screens when configuration issues are detected.

NO_CONFIG Screen

What you see: "Not Configured" message with instructions to set up the plugin.

Cause: No Personal Access Token (PAT) has been saved for the current user.

Solution:

  1. Navigate to the TestKase global page in Jira (accessible from the apps menu or from the link in the error message).
  2. Generate a PAT from TestKase Settings → API Keys if you do not have one.
  3. Paste the PAT and click Save.
  4. Return to the Jira issue -- the panel should load.

PAT_EXPIRED Screen

What you see: "Token Invalid" or authentication error message.

Cause: The saved PAT is no longer valid -- it may have been revoked or expired.

Solution:

  1. Generate a new PAT from TestKase Settings → API Keys.
  2. Navigate to the TestKase global page in Jira.
  3. Enter the new PAT and click Save.
  4. The plugin will validate the new token and resume normal operation.

MAPPING_LOST Screen

What you see: "Project Not Mapped" or similar message indicating the project connection is missing.

Cause: The Jira Integration in TestKase has been disconnected or reconfigured, breaking the project mapping the plugin relies on.

Solution:

  1. Ask your TestKase project admin to go to TestKase Settings → Jira Integration.
  2. Reconnect the TestKase project to the Jira project.
  3. Once the integration is re-established, refresh the Jira issue panel.

Common Issues

Panel shows 'Not Configured' on every issue

This means no PAT has been saved for your user. Navigate to the TestKase global page in Jira (find it in the apps menu), enter your PAT, and click Save. The configuration is per-user, so each team member must set up their own PAT.

I saved my PAT but the panel still shows loading

Try these steps:

  1. Refresh the Jira issue page.
  2. Verify your PAT is valid by testing it in the TestKase API or checking Settings → API Keys.
  3. Ensure the Jira project is connected to a TestKase project via Jira Integration in TestKase Settings.
  4. Check your browser console for network errors -- the Forge app may be unable to reach the TestKase API.
Test cases are not appearing in the panel

Possible causes:

  • No test cases linked: The panel shows test cases linked to the current Jira issue. If no test cases have been linked or created from this issue, the table will be empty.
  • Wrong project: Verify that the Jira project is mapped to the correct TestKase project. Test cases from a different project will not appear.
  • Pagination: If you have many test cases, check subsequent pages using the pagination controls.
AI generation is grayed out or not available

The Generate Testcase button is disabled when AI features are turned off for your organization. Ask your organization owner to enable AI features from TestKase Settings. The button tooltip will read "AI features are temporarily unavailable. Contact your admin."

Execution status is not saving

Ensure you have:

  1. Selected a status (Not Executed, Pass, Fail, or Blocked) -- the Save button is disabled until a status is chosen.
  2. A stable network connection -- the Forge app needs to reach the TestKase API to save execution data.
  3. A valid PAT -- if your token has expired, saves will fail silently. Refresh your PAT if needed.
Attachments fail to upload

Check the following:

  • File format: Only PDF, PNG, JPG, GIF, WEBP, MP4, AVI, MOV, XLSX, XLS, CSV, DOC, and DOCX files are supported.
  • File size: Large files may exceed upload limits. Try compressing the file or reducing resolution for images/videos.
  • Storage quota: Your TestKase organization may have reached its storage limit. Check Settings → Storage in TestKase.
I can't see my folders

Folders are loaded based on the TestKase project mapped to the current Jira project. If you do not see expected folders:

  • Verify the project mapping is correct (check TestKase Settings → Jira Integration).
  • Ensure you have permission to view folders in the mapped TestKase project.
  • Try expanding parent folders -- child folders are hidden until the parent is expanded.
The panel is slow to load

The plugin makes API calls to TestKase on each load. Slow loading can be caused by:

  • Network latency between your Jira Cloud instance and the TestKase API.
  • Large datasets -- projects with thousands of test cases may take longer to load. Use search and pagination to narrow results.
  • Forge cold starts -- the first load after a period of inactivity may be slower due to Forge infrastructure warm-up. Subsequent loads are faster.
Can multiple team members use the plugin simultaneously?

Yes. Each user configures their own PAT, and all actions are independent. Multiple team members can create test cases, execute tests, and manage cycles on the same or different Jira issues simultaneously. Each user's actions are attributed to their TestKase account.

How do I update my PAT?

Navigate to the TestKase global page in Jira (accessible from the apps menu). Enter your new PAT and click Save. The old token is replaced immediately. You can generate a new PAT from TestKase Settings → API Keys.

What data does the plugin store in Jira?

The plugin stores only the user's PAT in Forge's encrypted storage (per-user, per-instance). All test management data (test cases, cycles, executions, folders) is stored in TestKase, not in Jira. The plugin reads Jira issue context (title, description, project key) but does not write to or modify Jira issues.