# Global Search

<p class="doc-lead">Global Search lets you jump to any screen, open a transaction by bill number, look up a customer or item, run a filtered report, or do a quick calculation — from anywhere in Freespace using <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac) or <kbd>CTRL</kbd> + <kbd>SPACE</kbd>.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/dashboard/global-search?id=updates">Latest updates</a>
<a href="#/dashboard/global-search?id=overview">Overview</a>
<a href="#/dashboard/global-search?id=open-search">Open &amp; keyboard shortcuts</a>
<a href="#/dashboard/global-search?id=search-types">Search types</a>
<a href="#/dashboard/global-search?id=filters-help">Filters &amp; help</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Quick ways to search</span>
<div class="doc-toc-links">
<a href="#/dashboard/global-search?id=navigation">Navigate to screens</a>
<a href="#/dashboard/global-search?id=quick-actions">Quick actions</a>
<a href="#/dashboard/global-search?id=short-aliases">Short aliases</a>
<a href="#/dashboard/global-search?id=transactions">Find transactions</a>
<a href="#/dashboard/global-search?id=entities">Find customers, items &amp; more</a>
<a href="#/dashboard/global-search?id=reports">Open reports for an entity</a>
<a href="#/dashboard/global-search?id=calculator">Calculator</a>
<a href="#/dashboard/global-search?id=currency-converter">Currency converter</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/dashboard/global-search?id=pinned-recent">Pinned, favorites &amp; recent</a>
<a href="#/dashboard/global-search?id=faq">FAQ</a>
<a href="#/dashboard/global-search?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="updates">Latest updates</h2>

<ul>
<li><b>Open faster:</b> <kbd>CTRL</kbd> + <kbd>K</kbd> or <kbd>⌘</kbd> + <kbd>K</kbd>, in addition to <kbd>CTRL</kbd> + <kbd>SPACE</kbd></li>
<li><b>Clearer results:</b> one search panel, stronger keyboard highlight, <b>Best match</b>, Create / Go to / Pages / Reports / Records groups, and filter chips</li>
<li><b>Short aliases:</b> <code>it</code> Item Transactions, <code>ie</code> Item Enquiry, <code>cs</code> Customer Statement, <code>ss</code> Supplier Statement, <code>csum</code> Center Summary, <code>home</code> Home</li>
<li><b>Pinned &amp; favorites:</b> Home plus top favorites when you open search; star any result; recent items open the destination directly</li>
<li><b>Calculator:</b> <code>2+2</code> or Excel-style <code>=2+2</code></li>
<li><b>Currency converter</b> (multi-currency): <code>100 USD to INR</code> using exchange rates configured in the system</li>
<li><b>Help:</b> type <code>?</code> for formats and shortcuts</li>
</ul>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Global Search is available on every screen from the top bar. Type a screen name, shortcut, bill number, or entity code and Freespace shows matching results in one panel, grouped by type — **Best Match**, **Create**, **Go to**, **Records**, **Pages**, and **Reports**.

Results respect your **user role and access**; screens and documents you cannot open do not appear. Recently used destinations and exact short aliases (such as <code>it</code> for Item Transactions) rank higher than weak name matches.

<img src="dashboard/images/home-dashboard10.webp" alt="Global search dialog" loading="lazy">

<hr class="doc-section-divider">

<h2 id="open-search">Open &amp; keyboard shortcuts</h2>

| **Action** | **How** |
|------------|---------|
| Open Global Search | Press <kbd>CTRL</kbd> + <kbd>K</kbd> (Windows / Linux), <kbd>⌘</kbd> + <kbd>K</kbd> (Mac), or <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, or click the **search icon** in the top bar |
| Move through results | <kbd>↑</kbd> / <kbd>↓</kbd> arrow keys |
| Open selected result | <kbd>Enter</kbd> |
| Open in a new browser tab | <kbd>Ctrl</kbd> + click the result (or <kbd>Cmd</kbd> + click on Mac), or use the **open in new tab** icon on the row |
| Pin / unpin a favorite | Use the **star** icon on a result row |
| Clear the current query | <kbd>ESC</kbd> (first press) — filter chips reset to **All** |
| Close Global Search | <kbd>ESC</kbd> again when the box is empty, or click the close button |

<hr class="doc-section-divider">

<h2 id="search-types">Search types</h2>

