# Home Dashboard

<p class="doc-lead">The Home Dashboard is the main landing page after login. It gives a live view of sales, collections, and expenses through summary tiles, charts, and filters — plus quick buttons, global search, and access to user and company settings from the top bar.</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/README?id=overview">Overview</a>
<a href="#/dashboard/README?id=customize">Customize Home</a>
<a href="#/dashboard/README?id=pinned-widgets">Pinned Reports &amp; Transactions</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Widgets &amp; graphs</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=filters">Filters</a>
<a href="#/dashboard/README?id=summary-tiles">Summary tiles</a>
<a href="#/dashboard/README?id=graphs">Graphs</a>
<a href="#/dashboard/README?id=quick-buttons">Quick buttons</a>
<a href="#/dashboard/global-search">Global search</a>
<a href="#/dashboard/freespace-assistant">Freespace Assistant</a>
<a href="#/dashboard/keyboard-shortcuts">Keyboard shortcuts</a>
<a href="#/dashboard/reports">Reports page</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Account</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=user-icon">User icon options</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=faq">FAQ</a>
<a href="#/dashboard/README?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

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

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

After login you land on the **Home Dashboard** (unless your role opens a different module dashboard). Until you customize it, Home shows the standard tiles and charts below. After you save a layout, Home shows <b>only</b> the widgets you chose. What you can add still depends on your **user role** and access settings.

<b>Home Dashboard</b>

<img src="dashboard/images/home-dashboard.webp" alt="Home Dashboard showing summary tiles, graphs, and filters" loading="lazy">

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

<h2 id="customize">Customize Home</h2>

The grid icon on the right of the Home header opens Customize. Each user saves their own Home.

<ul>
<li><b>Add widget</b> — search or filter by module (Accounts, Sales, Purchase, Inventory, HR, Production, CRM, Jobs, Home) and Add or Remove cards. <b>Done</b> closes the picker. Under <b>Accounts</b> you can add <a href="#/accounts/accounts-dashboard?id=receivables-ageing">Receivables Ageing</a> and <a href="#/accounts/accounts-dashboard?id=top-overdue">Top Overdue Customers</a> when your role includes those widgets. They are not on the original Home until you add them.</li>
<li>On the preview, drag the bar to reorder (the page scrolls when you drag near the top or bottom edge), pick Full / Half / Third / Quarter, or remove a widget.</li>
<li><b>Save</b> stores that layout. Home then shows only those widgets.</li>
<li><b>Reset to default</b> puts back the original Home (Employee Summary, Sale and Purchase, Income and Expense, open invoices, expense pie, receivables, month sales/purchase, payables, cash in hand). Save to keep it, or Cancel to leave your previous layout.</li>
<li><b>Cancel</b> (red) leaves Customize without saving.</li>
</ul>

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

<h2 id="pinned-widgets">Pinned Reports &amp; Transactions</h2>

Two Home widgets keep the screens you use every day one click away: <b>Pinned Reports</b> and <b>Pinned Transactions</b>. Add them from <a href="#/dashboard/README?id=customize">Customize Home</a> → Add widget → module <b>Home</b>, then <b>Save</b>. Each is a half-width widget.

<ul>
<li><b>Pin</b> — click <b>Pin</b> on the widget. A picker opens with search and module chips (All, Accounts, Sales, Purchase, Inventory, and the other modules you have). Click <b>Pin</b> or <b>Unpin</b> on a row. <b>Done</b> closes the picker.</li>
<li><b>Limit</b> — up to <b>10</b> pins on each widget. The count (for example 4/10) shows in the widget header. Pins are listed in the order you pinned them.</li>
<li><b>Reports</b> — the same reports as the <a href="#/dashboard/reports">Reports page</a>, limited to those your role can open.</li>
<li><b>Transactions</b> — list screens such as Sale Invoice, Purchase Orders, Inventory Transfer, Material Request, Production Order, Pay Run, and My profile requests. Only screens your role can open are offered.</li>
<li><b>Open</b> — click a name to open the report or list. On a transaction, <b>+</b> opens a new document when you have create permission. The new-tab icon opens the screen in another browser tab.</li>
<li><b>Saved on your user</b> — pins follow you to another computer or browser. <b>My reports</b> on the Reports page is separate and stays in one browser.</li>
<li>If your role later loses access to a pinned screen, it no longer shows in the widget.</li>
</ul>

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

