Skip to content

improvement(search): steer Confluence native queries to siteSearch for topic lookups #9742

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 2 commits into from
Nov 6, 2026
Merged

improvement(search): steer Confluence native queries to siteSearch for topic lookups #9742

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1453f11
improvement(search): steer Confluence native queries to siteSearch fo…
waleedlatif1 Nov 6, 2026
453dae6
improvement(search): describe text ~ as a fuzzy word match and show p…
waleedlatif1 Nov 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions apps/sim/lib/sim-search/live/providers.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -185,12 +185,12 @@ export const LIVE_SEARCH_PROVIDERS = {
confluence: {
guide: {
syntax:
'CQL: text ~ "term", title ~ "term" (title ~ "win*" for a prefix), type IN (page, blogpost) and space = KEY (quote keys starting with a digit), joined with AND/OR/NOT and parentheses; add ORDER BY lastmodified DESC only when recency matters more than relevance.',
'CQL: siteSearch ~ "a few words" is Confluence relevance search and ranks pages about the topic first, so use it for topic, acronym and how-to lookups. text ~ "term" and title ~ "term" (title ~ "win*" for a prefix) match pages containing those words or their variants without that ranking, so keep them for a specific identifier or term; text ~ "\\"exact phrase\\"" matches a phrase. Combine with type IN (page, blogpost) and space = KEY (quote keys starting with a digit) using AND/OR/NOT and parentheses; add ORDER BY lastmodified DESC only when recency matters more than relevance.',
scope:
'creator = currentUser(), contributor = currentUser(), mention = currentUser() and space = KEY. CQL has no project field; the separate native project field takes an Atlassian site cloud ID.',
example: 'type IN (page, blogpost) AND space = ENG AND text ~ "roadmap"',
example: 'type IN (page, blogpost) AND siteSearch ~ "deployment freeze process"',
avoid:
'starting the query with a negative clause (NOT, !=, !~ or NOT IN), which CQL rejects; lead with a positive clause such as type IN (page, blogpost).',
'ORing several text ~ clauses for a topic, which ranks pages sharing one common word first (put the words in one siteSearch instead), and starting the query with a negative clause (NOT, !=, !~ or NOT IN), which CQL rejects; lead with a positive clause such as type IN (page, blogpost).',
},
requiresEveryTerm: true,
previewText: previewConfluence,
Expand Down
Loading