JQL filter blocking timeline

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

JQL filter blocking timeline, Error "A JQL filter is blocking your timeline"

Environment

.Cloud Only

Diagnosis

An epic issue type must exist and be included in your project via JQL

Jira Software comes with a default issue hierarchy structure which includes the issue type epic. Your administrator can create a custom hierarchy level and name it whatever your organization calls tasks at that level.

However, if this epic-level task is hidden from the timeline’s issue source, whether by accidentally deleting the issue type or filtered out through a JQL filter, you’ll see the same warning as above.

Solution

In order to fix this error message, you will need to navigate to the board settings of the Kanban board of the impacted project and edit the filter query.

The edit filter query will take you to the JQL filter applied for the affected board, you can simply include the Epic type in the Issue Types drop-down shown.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.