<h2 id="filters">Filters</h2>

At the top of the dashboard, filter all summary tiles, graphs, and linked data:

| **Filter** | **What it does** |
|------------|------------------|
| **Branch** | View data for a specific branch |
| **Employee** | View employee-specific transactions and performance |
| **Date** | Filter summary data, graphs, and transactions by a selected date range |

<img src="dashboard/images/home-dashboard4.webp" alt="Employee filter on Home Dashboard" loading="lazy">

*Figure: Employee filter*

<img src="dashboard/images/home-dashboard3.webp" alt="Date filter on Home Dashboard" loading="lazy">

*Figure: Date filter*

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

<h2 id="summary-tiles">Summary tiles</h2>

The top row shows headline figures for the selected filters. Each tile is **clickable** and opens the related transaction list or report.

<img src="dashboard/images/home-dashboard5.webp" alt="Summary tiles on Home Dashboard" loading="lazy">

| **Tile** | **What it shows** |
|----------|-------------------|
| **Total Sales** | Approved and closed sale invoices in the period: cash, bank, digital wallet, <a href="#/sales/sale-invoice?id=split-payment">split</a>, credit, and prepaid. Opening invoices are excluded. |
| **Cash Sales** | Cash, bank, digital wallet, and split invoices. A split invoice counts as its full invoice total. |
| **Credit Sales** | Sales on credit |
| **Credit Notes** | Credit note totals |
| **Open Sale Invoices** | Outstanding sale invoices |
| **Expense Claims** | Expense claim totals |
| **Total Collection** | Collections received. Split invoices are included here, because they are settled to cash or bank on the invoice. |
| **Preapproved Invoices** | Preapproved sale invoices |

> **Note:** All summary data updates when you change branch, employee, or date filters.

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

<h2 id="graphs">Graphs</h2>

Three charts sit below the summary tiles. Each responds to the date filter at the top of the dashboard.

| **Chart** | **What it shows** |
|-----------|-------------------|
| **Sales &amp; Purchase** | Monthly and daily sales and purchase performance |
| **Income &amp; Expense** | Income vs. expenses for the selected period |
| **Expense pie chart** | Breakdown of expense categories |

<img src="dashboard/images/home-dashboard6.webp" alt="Sales and Purchase graph" loading="lazy" width="600">

*Figure: Sales &amp; Purchase graph*

<img src="dashboard/images/home-dashboard7.webp" alt="Income and Expense graph" loading="lazy" width="600">

*Figure: Income &amp; Expense graph*

<img src="dashboard/images/home-dashboard8.webp" alt="Expense category pie chart" loading="lazy" width="600">

*Figure: Expense pie chart*

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

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

The top bar includes shortcuts to common actions and navigation.

<img src="dashboard/images/home-dashboard9.webp" alt="Quick buttons on Home Dashboard" loading="lazy">

| **Control** | **What it does** |
|-------------|------------------|
| **Quick buttons** | Create Purchase Invoice, Sale Invoice, Customer, Inventory Transfer, Item Enquiry, and more |
| **Home button** | Return to the Home Dashboard from any screen |

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

<h2 id="global-search">Global search</h2>

Press <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac), <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, or click the search icon in the top bar to search screens, transactions, customers, items, and reports from anywhere in Freespace.

| **Shortcut** | **Action** |
|--------------|------------|
| <kbd>CTRL</kbd> + <kbd>K</kbd> / <kbd>⌘</kbd> + <kbd>K</kbd> | Open Global Search |
| <kbd>CTRL</kbd> + <kbd>SPACE</kbd> | Open Global Search (also supported) |
| <code>SIL</code> | Jump to Sale Invoice list |
| <code>it</code> | Open Item Transactions |
| <code>si:#123#</code> | Find sale invoices matching bill number <code>123</code> |

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

