Semantic search lets you find applications, dashboards, reports, surveys, presentations, and broadcasts by what they mean, not just the words you remember. Type a natural-sounding question or phrase and the search finds relevant items even when your wording doesn't match their names.
It's also the first time you can search across assets in the same bar as components. Until now the search bar was focused on components. Now reports, dashboards, surveys, presentations, and broadcasts appear alongside them in one ranked list.
Note: Semantic search is available throughout Ardoq. It is not available in legacy Discover. If you're a legacy Discover user, your Admin will need to move you to the new Discover experience to use it.
How to search
Open the search bar. There are two ways:
Press Cmd+K (Mac) or Ctrl+K (Windows or Linux) from anywhere in Ardoq.
Click the Search button in the sidebar.
Type your question or a phrase. You don't need to know an item's exact name. Phrases like "source control tool for development" or "Atlassian products" work directly.
Click a result to open it, or press Escape to close the bar without picking anything.
What you can search for
Item type | Examples |
Component | Applications, business capabilities, people, services |
Dashboard | Application portfolio, capability heatmap |
Report | Lifecycle reports, cost reports |
Survey | Application owner surveys, data quality reviews |
Presentation | Quarterly architecture review |
Broadcast | Scheduled survey reminders |
Results from all six types appear in a single ranked list. Workspaces, viewpoints, references, and individual fields aren't indexed yet. You can still find them via the workspace navigator, or for viewpoints, the command palette.
Understanding your results
The most relevant items appear at the top. Each row shows the item's name and type. Click a row to open it.
If you have many possible matches, an Other results section may appear below the main list. This holds matches that ranked below the relevance threshold. Expand it if you want to see them.
Note: Results are permission-aware. You only see items you have read access to. Items you can't see won't appear in search even if they would be a strong semantic match.
How to find an item by ID
If you know an item's exact ID, type it instead of searching by meaning. The match is pinned to the top of results, ahead of all semantic matches.
Two kinds of ID work:
Component key (Ardoq ID): type the key or the start of one.
Custom search field: if your Admin has set up a custom search field (for example an external system ID, a cost centre code, or a business capability identifier), type that value.
Both are case-insensitive and you don't need to type the full value to get a match.
How to filter results by type
Filter chips appear in the search input. Click a chip to narrow results to a specific item type, or to a specific component type if your Admin has configured quick-filter component types.
Commands and the command palette
The search bar is also a command palette. Beyond finding items, you can use it to navigate, open settings, and start common actions without leaving the keyboard.
How to run a command
Press Cmd+K or Ctrl+K to open the search bar.
Type / as the first character. The bar switches to command palette mode and shows only commands.
Continue typing to filter. For example, /dash shows only dashboard-related commands.
Press Enter to run the selected command.
You can also see commands without the / trigger. While you're searching by phrase, a short list of matching commands appears below your results.
What you can do
Commands are grouped into sections. What you see depends on your role:
Navigation: Home, Discover, Tasks, Solutions, Asset library
Data: Data Inventory, Create Workspace
Surveys, Dashboards, Reports, Presentations, Viewpoints: Open the overview page or create a new item
Broadcasts: Open the overview, create a new broadcast (Admin)
Import & Integrations: Open the overview
Metamodel: Metamodel previews (Admin)
Administration (Admin only): Organisation settings, Access control, Audit log, Usage metrics
Account and Help & Support: Personal account, About Ardoq, Report a bug
Note: Commands are role-aware. A command you can't run won't appear in your results. Some commands also depend on feature flags being enabled for your organization.
The Currently Open section
Open the search bar without typing anything, and a Currently Open section shows your active context: the open Workspace or Viewpoint, the active Report, Dashboard, or Data Inventory view. Click an entry to jump back to it.
Tips for better results
Describe the purpose, not just the keyword. "systems responsible for user authentication" works even if no item is named that way.
Typos are fine. Minor spelling variations still return relevant matches.
If you remember the exact ID, use that for a direct top-of-results match.
Search settings for Admins
In Organisation settings > Search settings, Admins can configure how search behaves for the organization:
Setting | What it does |
Semantic search | Turn AI-powered, meaning-based search on or off. When off, classic keyword search is used. |
Custom ID search field | Pick a component text field whose value should match exactly at the top of results. |
Ardoq ID search | Control whether users can search by Ardoq's internal component key. On by default. |
Quick filter component types | Pick which component types appear as one-click filter chips in the search input. |
How to turn semantic search on or off
Go to Organisation settings > Search settings.
Toggle Semantic search on. When on, the search bar uses meaning-based search across components and assets. When off, the search bar falls back to classic keyword search.
Troubleshooting
I don't see semantic-style results.
Either the Semantic search toggle is off, or the feature is not yet enabled for your organization. Go to Organisation settings > Search settings to check.
I'm on legacy Discover and don't see search at all.
Semantic search is not available in legacy Discover. Your Admin can move your organization to the new Discover experience. See the Admin setup guide.
My item didn't show up.
Make sure it's one of the six indexed types (Component, Dashboard, Report, Survey, Presentation, Broadcast). If you remember the exact ID, type that to pin it to the top of results. Items you don't have read access to never appear in search.
I just created an item and it isn't showing.
Indexing is near real time but not instant. New or updated items may take a short while to appear.
Current limitations
Six item types are indexed today. Workspaces, viewpoints, references, and individual fields are not.
Viewpoints can be opened or created via the command palette but don't appear in search results.
Indexing is near real time. New or updated items take a short while to appear.
More than 100 languages are supported, but results are best when your query and the content are in the same language.
Search history and saved searches aren't available yet.
Not available in legacy Discover.
FAQ
Will semantic search find an item if I don't know its name?
Yes. That's the main thing it's good at. Describe what you're after in your own words and the search uses meaning, not exact keywords, to surface the right items. For example, "source control tool for development" can return Git or Bitbucket even though those words aren't in the query.
Does my organization's data leave Ardoq when I use semantic search?
No. Embedding and ranking happen on Ardoq's own infrastructure. Your queries and your content aren't sent to third-party AI providers.
What happens when I turn semantic search off?
The search bar falls back to classic keyword search. You can still find items, but only when the words you type match the words in their name or description.
Can users find items they don't have permission to see?
No. Search is permission-aware. Items you don't have read access to don't appear in your results, even if they would be a strong semantic match.
What happens when I rename or update an item?
The change is picked up automatically. Indexing is near real time, so the renamed or updated item appears with its new values within a short time. You don't need to re-index anything yourself.