How to resolve the “Project value does not exist” error in Tableau Connector Pro for Jira

How to resolve the “Project value does not exist” error in Tableau Connector Pro for Jira

Issue

When using Tableau Connector Pro for Jira, users can encounter a JQL validation error when attempting to run a connection that includes a project = <PROJECT_KEY> filter. This error can appear even though the JQL works directly within Jira's Issue Navigator.

Error message

The value ‘XYZ' does not exist for the field 'project’.

Stack Trace Example:

aio.jira.connector.exception.InvalidJQLException: The value 'XYZ' does not exist for the field 'project'

Example screenshot

image-20250710-144904.png

Root cause

This error typically occurs when the user or app behind the connector URL lacks sufficient access to the target project or when the connector configuration restricts access to specific projects.

Solution

Step 1: Confirm project access (validation step)

  • Run the JQL query (for example, project = PROJECT_KEY) directly in the Jira Issue Navigator.

  • If the query returns results, the user has access to the project.

If the JQL works in Jira, continue with the steps below, depending on your connector setup.

Step 2: Check access restrictions in the connector settings

  • Navigate to Tableau Connector Pro > Administration → App Settings.

  • Ensure the setting Projects for which the connector is allowed to pull the data includes the relevant project or is set to All Projects.

If the above steps do not resolve your issue, proceed to the third step.

Step 3: Confirm add-on permissions in the Jira project

  • Navigate to the specific Jira project.

  • Go to Project settings → Permissions.

  • Ensure the role atlassian-addons-project-access has the necessary permissions under "Browse Projects".

  • Reference: Atlassian KB - Addon Project Access

Result

Once project access is validated and the connector permissions are configured based on the type of connector used, the JQL error should no longer occur, and data will sync successfully with Tableau.

Need help?

If the issue persists, please contact Support.