Console search opens over the current screen and jumps to a page, an asset, a user, an entity, a contact or a system contract you already know exists. It suits a record you can name by symbol, name or wallet address. To see what exists, use the listing screen instead.
Asset results come from the wallets and roles of one participant: your own, or the participant you work as through Working as. User and entity results follow that participant's roles too. Contacts, pages and system contracts do not change with the participant you work as. Typing a query changes nothing on-chain or in the platform. Choosing a record result opens a page or copies an address. Choosing an “On this page” or “Actions on recent assets” row does what that control does on the page, and the “Ask” row sends your question to the assistant.
Over the current page, the “Search” dialog shows its search field and the “On this page” group of the page's own actions.
Results appear in groups once you type at least two characters.
Steps
Open Console search
Select Search in the top bar, or press ⌘K, or CtrlK outside macOS. The key caps on the button show the one that applies to your computer, and Keyboard shortcuts lists the other keys. Type at least two characters. A shorter query shows “Type at least two characters” until you add another. Results load about 300 milliseconds after you stop typing. A dialog opens over the current page and groups results under these headings, showing only the groups that have a match:
- On this page
- Actions on recent assets
- Pages
- Contacts
- Assets
- Users
- Entities
- System contracts
Review the results
Read the grouped results. Each result shows its name or address so you can confirm you selected the right record before you act. Each record category shows at most 10 results, so a broad query can omit the record you need. Narrow the query rather than assuming a miss means the record does not exist.
Select a result
Selecting a page opens it. Selecting an asset opens its token detail page, a user opens their user detail page, and a contact opens its contact page. Selecting an entity opens its entity detail page when that participant has a provisioned wallet. Without one the row is disabled. Each of these is a link, so you can also open it in a new tab. Selecting a system contract copies its address to your clipboard, because no page shows a system contract. The row is labelled Copy address and the copy shows a “Copied to clipboard” toast, or “Sorry, we couldn't copy that to your clipboard” when the browser refuses clipboard access.
What search covers
The first group, On this page, lists the open page's own actions, tabs and sections, and choosing one runs it, opens it or scrolls to it.
Contacts read your own account, pages follow your own sidebar, and users, entities and system contracts scope to the active organisation and network. Finding your own account by your own wallet address needs you to work as yourself.
Console search lists sidebar pages and five categories of records, and it shows a group only when it has a match:
-
Pages lists up to eight sidebar pages: first those whose name holds every word you type, then those your words describe in other terms, so “what is waiting for me” lists Actions. It lists only pages the sidebar shows you.
-
Contacts lists entries from your personal address book, which stay the same no matter which organisation is active. It still needs the active organisation to have a system to search against. See Troubleshooting if every category comes back empty.
-
Assets lists tokens in the active organisation and network. When the participant you work as holds a system role that grants more than looking up accounts, reading identities and claims, and creating XvP settlements, you see every match. Otherwise you see only assets that one of that participant's wallets holds, or holds an operating role on, such as custodian or supply management, even with no balance. The asset admin role alone does not count. Every user sees the line “Assets your active wallet holds or manages.” under the group, even when their role shows every match.
-
System contracts lists platform-registered contracts on the active network, such as token factories and registries, alongside compliance modules, shown by their contract type and address.
The On this page group comes first. It lists the page's title-row actions, the actions in the asset's Actions menu such as freeze or approve, the page's tabs, and, once you type, the titles of its sections. Every word you type must appear in the label. A recent-asset row also matches the asset's name or symbol. Together, the two groups show at most eight rows. An asset action you cannot run, from the asset's Actions menu or a recent asset, is not a row: once your query names it, a line below the “On this page” and “Actions on recent assets” groups reads “Unavailable:” followed by the action and the reason. While the Console still checks what you can do, the line reads “Checking what you can do:” and names the action. A title-row button you cannot use is left out. Choosing a section closes the dialog, scrolls to it and outlines it briefly. Tabs under “More” are not listed, and neither are the actions or settings of a page you have not opened.
Troubleshooting
Search finds nothing for a term I expect to match
Signal: a query for a setting, a form field, or a menu item on another page returns no result. Cause: search lists sidebar pages by name, the open page's own actions, tabs and sections, and five categories of records: contacts, assets, users, entities, and system contracts. It does not look inside pages you have not opened. Fix: search for the page by its sidebar name, open it, then search again to reach its actions, tabs and sections.
An asset I expect to see is missing
Signal: a token you know exists, and that you believe you should be able to find, does not appear in results. Cause: without a system role beyond the basic lookup permissions, as What search covers explains, search shows only assets that the wallets of the participant you work as hold, or have an operating role on. While you work as someone else, your own wallets do not count. Fix: switch Working as to the participant whose wallet holds or manages the asset, select “Return to yourself” when it is your own, or ask a user with organisation-wide asset access to run the search.
I can't find a user
Signal: a colleague or counterparty you know is registered does not show up under Users. Cause: user results need your own role to include a user-search permission. Without it, that category never populates for anyone but yourself. Fix: without that permission, you can still find your own account by searching your name, your email address or your role name. The Console adds your own record, shown by your name, whenever the query matches one of them, regardless of permission. Your full wallet address finds it too while you work as yourself. For anyone else, ask an administrator to grant user search, or ask them to look the user up on your behalf.
I can't find an entity
Signal: a counterparty organisation or participant you know is registered does not appear under Entities. Cause: this category needs the same entity-list access as the Entities registry. Without it, the category never populates, however exact the query. Beyond permission, names only match the organisation's own participants: pasting the exact address of a multisig your organisation reaches through a signer seat, or of a key that holds a current seat on that multisig, also finds it under its own name, while a name query never does, and adding someone as a member alone does not make their wallets searchable. Fix: ask an administrator to grant entity-list access, or open Entities yourself if you already have it, or ask a colleague with access to look the record up on your behalf.
An entity result cannot be selected
Signal: a row under Entities is greyed out and does not respond. Cause: that participant has no wallet provisioned yet, and entity detail pages are keyed by wallet address, so there is no page to open. Fix: open Entities and provision a wallet for that record.
Every category comes back empty
Signal: a query you expect to match something returns no groups at all, not even Contacts, which does not otherwise depend on the active organisation. Cause: search needs the active organisation to have a system provisioned on the active network. An organisation still being onboarded, or one you have switched to on a network it has no system on, returns nothing for every category until that changes. Fix: switch to a network the organisation has a system on, or finish onboarding it, then run the search again.
Frequently asked questions
Can I search using part of a name or address?
Mostly. Contacts, users, entities, and system contracts match your query as a substring anywhere in the record's name or address, so part of a wallet address or part of a company name is enough. Assets are the exception. A token's name or symbol still matches as a substring anywhere, but a token's address matches only from its start: type 0x followed by an even number of hex digits, or the full address. Without the leading 0x, a fragment matches token names and symbols but not token addresses. Your own account has a further exception, matching your name, email address or role name, covered under “I can't find a user”.
Does search find pages?
Yes. Pages come after the open page's own groups, “On this page” and “Actions on recent assets”, under the heading Pages. Type any word of a sidebar page's name, or ask in your own words: “what is waiting for me” or “my pending approvals” lists Actions, and “show my holdings” lists Portfolio. Search sets aside words such as “what”, “is”, “my” and “show”, and lists a page when each remaining word matches its name or one of its search words. Search lists only the pages the sidebar shows you, so a page you cannot open does not appear.
Can search start an action on an asset I opened earlier?
Yes. Search remembers the last five assets you opened. Type an action such as “mint” and the Actions on recent assets group lists matches like “Mint tokens on NWC”. Choosing one opens the asset and the same sheet its Actions menu opens. The page checks your role and the asset's state again first, so when the Actions menu would refuse the action, you see its reason in a message instead of a sheet. The group stays hidden until you type, and it leaves out the asset you are already on.
Can I ask the assistant a question from search?
Yes, when your organisation has the assistant on and the page has something to ask about. Search then shows an Ask row, and Ask describes how to question the assistant, keep the conversation open beside the page and read its sources.
Does search cover transactions or on-chain events?
No. Search covers only pages, contacts, assets, users, entities and system contracts, so a query for a transaction hash or an event name returns nothing here. Open Activity instead, where Search activity matches an event name or a transaction hash.
Can I search across every organisation I belong to in one query?
No. Assets, users and entities scope to the active organisation and network, so the same query in another organisation can return different matches. Contacts belong to your account, so the same address book returns in every organisation.
Do I need to press Enter to run the search?
No. The query runs on its own, about 300 milliseconds after you stop typing. Enter chooses the selected result, as a click would. The dialog selects the first result when results load, so Enter opens or copies that top result. Press the down arrow first to choose another.