| **Type** | **What you type** | **What happens** |
|----------|-------------------|------------------|
| **Create** | Phrases like <code>new invoice</code>, <code>create customer</code> | Opens a new document or create dialog |
| **Go to** | Shortcuts like <code>home</code>, <code>it</code>, <code>cs</code> | Opens home, common reports, or other go-to actions |
| **Pages** | Screen name or acronym (e.g. <code>sale invoice list</code>, <code>SIL</code>) | Opens a list, form, or settings screen |
| **Reports** | Report name, or <code>reportcode:#entity#</code> | Opens a report (optionally pre-filtered) |
| **Records** | <code>shortcode:#bill number#</code> or <code>shortcode:#name#</code> | Finds bills, customers, items, and similar records |
| **Calculator** | Math expression, or start with <code>=</code> (e.g. <code>=2+2</code>, <code>100*1.18</code>) | Shows the result; click to copy to clipboard |
| **Currency** | <code>100 USD to INR</code> (multi-currency companies) | Converts using exchange rates configured in the system; click to copy |

<hr class="doc-section-divider">

<h2 id="filters-help">Filters &amp; help</h2>

While you type, use the filter chips — **All**, **Create**, **Go to**, **Pages**, **Reports**, **Records** — to narrow the list. Your last chip choice is remembered for the rest of the session when you keep typing; clearing the query shows the home panel again with **All**.

Type <code>?</code> or <code>/</code> in the search box for an in-app help list of formats and short aliases.

Long result groups show the top matches first, with **Show more** when there are additional hits.

<hr class="doc-section-divider">

<h2 id="navigation">Navigate to screens</h2>

Type part of a screen name and Global Search fuzzy-matches against every module list, form, dashboard, and report you have access to. Matches prefer whole words and acronyms over letters in the middle of a word, so short queries stay focused.

<h3 id="acronym-shortcuts">Acronym shortcuts</h3>

Global Search also matches **acronyms** built from screen names — usually the first letter of each word, or all capital letters in the name.

| **Type this** | **Opens** |
|---------------|-----------|
| <code>SIL</code> | Sale Invoice List |
| <code>PIL</code> | Purchase Invoice List |
| <code>SOL</code> | Sale Order List |
| <code>POL</code> | Purchase Order List |
| <code>CUL</code> | Customer List |
| <code>SUL</code> | Supplier List |
| <code>ITL</code> or <code>IL</code> | Item List |
| <code>GRNL</code> | Goods Receipt Note List |
| <code>GDN</code> | Goods Delivery Note List |
| <code>PV</code> | Payment Voucher List |
| <code>RV</code> | Receipt Voucher List |

You can also type natural phrases — for example <code>sale invoice</code>, <code>customer list</code>, <code>stock report</code>, or <code>item code settings</code>.

<hr class="doc-section-divider">

<h2 id="quick-actions">Quick actions</h2>

These phrases jump straight to common create or go-to screens without typing the full menu path. Results are split into **Create** and **Go to**.

<h3 id="create-actions">Create</h3>

| **Type any of these** | **Action** |
|-----------------------|------------|
| <code>new invoice</code>, <code>new sale invoice</code>, <code>create invoice</code> | New Sale Invoice |
| <code>new purchase</code>, <code>new purchase invoice</code>, <code>create purchase</code> | New Purchase Invoice |
| <code>new customer</code>, <code>create customer</code>, <code>add customer</code> | New Customer |
| <code>new supplier</code>, <code>create supplier</code>, <code>add supplier</code> | New Supplier |
| <code>new item</code>, <code>create item</code>, <code>add item</code> | New Item |
| <code>new sale order</code>, <code>create sale order</code> | New Sale Order |
| <code>new purchase order</code>, <code>create purchase order</code> | New Purchase Order |
| <code>new expense</code>, <code>create expense</code>, <code>add expense</code> | New Expense |

<h3 id="go-to-actions">Go to</h3>

| **Type any of these** | **Action** |
|-----------------------|------------|
| <code>home</code>, <code>dashboard</code>, <code>main</code> | Home |
| <code>ie</code>, <code>item enquiry</code> | Item Enquiry |
| <code>it</code>, <code>item transactions</code> | Item Transactions |
| <code>cs</code>, <code>customer statement</code> | Customer Statement |
| <code>ss</code>, <code>supplier statement</code> | Supplier Statement |
| <code>csum</code>, <code>center summary</code> | Center Summary |
| <code>stock report</code>, <code>inventory report</code> | Stock Report |
| <code>item wise enquiry</code>, <code>item-wise enquiry report</code> | Item-wise Enquiry Report |

<hr class="doc-section-divider">

<h2 id="short-aliases">Short aliases</h2>

Some two- and three-letter codes open a specific screen even when other names share the same acronym (for example <code>it</code> prefers **Item Transactions** over **Import Templates**).

| **Type this** | **Opens** |
|---------------|-----------|
| <code>it</code> or <code>itr</code> | Item Transactions |
| <code>ie</code> | Item Enquiry |
| <code>cs</code> | Customer Statement |
| <code>ss</code> | Supplier Statement |
| <code>csum</code> | Center Summary |

