Welcome to the Settings — Jira Work Items to Include in the Knowledge Base Page!
Use this page to specify which Jira work items should be included in your knowledge base. Keeping this selection focused ensures users receive answers that reflect your current, supported products and releases.
Provide JQL exactly as in Jira
Paste the same JQL you use in the Jira UI. The application mirrors Jira’s matching behavior—if an issue appears in Jira for your JQL, it will be included in your Knowledge Base.
Tip: Write and test your JQL in Jira. Once you’re confident the results are what you need, copy-paste the JQL here for reliable, one-to-one behavior.
Why defining JQL here is helpful
- Relevance: Limit content to what matters now (e.g., current year’s tickets) to keep answers aligned with supported versions.
- Consistency: A single source of truth—every daily ingestion run applies the exact same rule.
- Control: Update the JQL anytime to refocus what’s included in your Knowledge Base.
How to use this page
- Open Jira and compose a JQL that returns the issues you want represented in your Knowledge Base.
- Confirm the Jira results match your intent (e.g., scope by product, status, or time window).
- Copy the JQL and paste it into this page’s JQL field.
- Save your settings.
Tip: This JQL is the single truth. Each time Jira ingestion runs, your Knowledge Base is re-written to match the latest results of this JQL.
About Jira ingestion
- Automatic schedule: Jira ingestion runs once per day when extraction services are not busy.
- No manual trigger: Unlike web URL ingestion, there is no manual “run now” for Jira.
- Visibility: Once ingestion completes, the included items are reflected on your Knowledge Base Sources pages.
Tip: After ingestion finishes, review the Knowledge Base Sources to verify coverage and make adjustments to your JQL if needed.
Quality tips
- Keep to recent work: Filter to the last year’s items so answers stay relevant to supported releases.
- Avoid noise: Exclude outdated projects or statuses that do not help end users today.
Tip: To remove all previously ingested Jira items, set your JQL to return nothing (for example,
createdDate <= 0). The application mirrors Jira’s results.
Save settings
Click Save Settings after pasting your JQL. Your rule will be applied during the next automatic Jira ingestion run.
Tip: When you’re ready, set the application to ON. If you want to stop the application at any time, set the application to OFF.
Need help tuning your JQL? Start with Jira’s search builder, verify results, and then paste here. For more guidance, visit Help.