See the full guide for acronym shortcuts, transaction codes, entity lookup, report shortcuts, quick actions, and the built-in calculator: <a href="#/dashboard/global-search">Global Search</a>.

For save, approve, list navigation, and Payment In shortcuts: <a href="#/dashboard/keyboard-shortcuts">Keyboard Shortcuts</a>.

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

<h2 id="freespace-assistant">Freespace Assistant</h2>

Click **Ask AI** in the top bar, or press <kbd>?</kbd> when you are not typing in a field, to ask how to do something in Freespace ERP or the Field Sale App. Answers come from this documentation, with links to the full pages. On an error or warning message, click **Ask** to see what it means and how to fix it.

See <a href="#/dashboard/freespace-assistant">Freespace Assistant</a>.

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

<h2 id="user-icon">User icon options</h2>

Click the **User icon** in the top bar to open profile, user settings, company details, company settings, and transaction preferences.

<img src="dashboard/images/home-dashboard11.webp" alt="User icon menu options" loading="lazy">

| **Menu item** | **What it does** | **Full documentation** |
|---------------|------------------|------------------------|
| **Username** | View and edit user details, add signature, enable OTP, change password and username | <a href="#/settings/user-profile">My Profile</a> |
| **User Settings** | Per-user defaults (Field Sale App access, sale type, cash account), price/discount restrictions, and advanced transaction rules | <a href="#/settings/user-management?id=user-settings">Users → User Settings</a> |
| **Company Name** | Company details, bill header, registration numbers (GSTN, CIN, PAN, TRN, VAT), seal, custom fields, rounding rules | <a href="#/settings/company-details">Company Details</a> |
| **Company Settings** | Company-wide transaction defaults, rounding, and registration — affects all users | <a href="#/settings/company-settings">Company Settings</a> |
| **Transaction Preference** | Global transaction behaviour: future dates, tax method, due dates, bill centres, number series, receipt and payment voucher footer notes | <a href="#/settings/transaction-preferences">Transaction Preference</a> |

<img src="dashboard/images/home-dashboard12.webp" alt="User profile details" loading="lazy">

*Figure: User profile*

<img src="dashboard/images/home-dashboard13.webp" alt="User settings" loading="lazy">

*Figure: User settings*

<img src="dashboard/images/home-dashboard14.webp" alt="Company details" loading="lazy">

*Figure: Company details*

<img src="dashboard/images/home-dashboard15.webp" alt="Company settings" loading="lazy">

*Figure: Company settings*

<img src="dashboard/images/home-dashboard16.webp" alt="Transaction preference" loading="lazy">

*Figure: Transaction preference*

See the linked settings pages for the complete field reference for each screen.

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

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

<b>What does the Sales &amp; Purchase graph show?</b><br>
Monthly and daily sales and purchase performance for the selected date filter. See <a href="#/dashboard/README?id=graphs">Graphs</a>.

<b>How do I change which widgets are on Home?</b><br>
Click the grid icon on the right of the Home header, add or arrange widgets, then <b>Save</b>. <b>Reset to default</b> restores the original Home. See <a href="#/dashboard/README?id=customize">Customize Home</a>.

<b>How do I put Receivables Ageing on Home?</b><br>
Customize → <b>Accounts</b> → add <b>Receivables Ageing</b> or <b>Top Overdue Customers</b>, then <b>Save</b>. Your role must include that widget. Details are on the <a href="#/accounts/accounts-dashboard?id=receivables-ageing">Accounts Dashboard</a>.

<b>How can I filter dashboard data?</b><br>
On the original Home, use the **Branch**, **Employee**, or **Date** filters at the top of the dashboard. All summary tiles and charts update when you change a filter. See <a href="#/dashboard/README?id=filters">Filters</a>.

<b>Are summary tiles clickable?</b><br>
Yes. Each tile opens the related transaction list or report for the current filter. See <a href="#/dashboard/README?id=summary-tiles">Summary tiles</a>.

<b>How do I open global search?</b><br>
Press <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac), or <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, from anywhere in Freespace. See <a href="#/dashboard/global-search">Global Search</a>.