> **Note:** <code>it:#code#</code> still looks up an **item** by name or item code. Plain <code>it</code> (with no <code>:#…#</code>) opens **Item Transactions**.

<hr class="doc-section-divider">

<h2 id="transactions">Find transactions</h2>

Use the format <code>shortcode:#bill number#</code>. The bill number can be a full or partial match. A loading indicator appears while records are fetched.

**Format:** <code>shortcode:#billnumber#</code>

| **Code** | **Document** |
|----------|--------------|
| <code>si</code> | Sale Invoice |
| <code>so</code> | Sale Order |
| <code>sq</code> | Sale Quotation |
| <code>sreo</code> | Sale Return Order |
| <code>crn</code> | Credit Note |
| <code>pfi</code> | Pro Forma Invoice |
| <code>ci</code> | Commercial Invoice |
| <code>pi</code> | Purchase Invoice |
| <code>po</code> | Purchase Order |
| <code>wo</code> | Work Order |
| <code>pq</code> | Purchase Quotation |
| <code>den</code> | Debit Note |
| <code>preo</code> | Purchase Return Order |
| <code>dn</code> | Delivery Note |
| <code>rn</code> | Receipt Note |
| <code>pro</code> | Production Order |
| <code>prv</code> | Production Voucher |
| <code>ifp</code> | Issue For Production |
| <code>ifpr</code> | Issue For Production Request |
| <code>rfp</code> | Receipt From Production |
| <code>ex</code> | Expense |
| <code>itv</code> | Import Tax Voucher |
| <code>prex</code> | Prepaid Expense |
| <code>pv</code> | Payment Voucher |
| <code>rv</code> | Receipt Voucher |
| <code>rpdep</code> | RP Deposit / Refund |

**Examples**

| **Search** | **Finds** |
|------------|-----------|
| <code>si:#123#</code> | Sale invoices whose bill number contains <code>123</code> |
| <code>si:#SI-2024-001#</code> | A specific sale invoice |
| <code>po:#456#</code> | Purchase orders matching <code>456</code> |
| <code>pv:#PV100#</code> | Payment vouchers matching <code>PV100</code> |

Select a result to open the transaction in a view dialog. Use <kbd>Ctrl</kbd> + click (or the row’s new-tab icon) to try opening it in a new browser tab.

<hr class="doc-section-divider">

<h2 id="entities">Find customers, items &amp; more</h2>

Use the format <code>shortcode:#search text#</code>. Search matches name, party code, item code, or employee code depending on the entity.

**Format:** <code>shortcode:#name or code#</code>

| **Code** | **Entity** | **Searches by** |
|----------|------------|-----------------|
| <code>cu</code> | Customer | Name, party code |
| <code>su</code> | Supplier | Name, party code |
| <code>it</code> | Item | Name, item code |
| <code>em</code> | Employee | Name, employee code |
| <code>ac</code> | Account | Account name |

**Examples**

| **Search** | **Finds** |
|------------|-----------|
| <code>cu:#acme#</code> | Customers matching <code>acme</code> |
| <code>it:#INV101#</code> | Items matching item code <code>INV101</code> |
| <code>su:#SUP001#</code> | Suppliers matching party code <code>SUP001</code> |
| <code>em:#john#</code> | Employees matching <code>john</code> |

<hr class="doc-section-divider">

<h2 id="reports">Open reports for an entity</h2>

Some reports can be opened directly for a specific customer, supplier, item, or account. Type the report code followed by the entity search.

**Format:** <code>reportcode:#entity name or code#</code>

| **Code** | **Report** | **Entity searched** |
|----------|------------|---------------------|
| <code>cs</code> | Customer Statement | Customer (<code>cu</code>) |
| <code>coi</code> | Customer Outstanding Bills | Customer (<code>cu</code>) |
| <code>ss</code> | Supplier Statement | Supplier (<code>su</code>) |
| <code>ie</code> | Item Enquiry | Item (<code>it</code>) |
| <code>iwer</code> | Item-wise Enquiry Report | Item (<code>it</code>) |
| <code>at</code> | Account Transactions | Account (<code>ac</code>) |

**Examples**

| **Search** | **Opens** |
|------------|-----------|
| <code>cs:#acme trading#</code> | Customer Statement for the matching customer |
| <code>ss:#global supplies#</code> | Supplier Statement for the matching supplier |
| <code>ie:#widget a#</code> | Item Enquiry for the matching item |
| <code>at:#cash account#</code> | Account Transactions for the matching account |

After you pick a result, the report opens with that customer, supplier, item, or account already selected.

<hr class="doc-section-divider">

<h2 id="calculator">Calculator</h2>

Type a math expression directly in Global Search, or start with <code>=</code> (Excel-style) to force calculator mode. Supported operators: <code>+</code>, <code>-</code>, <code>*</code>, <code>/</code>, <code>%</code>, and parentheses.

