# Dashboard — where everything is

> The account home page: a store header, four tabs, a live order feed, a money statement with a chart, and boards for out-of-stock listings and listing performance. Every feature on the page, with the exact path to reach it. 84 features. The page itself is at https://eto.tools/dashboard/.

Part of [Where everything is](https://eto.tools/dev/docs/where-everything-is.md) in the [Eto API reference](https://eto.tools/dev/docs/).

## Dashboard

- URL: https://eto.tools/dashboard/
- Anchor: https://eto.tools/dev/docs/#where-dashboard
- Markdown: https://eto.tools/dev/docs/where/dashboard.md
- Features: 84

The account home page: a store header, four tabs, a live order feed, a money statement with a chart, and boards for out-of-stock listings and listing performance.

### Store header

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Store switcher | Opens a menu to pick which connected store the whole page reports on. | `Dashboard > store name` (needs connected store) | - |
| Switch store | The menu heading over the store list, with the line "Pick a store to load its numbers". | `Dashboard > store name` (needs connected store) | - |
| Search stores | Filters the store menu by name as you type. | `Dashboard > store name > Search stores` (needs connected store) | - |
| Most sales | Sorts the store menu by lifetime sales, highest first. | `Dashboard > store name > Most sales` (needs connected store) | - |
| Least sales | Sorts the store menu by lifetime sales, lowest first. | `Dashboard > store name > Most sales > Least sales` (needs connected store) | - |
| A to Z | Sorts the store menu alphabetically by shop name. | `Dashboard > store name > Most sales > A to Z` (needs connected store) | - |
| Store stats line | Shows the selected store lifetime sales, its active listing count and a link out to the shop on Etsy. | `Dashboard > store header` (needs connected store) | - |
| Refresh indicator | A spinner and label in the stats line saying that the store numbers are being re-synced right now. | `Dashboard > store header` (needs connected store) | - |
| All stores | Switches the page to a combined view of every connected store instead of one. | `Dashboard > All stores` (needs two or more stores) | - |
| All stores currency settings | Opens the setup modal for the common currency and the per-store conversion rates. | `Dashboard > All stores currency settings` (needs two or more stores) | - |
| [Connect a store](https://eto.tools/dashboard/stores/) | The empty state shown when no store is connected, linking to the Stores page. | `Dashboard > Connect a store` | - |

### All Stores Setup modal

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Convert all to | Sets the three-letter currency every store is converted into for the combined view. | `Dashboard > All stores currency settings > Convert all to` (needs two or more stores) | - |
| Auto-fill rates | Fetches a conversion rate for each store currency into the common currency. | `Dashboard > All stores currency settings > Auto-fill rates` (needs two or more stores) | - |
| Per-store rate list | Lists every store with its own rate field, and notes that stores without a rate are left out. | `Dashboard > All stores currency settings` (needs two or more stores) | - |
| Save & View All Stores | Saves the currency and rates and switches the page into the combined all-stores view. | `Dashboard > All stores currency settings > Save & View All Stores` (needs two or more stores) | - |
| Cancel | Closes the setup modal without saving the currency or rates. | `Dashboard > All stores currency settings > Cancel` (needs two or more stores) | - |

### Tabs

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Home | The default tab: live updates, the money statement and chart, recent orders and latest listings. | `Dashboard > Home` | - |
| Issues | The tab that checks every connected store for broken or expired connections. | `Dashboard > Issues` | - |
| Listings | The tab listing every active listing sitting at zero stock, with a count badge on the tab itself. | `Dashboard > Listings` | - |
| Performance | The tab showing views, favourites and orders per listing over time from the capture history. | `Dashboard > Performance` | - |

### Home tab: Live updates

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| This store only | A toggle that limits the live cards to the store picked in the header. | `Dashboard > Home > Live updates > This store only` | - |
| Order events | A live-streamed list of order events as they arrive, with a connection dot and a running count. | `Dashboard > Home > Order events` | - |
| Clear | Removes every event currently listed in the Order events card. | `Dashboard > Home > Order events > Clear` | - |
| Needs fulfillment | Lists paid orders that have not shipped yet, and says "Every paid order is on its way" when there are none. | `Dashboard > Home > Needs fulfillment` | - |
| Inactive stores | A toggle that also lists unshipped orders from banned, disconnected or deleted stores. | `Dashboard > Home > Needs fulfillment > Inactive stores` | - |
| [View All](https://eto.tools/dashboard/orders/?shipped=false&is_digital=false) | Opens the Orders page filtered to unshipped physical orders. | `Dashboard > Home > Needs fulfillment > View All` | - |

### Home tab: money period and view controls

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Today | Reports the statement, the hero figure and the chart for today only. | `Dashboard > Home > Today` | - |
| Yesterday | Reports the money block for yesterday. | `Dashboard > Home > Yesterday` | - |
| Last 7 days | Reports the money block for the last seven days. | `Dashboard > Home > Last 7 days` | - |
| This Month | Reports the money block for the current calendar month. | `Dashboard > Home > This Month` | - |
| This Year | Reports the money block for the current calendar year. | `Dashboard > Home > This Year` | - |
| Custom | Opens a single-month calendar to pick one day or a date range for the money block. | `Dashboard > Home > Custom` | - |
| Calendar Apply | Applies the day or range picked in the custom calendar. | `Dashboard > Home > Custom > Apply` | - |
| Calendar Clear | Clears the custom date selection and returns to the preset periods. | `Dashboard > Home > Custom > Clear` | - |
| Settled | Shows money on the day it actually moved in the Etsy ledger. | `Dashboard > Home > Settled` | - |
| Outcome | Groups every order by its sale day and pulls later fees and refunds back onto that day. | `Dashboard > Home > Outcome` | - |
| Settled and Outcome help | A hover card that explains the difference between the Settled and Outcome lenses. | `Dashboard > Home > Settled` | - |
| Orders | Plots order counts on the dashboard chart. | `Dashboard > Home > Orders` | - |
| Sales | Plots sales money on the dashboard chart. | `Dashboard > Home > Sales` | - |
| COGS | Plots cost of goods on the dashboard chart. | `Dashboard > Home > COGS` | - |

### Home tab: Statement

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Statement | The money block subtitled "Money in, fees out", running from gross sales down to net profit. | `Dashboard > Home > Statement` | - |
| Gross sales | The total money customers paid in the chosen period. | `Dashboard > Home > Statement` | - |
| Refunds | The money refunded to customers in the chosen period. | `Dashboard > Home > Statement` | - |
| Fees | The Etsy fees charged in the chosen period. | `Dashboard > Home > Statement` | - |
| Ads | The advertising spend in the chosen period. | `Dashboard > Home > Statement` | - |
| Software | The software costs subtracted in the chosen period. | `Dashboard > Home > Statement` | - |
| Gross profit | Gross sales minus refunds, fees, ads and software. | `Dashboard > Home > Statement` | - |
| COGS row | The cost of goods subtracted from gross profit. | `Dashboard > Home > Statement` | - |
| Net profit | The bottom line after cost of goods is taken off gross profit. | `Dashboard > Home > Statement` | - |
| Statement footer | A quiet line with the sale count, the average order value, net sales and the amount paid out. | `Dashboard > Home > Statement` | - |
| [Open Finance page](https://eto.tools/dashboard/finances/) | Leaves the dashboard for the full finance breakdown. | `Dashboard > Home > Statement > Open Finance page` | - |

### Home tab: chart and overlays

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Net profit hero | The large net profit figure for the chosen window, with the change against the previous one. | `Dashboard > Home` | - |
| Verification line | A small line under the hero saying whether the figures were checked against Etsy, and which stores need reconnecting. | `Dashboard > Home` | - |
| Orders chart | The main dashboard chart drawing the chosen measure across the chosen period. | `Dashboard > Home` | - |
| Connect a store overlay | Covers the money block until at least one store is connected, with a link to the Stores page. | `Dashboard > Home` | - |

### Home tab: recent activity

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Recent orders | The last orders across every store, each row opening that order on the Orders page. | `Dashboard > Home > Recent orders` | - |
| [All orders](https://eto.tools/dashboard/orders/) | Opens the Orders page from the Recent orders card. | `Dashboard > Home > Recent orders > All orders` | - |
| Latest listings | The most recently synced listings with price, views, favourites and state. | `Dashboard > Home > Latest listings` | - |
| [Listing manager](https://eto.tools/dashboard/listings/) | Opens the Listing Manager from the Latest listings card. | `Dashboard > Home > Latest listings > Listing manager` | - |

### Issues tab

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Connection check | Walks every connected store one at a time and reports whether its Etsy connection still works. | `Dashboard > Issues > Connection check` (needs connected store) | - |
| Check | Starts the connection check and turns into Stop while it runs. | `Dashboard > Issues > Check` (needs connected store) | - |
| Check progress bar | A bar and an "n / total" counter showing how far through the stores the check is. | `Dashboard > Issues > Check` (needs connected store) | - |
| Needs attention | Lists the stores that failed the check with the reason and a link to reconnect them. | `Dashboard > Issues > Needs attention` (needs connected store) | - |

### Listings tab

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Out of stock | A per-store board of every active listing sitting at zero stock, with an estimate of the money the empty shelf has cost. | `Dashboard > Listings` (needs connected store) | - |
| Search a listing title | Filters the out-of-stock board to listings whose title matches. | `Dashboard > Listings > Search a listing title` (needs connected store) | - |
| 90 days | Prices each out-of-stock listing by what it earned in the last ninety days. | `Dashboard > Listings > 90 days` (needs connected store) | - |
| Lifetime | Prices each out-of-stock listing by what it has earned for all time. | `Dashboard > Listings > Lifetime` (needs connected store) | - |
| Sort the stores | Orders the store groups by out of stock count, revenue, lifetime sales, listing count, store age or name. | `Dashboard > Listings > Sort the stores` (needs two or more stores) | - |
| Flip the sort order | Reverses the store ordering between highest first and lowest first. | `Dashboard > Listings > Flip the sort order` (needs two or more stores) | - |
| Show more | Appends the next page of out-of-stock rows inside one store group without reloading the board. | `Dashboard > Listings > Show more` (needs connected store) | - |
| [Restock](https://eto.tools/dashboard/listings/{shop_id}/{listing_id}/edit/) | Opens that listing in the editor with the quantity field already in view. | `Dashboard > Listings > Restock` (needs connected store) | - |
| Etsy link | Opens the out-of-stock listing on Etsy in a new tab. | `Dashboard > Listings > Etsy` (needs connected store) | - |

### Performance tab

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Listing performance | Views, favourites, listing counts and orders read off the six-hourly capture history. | `Dashboard > Performance` (needs connected store) | - |
| 24 hours | Reports listing performance over the last day. | `Dashboard > Performance > 24 hours` (needs connected store) | - |
| 7 days | Reports listing performance over the last week. | `Dashboard > Performance > 7 days` (needs connected store) | - |
| 30 days | Reports listing performance over the last month. | `Dashboard > Performance > 30 days` (needs connected store) | - |
| Capture now | Records every listing on every store immediately, at most once every six hours. | `Dashboard > Performance > Capture now` (needs connected store) | - |
| Figure strip | Five counters across the top: Views, Favourites, Listings, Sold out and Orders. | `Dashboard > Performance` (needs connected store) | - |
| Capture status line | A mono line saying what the running capture is doing, or when the last one ran and what it cost. | `Dashboard > Performance` (needs connected store) | - |
| Views and favourites over time | A chart of the capture series, hidden until there are at least two captures. | `Dashboard > Performance` (needs connected store) | - |
| Movement | Plots views gained, favourites gained and orders per capture. | `Dashboard > Performance > Movement` (needs connected store) | - |
| Totals | Plots the running total of views and favourites instead of the movement between captures. | `Dashboard > Performance > Totals` (needs connected store) | - |
| Chart legend | Clickable series names that switch each line on the performance chart on or off. | `Dashboard > Performance` (needs connected store) | - |
| Per-store table | One row per store with active, sold out, views, favourites, orders, a views sparkline and the last capture time. | `Dashboard > Performance` (needs connected store) | - |