<b>Where can I change my password?</b><br>
User icon → **Username** → **Change Password**. See <a href="#/settings/user-profile">My Profile</a>.

<b>How do I prevent previous-day entries or cancellations for a user?</b><br>
User icon → **User Settings** → enable **Prevent previous date entry** or **Prevent cancel with allowed days**. See <a href="#/settings/user-management?id=user-settings">Users → User Settings</a>.

<b>Can I add a user signature on all transactions?</b><br>
User icon → **Username** → edit profile and add the signature in the **Other** section. See <a href="#/settings/user-profile">My Profile</a>.

<b>Can I add a company seal on all transactions?</b><br>
User icon → **Company Name** → **Other** section (**Company image**). See <a href="#/settings/company-details">Company Details</a>.

<b>How can I hide the company name in transactions?</b><br>
User icon → **Transaction Preference** → enable **Hide company name in view**. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Where do I set a footer note?</b><br>
Web sale documents: <b>Sales → Settings → Sale Types</b> — each sale type has its own footer note, and the document shows the note of the selected sale type. Field Sale App prints: <b>Settings → Field Sale → App Settings</b> → <b>Custom Footer in Print</b>. Purchase documents: <b>Purchase → Settings → Purchase Types</b>. Receipt and payment vouchers on the web: User icon → <b>Transaction Preference</b> → <b>Footer Notes</b>. Delivery notes: <b>Inventory Settings</b> → <b>Delivery Note Footer Note</b>. See <a href="#/sales/sale-types">Sale Types</a>, <a href="#/settings/field-sale-app-settings">Field Sale App Settings</a>, <a href="#/purchase/purchase-types">Purchase Types</a>, <a href="#/settings/transaction-preferences?id=footer-notes">Transaction Preference</a>, and <a href="#/inventory/inventory-settings?id=footer-notes">Inventory Settings</a>.

<b>Can I restrict future-date transactions?</b><br>
User icon → **Transaction Preference** → disable **Allow future date transactions**. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I select multiple sale types or purchase types in invoices?</b><br>
User icon → **Transaction Preference** → enable **Multiple Sale Types** or **Multiple Purchase Types** in Number Settings. See <a href="#/settings/transaction-preferences">Transaction Preference</a> and <a href="#/settings/number-settings">Number Settings</a>.

<b>Can I assign cost centers in expenses?</b><br>
User icon → **Transaction Preference** → enable **Show Cost Center Field in Expense** and choose single or multiple cost center mode. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I show Currency on some transactions only?</b><br>
User icon → **Transaction Preference** → **Transactions with currency support**. Requires multi-currency on Company Settings. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I configure rounding rules and default values for a company?</b><br>
User icon → **Company Name** or **Company Settings**. See <a href="#/settings/company-details">Company Details</a> and <a href="#/settings/company-settings">Company Settings</a>.

<b>Can I configure default values for a user?</b><br>
User icon → **User Settings** → **Default Values, Visibility &amp; Filter**. See <a href="#/settings/user-management?id=user-settings">Users → User Settings</a>.

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

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

<ul>
<li><a href="#/settings/user-profile">My Profile</a> — User icon → <b>Username</b>: password, OTP, signature.</li>
<li><a href="#/settings/user-management?id=user-settings">Users → User Settings</a> — User icon → <b>User Settings</b>: per-user defaults and restrictions.</li>
<li><a href="#/settings/company-details">Company Details</a> — User icon → <b>Company Name</b>: registration numbers, seal, bill header.</li>
<li><a href="#/settings/company-settings">Company Settings</a> — User icon → <b>Company Settings</b>: company-wide defaults and rounding.</li>
<li><a href="#/settings/transaction-preferences">Transaction Preference</a> — User icon → <b>Transaction Preference</b>: global transaction behaviour.</li>
<li><a href="#/settings/user-management">User Management</a> — create users and assign roles (admin).</li>
<li><a href="#/dashboard/reports">Reports page</a> — find and pin reports from the top bar.</li>
</ul>

<b>Video — Home Dashboard overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/Bop5X88ngDM?si=mGjJDEp0ltvZQ0Fk" 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>