| **Type** | **Result** |
|----------|------------|
| <code>=2+2</code> | <code>4</code> (calculator-only; no page results mixed in) |
| <code>2+2</code> | <code>4</code> |
| <code>100*1.18</code> | <code>118</code> |
| <code>(50+30)/2</code> | <code>40</code> |
| <code>15%</code> | <code>0.15</code> |

Starting with <code>=</code> is useful when you want a calculation without matching screens. Click a calculator result to **copy the answer** to the clipboard. The search box stays open so you can continue calculating.

<hr class="doc-section-divider">

<h2 id="currency-converter">Currency converter</h2>

If your company has <b>multi-currency</b> enabled, Global Search converts amounts using the exchange rates configured in the system (Settings → Currency) — not live market rates.

**Format:** <code>amount FROM to TO</code> (the word <code>to</code> / <code>in</code> is optional)

| **Type** | **Result** |
|----------|------------|
| <code>100 USD to INR</code> | Converts 100 USD into INR using company rates |
| <code>100 usd inr</code> | Same, without <code>to</code> |
| <code>=8300 INR to USD</code> | Convert-only mode (no other search results) |

The result shows the converted amount and the implied cross rate (for example <code>1 USD = 83 INR</code>). Click the row to **copy** the converted number.

| **If this happens** | **What to do** |
|---------------------|----------------|
| Currency not configured | Add the currency under Settings → Currency |
| No default exchange rate | Set <b>Default Exchange Rate</b> on that currency, then try again |

Clicking an error row opens Currency settings (when you have access). Base currency is always treated as rate <code>1</code>.

<hr class="doc-section-divider">

<h2 id="pinned-recent">Pinned, favorites &amp; recent</h2>

When you open Global Search with an empty box:

| **Section** | **What you see** |
|-------------|------------------|
| **Pinned** | **Home** plus your top **3 favorites** |
| **More favorites** | Additional starred destinations (if you have more than three) |
| **Recent** | Your last **10** opened results — click to open that destination again (not just re-run the typed query) |

Use the **star** on any result to pin or unpin a favorite. Favorites and recent history are stored in your browser. Use the trash icon on Recent to clear history.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>How do I open Global Search?</b><br>
Press <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac), press <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, or click the search icon in the top bar.</p>

<p><b>Why does nothing show for a screen I know exists?</b><br>
Global Search only lists screens and documents your user role can access. Ask an administrator to grant the missing permission.</p>

<p><b>How do I open Sale Invoice list quickly?</b><br>
Open Global Search, then type <code>SIL</code> or <code>sale invoice list</code>.</p>

<p><b>How do I open Item Transactions quickly?</b><br>
Type <code>it</code> or <code>item transactions</code>. To look up an item record instead, use <code>it:#item code#</code>.</p>

<p><b>How do I find a specific Sale Invoice by number?</b><br>
Type <code>si:#your bill number#</code> — for example <code>si:#123#</code> for partial match or <code>si:#SI-2024-001#</code> for a full number.</p>

<p><b>Can I open a result in a new tab?</b><br>
Yes. Hold <kbd>Ctrl</kbd> (or <kbd>Cmd</kbd> on Mac) and click the result, or use the new-tab icon on the row. This works for navigation screens and most quick actions. New-document dialogs and transaction view modals still open in the current window.</p>

<p><b>Where is help for search formats?</b><br>
Type <code>?</code> or <code>/</code> in the search box for shortcuts and examples.</p>

<p><b>Can I convert currencies in Global Search?</b><br>
Yes, if multi-currency is enabled. Type <code>100 USD to INR</code>. Results use the exchange rates configured in the system under Settings → Currency (not live market rates). If a rate is missing, Global Search tells you to set it there.</p>

<p><b>Does Global Search work offline?</b><br>
Navigation and quick actions work offline. Transaction and entity lookups need a connection to search server data.</p>

<hr class="doc-section-divider">

<h2 id="related">Related &amp; Videos</h2>

<ul>
<li><a href="#/dashboard/README">Home Dashboard</a> — summary tiles, charts, and top-bar quick buttons</li>
<li><a href="#/dashboard/README?id=quick-buttons">Quick buttons</a> — one-click create shortcuts on the top bar</li>
<li><a href="#/dashboard/keyboard-shortcuts">Keyboard shortcuts</a> — list, form, and Global Search keys</li>
</ul>

<b>Video tutorials</b>

<iframe width="560" height="315" src="https://www.youtube.com/embed/gGLfQT7CCbg?si=YgoA5RxuBaIjOmym" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

<iframe width="560" height="315" src="https://www.youtube.com/embed/wOKIUQA3z1A?si=iFeYupnEZOdMP0dY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
