diff --git a/docs/articles/new-expensify/insights/How-to-Use-Insights-in-Expensify.md b/docs/articles/new-expensify/insights/How-to-Use-Insights-in-Expensify.md new file mode 100644 index 0000000000000..225ded238bf21 --- /dev/null +++ b/docs/articles/new-expensify/insights/How-to-Use-Insights-in-Expensify.md @@ -0,0 +1,213 @@ +--- +title: How to Use Insights in Expensify +description: Learn how to use Insights to analyze spending trends and make data-driven financial decisions in New Expensify. +keywords: [New Expensify, Insights, spending analysis, expense reports, analytics, Top Spenders, Top Categories, Top Merchants, Spend over time, financial insights, budget analysis, expense trends] +internalScope: Audience is all workspace members. Covers how Insights reports work, how to access them, available report types, grouping logic, view modes, exporting data, and customization. Does not cover troubleshooting individual reports. +--- + +# How to Use Insights in Expensify + +Insights are pre-built reports that help you understand spending patterns and trends without exporting data or creating complex custom searches. Each Insight is a suggested search that groups and analyzes your expense data automatically. + +--- + +## Who can use Insights + +Anyone can use Insights. What you can see depends on your role in the workspace. + +- Regular members can view Insights that include their own submitted expenses. +- Approvers can view Insights that include their own expenses plus expenses submitted to them for approval. +- Workspace Admins can view Insights that include all workspace expenses. +- Auditors can view Insights that include all workspace expenses. + +Insights always respect workspace permissions. You will only see data you’re allowed to access. + +## Where to find Insights + +You can access Insights on both web and mobile. + +1. Click **Reports** in the navigation tabs (on the left on web, or on the bottom on mobile). +2. Scroll to **Insights**. +3. Select an Insight to open the report. + +--- + +# Available Insights + +## Spend over time + +Spend over time shows how total expenses change across a selected date range. + +You can use Spend over time to: + + - Monitor overall spending trends + - Identify increases or decreases in expenses + - Compare spend across months or custom date ranges + - Track seasonal or recurring spending patterns + - Support budgeting and forecasting decisions + +[Learn more about the Spend over time report](https://help.expensify.com/articles/new-expensify/insights/View-the-Spend-over-time-report). + +## Top Spenders + +Top Spenders shows which members submitted the highest total expenses in the previous calendar month. + +You can use Top Spenders to: + +- Identify unusually high spenders +- Monitor employee-level spending patterns +- Evaluate policy compliance +- Support reimbursement and approval reviews + +[Learn more about the Top Spenders report](https://help.expensify.com/articles/new-expensify/insights/View-the-Top-Spenders-report). + +--- + +## Top Categories + +Top Categories shows which expense categories had the highest total spend in the previous calendar month. + +You can use Top Categories to: + +- Understand where most money is being spent by expense type +- Compare spending across categories like Travel, Meals, and Office Supplies +- Make budget allocation decisions + +[Learn more about the Top Categories report](https://help.expensify.com/articles/new-expensify/insights/View-the-Top-Categories-report) + +--- + +## Top Merchants + +Top Merchants shows which merchants or vendors received the highest total payments in the previous calendar month. + +You can use Top Merchants to: + +- Track vendor spending trends +- Identify opportunities for volume discounts +- Monitor subscription and recurring expenses + +[Learn more about the Top Merchants report](https://help.expensify.com/articles/new-expensify/insights/View-the-Top-Merchants-report) + +--- + +## How Insights work + +Each Insight is powered by Expensify's search query engine using grouping filters and operators to: + +- Automatically group expenses by relevant dimensions (employee, category, merchant, time period) +- Calculate totals and counts +- Sort results to show the highest values first +- Update dynamically as new expenses are added + +--- + +## How to switch between views in Insights + +Insights support four viewing modes: + +**Bar View** +Displays grouped results as a bar chart. This is the default view for **Top categories** and makes comparisons easy at a glance. + +**Table View** +Displays grouped data in rows and columns for more detailed analysis. This is the default view for **Top spenders** and simplifies side-by-side comparisons. + +**Line View** +Displays grouped data in a line chart for analyzing trends. This is the default view for **Spend over time** and helps you monitor changes and patterns. + +**Pie view** +Displays grouped data as a pie chart to show proportional distribution. This is the default for **Top merchants** and helps you understand distribution instantly. + +--- + +To switch views: + +1. Open any Insight. +2. Click **View** in the top navigation. +3. Select **Table**, **Bar**, **Line** or **Pie**. + +--- + +## How to customize Insights + +While you can't modify the suggested Insight searches directly, you can: + +- Apply additional date filters +- Filter by workspace or member +- Expand groups to view individual expenses +- Export data to CSV +- Save a modified search + +## How to create a custom spending report using Insights + +If you want to build your own grouped report: + +1. Open an Insight as your starting point. +2. Modify the filters to match your needs. +3. Adjust the date range if needed. +4. Click **Save search** to store your custom version. + +This allows you to automate recurring analysis without rebuilding the search each time. + +[Learn how to use search operators and grouping](https://help.expensify.com/articles/new-expensify/reports-and-expenses/Using-search-operators) + +--- + +## How to export data from an Insight + +Insights cannot export grouped totals directly. However, you can export the underlying expenses. + +To export Insight data: + +1. Open the Insight. +2. Expand a group to show individual expenses. +3. Select the expenses you want to export. +4. Click **Export to CSV**. + +This is helpful for external reporting or sharing detailed data with finance teams. + +--- + +## Grouping options used in Insights + +Insights use grouping operators to summarize expenses. These include: + +- **group-by:from** - Group by employee (who submitted) +- **group-by:category** - Group by expense category +- **group-by:merchant** - Group by merchant or vendor +- **group-by:tag** - Group by expense tags +- **group-by:month** - Group by calendar month +- **group-by:week** - Group by calendar week +- **group-by:quarter** - Group by fiscal quarter +- **group-by:year** - Group by calendar year + +You can use these operators in custom searches to create your own insights and analyze spending from different perspectives. + +[View all available search operators](https://help.expensify.com/articles/new-expensify/reports-and-expenses/Using-search-operators) + +--- + +# FAQ + +## Can I export grouped totals from Insights in Expensify? + +No. Grouped totals cannot be exported directly. You must expand each group and export the individual expenses as a CSV file. + +--- + +## How often do Insights update in Expensify? + +Insights update in realtime as expenses are created, edited, approved, or reimbursed. + +--- + +## Can I change the time period in Insights? + +Yes. Use date filters to adjust the time period. + +Common filters include: + +- `date:this-month` +- `date:last-month` +- `date:year-to-date` +- Custom date ranges diff --git a/docs/articles/new-expensify/insights/View-the-Top-Categories-report.md b/docs/articles/new-expensify/insights/View-the-Top-Categories-report.md index 5923f09e2de8c..913b210201e0a 100644 --- a/docs/articles/new-expensify/insights/View-the-Top-Categories-report.md +++ b/docs/articles/new-expensify/insights/View-the-Top-Categories-report.md @@ -1,7 +1,7 @@ --- title: View the Top Categories report description: Learn how to use the Top Categories report to understand category-level spending trends. -keywords: [New Expensify, Top Categories, expense categories, category spending, monthly spending, Workspace Admin, Approver, Auditor, category insights, expense analytics, report by category] +keywords: [New Expensify, Top Spenders, Top Categories, Top Merchants, Spend over time, expense categories, category spending, monthly spending, Workspace Admin, Approver, Auditor, category insights, expense analytics, report by category] internalScope: Audience is Workspace Admins, Approvers, and Auditors. Covers using the Top Categories suggested search to view expense totals by category. Does not cover employee-level analysis or merchant-level grouping. --- @@ -74,16 +74,21 @@ To create and save a custom report: --- -## How to switch the Top Categories report to table view +## How to switch views in the Top Categories report -By default, the Top Categories report displays a bar chart. The table view shows expense categories sorted in descending order by total spend. +By default, the Top Categories report displays a **Bar** chart. You can also switch to **Line**, **Table** or **Pie** view depending on how you want to analyze your data. + +- **Line** shows spending trends over time. +- **Table** displays merchants in rows sorted by total spend. +- **Pie** shows how data is distributed. To change the view: -1. Click **View** in the top navigation tabs. -2. Select **Table**. +1. Open the Top Categories report. +2. Click **View** in the top navigation. +3. Select **Line**, **Table** or **Pie**. -The table view shows expense categories as rows sorted in descending order by total spend. +The report will update instantly to reflect your selected view. --- @@ -109,12 +114,14 @@ To export expenses: 2. Use filters to group by category and apply the same timeframe. 3. Expand the category group, select the expenses, and click **Export to CSV**. -## What’s the difference between the Top Categories report and the Top Spenders report? +## What’s the difference between the Top Categories report and other Insights reports? -The **Top Categories** report shows the highest-spending **expense categories**, while the **Top Spenders** report shows which **employees** submitted the most expenses. Both reports help identify trends, but from different perspectives: +Each report provides a different view of your spending: -- Use **Top Categories** to track spending by type (e.g., Travel, Meals). -- Use **Top Spenders** to track who is submitting the most expenses. +- **Spend over time** shows how total expenses change over a date range. +- **Top Merchants** shows which vendors received the most payments. +- **Top Categories** shows the highest-spending expense types (e.g., Travel, Meals). +- **Top Spenders** shows which members submitted the most expenses. ## How is the Top Categories report calculated? diff --git a/docs/articles/new-expensify/insights/View-the-Top-Merchants-report.md b/docs/articles/new-expensify/insights/View-the-Top-Merchants-report.md new file mode 100644 index 0000000000000..056ed4fc623ed --- /dev/null +++ b/docs/articles/new-expensify/insights/View-the-Top-Merchants-report.md @@ -0,0 +1,136 @@ +--- +title: View the Top Merchants report +description: Learn how to use the Top Merchants report to understand merchant-level spending trends. +keywords: [New Expensify, Top Merchants, merchant spending, vendor analysis, monthly spending, Workspace Admin, Approver, Auditor, merchant insights, expense analytics, report by merchant] +internalScope: Audience is Workspace Admins, Approvers, and Auditors. Covers using the Top Merchants suggested search to view expense totals by merchant. Does not cover employee-level analysis or category-level grouping. +--- + +# View the Top Merchants report + +The **Top Merchants** report shows which merchants or vendors received the highest total spend last month. It's an easy way to: + +- Understand which vendors are receiving the most payments +- Identify recurring merchant relationships +- Spot trends without exporting data +- Make data-driven purchasing decisions with less effort + +This report is a pre-built suggested search that uses filters to group your expenses by merchant. + +--- + +## Who can use the Top Merchants report + +The Top Merchants report is available to all workspace members on web and mobile. + - **Workspace members** can view top merchants for expenses on reports they've submitted or approved. + - **Workspace Admins** and **Auditors** can view top merchants for all expenses on the workspace. + +--- + +## Where to find the Top Merchants report + +**Web:** +Click **Reports** in the left navigation, then click **Top merchants** under the **Insights** section + +**Mobile:** +Tap **Reports** from the navigation tabs on the bottom, then tap the hamburger menu in the top-right corner. Under **Insights**, tap **Top merchants**. + +--- + +## What the Top Merchants report shows + +The Top Merchants report is powered by Expensify's search query engine using grouping and filters. The report shows: + +- All **merchants** sorted by total spend in the last month +- The **total amount spent** at each merchant +- The **number of expenses** for each merchant + +--- + +## How to interpret the Top Merchants report + +Each merchant entry represents a single vendor or merchant, ordered from highest to lowest total spend. The report shows: + +- **Number of expenses** for that merchant +- **Total amount spent** at that merchant + +Select a merchant to review all expenses included in that grouping. + +--- + +## How to customize the Top Merchants report + +You can adjust filters like status, expense type, or employee to explore spending trends. + +The Top Merchants report is a suggested search template. You cannot save changes directly to this report, but you can create a custom version. + +To create and save a custom report: + +1. Go to the **Reports** or **Expenses** tab. +2. Use filters to adjust the merchant grouping or timeframe. +3. Apply filters and click **Save search** to save your custom report. + +[Learn how to create custom reports](https://help.expensify.com/articles/new-expensify/reports-and-expenses/Using-Reports-in-New-Expensify#How-to-use-Reports-search-query-commands) + +--- + +## How to switch views in the Top Merchants report + +By default, the Top Merchants report displays a **Pie** chart. You can also switch to **Table**, **Bar** or **Line** view depending on how you want to analyze your data. + +- **Table** displays merchants in rows sorted by total spend. +- **Bar** shows merchant totals visually for quick comparison. +- **Line** shows spending trends over time. + +To change the view: + +1. Open the Top Merchants report. +2. Click **View** in the top navigation. +3. Select **Table**, **Bar**, or **Line**. + +The report will update instantly to reflect your selected view. + +--- + +## Ways to use the Top Merchants report + +Workspace Admins and finance teams use the Top Merchants report to: + +- Monitor vendor spending patterns +- Identify opportunities for volume discounts or contract negotiations +- Quickly compare expense volume by vendor +- Track subscription and recurring service costs +- Make purchasing decisions without needing spreadsheets + +--- + +# FAQ + +## Can I export the Top Merchants report? + +The Top Merchants report can't be exported with its grouped totals or summary data directly. However, if you expand each group to reveal the individual expenses, you can then select those expenses and use Export to CSV to download the raw data. + +To export expenses: + +1. Go to the **Reports** or **Expenses** tab. +2. Use filters to group by merchant and apply the same timeframe. +3. Expand the merchant group, select the expenses, and click **Export to CSV**. + +## What's the difference between the Top Merchants report and other insights reports? + +Each report provides a different view of your spending: + +- **Spend over time** shows how total expenses change over a date range. +- **Top Categories** shows the highest-spending expense types (e.g., Travel, Meals). +- **Top Spenders** shows which members submitted the most expenses. + +All reports help identify trends from different perspectives to support better financial decisions. + +## How is the Top Merchants report calculated? + +The report uses all expenses from the previous calendar month and groups them by merchant. It shows the **top 10 merchants** based on total spend. + +## Why do some merchant names look different? + +Merchant names are captured from receipt data and card transactions. The same vendor might appear under different names (e.g., "Amazon.com" vs "AMZN Marketplace"). You may need to review the individual expenses to confirm they're from the same merchant. + +--- diff --git a/docs/articles/new-expensify/insights/View-the-Top-Spenders-report.md b/docs/articles/new-expensify/insights/View-the-Top-Spenders-report.md index c9fafe41625c2..81baea4e8a509 100644 --- a/docs/articles/new-expensify/insights/View-the-Top-Spenders-report.md +++ b/docs/articles/new-expensify/insights/View-the-Top-Spenders-report.md @@ -1,13 +1,13 @@ --- title: View the Top Spenders report description: Learn how Workspace Admins, Approvers, and Auditors can use the Top Spenders report to understand spending trends. -keywords: New Expensify, Top Spenders, employee spending, high spenders, expense trends, Workspace Admin, Approver, Auditor, monthly spending, spending insights, virtual CFO, analytics, insight, budget +keywords: [New Expensify, Top Spenders, Top Categories, Top Merchants, Spend over time, employee spending, high spenders, expense trends, Workspace Admin, Approver, Auditor, monthly spending, spending insights, virtual CFO, analytics, insight, budget] internalScope: Audience is Workspace Admins, Approvers, and Auditors. Covers using the Top Spenders suggested search to view employee-level spending. Does not cover custom reports, exporting data, or grouping by category or merchant. --- -# View the Top Spenders report in New Expensify +# View the Top Spenders report -The **Top Spenders** report shows which employees submitted the highest total expenses last month. It’s a fast way to: +The Top Spenders report shows which employees submitted the highest total expenses last month. It’s a fast way to: - Identify high or unusual spenders - Spot trends without exporting data @@ -19,7 +19,7 @@ This report is a pre-built suggested search so you can review spending activity ## Who can use the Top Spenders report -The **Top Spenders** report is available to Workspace Admins, Approvers, and Auditors on both web and mobile. +The Top Spenders report is available to Workspace Admins, Approvers, and Auditors on both web and mobile. **Note:** Exporting data is only available on web. @@ -33,8 +33,6 @@ Use the navigation tabs on the left and select **Reports**, then click **Top spe **Mobile:** Tap **Reports** from the navigation tabs on the bottom, then tap the hamburger menu in the top-right corner. Under **Insights**, tap **Top spenders**. -![Reports page in New Expensify showing the Top spenders view]({{site.url}}/assets/images/top-spender.png) - --- ## What information the Top Spenders report displays @@ -59,7 +57,7 @@ Click any row to view that member's individual expenses. ## Can you customize the Top Spenders report? -Yes - you can adjust filters like date range, workspace, or employee to explore spending trends. However, the **Top Spenders** report is a built-in suggested search, so you can’t save changes to it directly. +Yes - you can adjust filters like date range, workspace, or employee to explore spending trends. However, the Top Spenders report is a built-in suggested search, so you can’t save changes to it directly. To create and save a custom report: @@ -81,6 +79,24 @@ Workspace Admins and finance teams use the Top Spenders report to: --- +## How to switch views in the Top Spenders report + +By default, the Top Spenders report displays a **Table**. You can also switch to **Bar**, **Line** or **Pie** view depending on how you want to analyze your data. + + - **Bar** shows totals for easy comparison. + - **Line** shows trends over time. + - **Pie** shows how data is distributed. + +To change the view: + +1. Open the Top Spenders report. +2. Click **View** in the top navigation. +3. Select **Bar**, **Line**, or **Pie**. + +The report will update instantly to reflect your selected view. + +--- + # FAQ ## Can you export the Top Spenders report? @@ -91,18 +107,19 @@ Not directly — the Top Spenders report can’t be exported with its grouped to 2. Apply filters to create your own view. 3. Click **Export to CSV**. -## Will more report types like Top Spenders be added? +## What other Insights reports are available? + +Additional Insights reports help you analyze spending from different perspectives: -Yes! Top Spenders is the first of many suggested insights. Upcoming reports will include: +- **Spend over time** shows how total expenses change over a date range. +- **Top Merchants** shows which vendors received the most payments. +- **Top Categories** shows the highest-spending expense types (e.g., Travel, Meals). -- Spend by category -- Spend over time -- Merchant trends -- Other insights visible under the **Reports** tab +[Learn more about all available Insights](https://help.expensify.com/articles/new-expensify/insights/Insights-Overview) ## Can other people see my Top Spenders report? -Only Workspace Admins, Approvers, and Auditors can view a workspace's Top Spenders report. Regular members do not have access. +Only Workspace Admins, Approvers, and Auditors can view a workspace's **Top Spenders** report. Regular members do not have access. ## How is the Top Spenders report calculated? diff --git a/docs/articles/new-expensify/reports-and-expenses/Using-search-operators.md b/docs/articles/new-expensify/reports-and-expenses/Using-search-operators.md index b4c0500dc1ba3..f4fd15164daa8 100644 --- a/docs/articles/new-expensify/reports-and-expenses/Using-search-operators.md +++ b/docs/articles/new-expensify/reports-and-expenses/Using-search-operators.md @@ -58,6 +58,7 @@ type:expense merchant:Starbucks category:Meals amount>20 has:receipt - `tag:` – tag or multiple tags - `amount:` / `purchase-amount:` – supports `=`, `>`, `<`, `>=`, `<=` - `status:` – unreported, draft, outstanding, approved, paid, done +- `date:` – expense date, supports relative dates like `date:this-month`, `date:last-month`, `date:year-to-date`, `date:this-week` - `has:` – attachment, receipt, category, tag - `expense-type:` – cash, card, distance, per-diem - `reimbursable:` and `billable:` – yes or no @@ -66,10 +67,6 @@ type:expense merchant:Starbucks category:Meals amount>20 has:receipt ## Available filters for Reports -``` -type:expense-report status:paid exported:never -``` - - `report-id:` – unique report reference - `status:` – draft, outstanding, approved, paid, done - `submitted:` / `approved:` / `paid:` / `exported:` – supports absolute or relative dates @@ -114,11 +111,17 @@ group-by:merchant group-currency:USD Supported groupings include: -- `group-by:report` -- `group-by:from` -- `group-by:card` -- `group-by:withdrawal-id` -- `group-by:category` +- `group-by:report` - Group by expense report +- `group-by:from` - Group by expense submitter (employee) +- `group-by:card` - Group by payment card +- `group-by:withdrawal-id` - Group by withdrawal ID +- `group-by:merchant` - Group by merchant or vendor +- `group-by:category` - Group by expense category +- `group-by:tag` - Group by expense tag +- `group-by:month` - Group by calendar month +- `group-by:week` - Group by calendar week +- `group-by:quarter` - Group by fiscal quarter +- `group-by:year` - Group by calendar year ---