# Orders — where everything is

> One list of every Etsy order across your connected stores, with costs, tracking, notes and supplier sharing. Every feature on the page, with the exact path to reach it. 86 features. The page itself is at https://eto.tools/dashboard/orders/.

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

## Orders

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

One list of every Etsy order across your connected stores, with costs, tracking, notes and supplier sharing.

### Header controls

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Store filter | Narrows the whole list to one store, and only appears once you have two or more connected. | `Orders > All Stores` (needs connected store) | - |
| Search anything | Searches orders by buyer name, email, phone, city, state, country, status, buyer message, gift message, shop name, product title or exact receipt number. | `Orders > Search anything...` (needs connected store) | `orders_list` |
| Clear search | Empties the search box and reloads the unsearched list. | `Orders > Search anything... > x` | - |
| Share | Opens the dialog that turns your current filters into a supplier link or a CSV. | `Orders > Share` (needs connected store) | - |
| Manage links | Opens the list of supplier links you have already created. | `Orders > (link icon beside Share)` | - |
| Sync Orders | Opens a date-range popover and then fetches fresh orders from Etsy for that window. | `Orders > Sync Orders` (needs connected store) | `orders_sync` |
| Sync date presets | Syncs the last 7, 30, 90, 180 or 365 days from Etsy in one click. | `Orders > Sync Orders > Last 30 days` (needs connected store) | `orders_sync` |
| Sync range calendar | Picks an exact start and end date to sync instead of a preset. | `Orders > Sync Orders > (calendar) > Sync range` (needs connected store) | `orders_sync` |
| No COGS | Toggles the list down to only the orders that have no cost of goods set. | `Orders > No COGS` | - |
| Sync Printify | Matches your orders to Printify orders and pulls their costs and tracking. | `Orders > Sync Printify` (needs Printify connected) | - |
| Import COGs | Opens the spreadsheet importer for bulk cost of goods entry. | `Orders > Import COGs` | - |

### Filter bar

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Date Range | Limits the list to orders from the last 7, 30 or 60 days. | `Orders > Date Range` | - |
| Custom dates | Opens a calendar to pick an exact from and to date for the list. | `Orders > Custom dates` | - |
| Fulfilled | Shows only fulfilled or only unfulfilled orders. | `Orders > Fulfilled` | - |
| Shipped | Shows only physical orders that have shipped, or only those that have not. | `Orders > Shipped` | - |
| Paid | Shows only paid or only unpaid orders. | `Orders > Paid` | - |
| Location | Splits the list into US only or non-US orders. | `Orders > Location` | - |
| Message | Shows only orders that carry a buyer message, or only those that do not. | `Orders > Message` | - |
| Gift | Shows only orders the buyer marked as a gift, or only those they did not. | `Orders > Gift` | - |
| Type | Splits the list into physical, digital or multi-item orders. | `Orders > Type` | - |
| Urgency | Filters by time left to ship: overdue, 1 day left, 2 days left or 2+ days. | `Orders > Urgency` | - |
| Tracking | Filters by supplier tracking state: no tracking, awaiting tracking, tracking ready or fulfilled. | `Orders > Tracking` | - |
| Status | Filters by order state, including cancelled only, refunded only, payment processing only, and the matching hide options. | `Orders > Status` | - |
| Recently Refunded | Shows refunded orders ordered by when the refund was issued rather than when the order was placed. | `Orders > Status > Recently Refunded` | - |
| Fulfilled via | Shows only the orders fulfilled through Printify. | `Orders > Fulfilled via > Printify` | - |
| Clear | Drops every active filter at once and reloads the full list. | `Orders > Clear` | - |
| [Filter deep links](https://eto.tools/dashboard/orders/?order_status_filter=refunded_recent) | The page reads shipped, paid, us, message, gift, digital, shipped_physical, days_remaining, supplier_status, order_status_filter, fulfilled_via, date_from, date_to, days, shop_id and search or q from the URL so a filtered view can be linked to. | `Orders > (URL query string)` | `orders_list` |
| [Order drawer deep link](https://eto.tools/dashboard/orders/?drawer={receipt_id}) | A drawer query parameter opens that order detail drawer as soon as the page paints. | `Orders > (URL query string)` | `order_detail` |

### List, counts and paging

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Status count pills | Counts orders that are paid and not refunded or cancelled, paid and not refunded, paid and not cancelled, just paid, unpaid, and cancelled or refunded. | `Orders > (pill row under the filters)` | - |
| Top summary bar | Shows the total order count, page count and the date span of the orders on screen. | `Orders > (bar above the list)` | - |
| Top page arrows | Steps to the previous or next page from the bar above the list. | `Orders > (bar above the list) > arrows` | - |
| Pagination | Steps through pages from the bottom of the list and shows which range of orders is on screen. | `Orders > Previous / Next` | `orders_list` |
| Reconcile bar | Reports the background check against Etsy for recent order changes, and can be stopped. | `Orders > Checking recent changes with Etsy...` (needs connected store) | - |
| No orders found | The empty state shown when the current filters match nothing. | `Orders > (empty list)` | - |
| [No Store Connected](https://eto.tools/dashboard/stores/) | The empty state with a Connect Store button, shown when you have no Etsy store attached. | `Orders > Connect Store` | - |

### Order row

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Profit flow chips | Shows Subtotal, Fees, Gross Profit, COG, Net Profit and, when refunded, Refunded and Final Net on the row itself. | `Orders > (order row) > profit chips` | - |
| Profit chip popover | Clicking a chip opens the line-by-line breakdown behind that number. | `Orders > (order row) > Fees` | - |
| COG inline input | Types the cost of goods for the item straight into the row without opening the order. | `Orders > (order row) > COG` | - |
| SKU inline edit | Edits and saves the SKU for the item from the row, with the full Eto SKU shown when Etsy truncates it. | `Orders > (order row) > SKU` | - |
| Supplier picker | Assigns a supplier to the listing from the row, for the store or for that product. | `Orders > (order row) > Supplier` | - |
| Copy tracking | Copies the row tracking number to the clipboard. | `Orders > (order row) > (copy icon)` | - |
| Tracking status help | Opens the legend explaining No Tracking, Awaiting Tracking, Tracking Ready and Fulfilled. | `Orders > (order row) > ?` | - |
| Row indicators | Marks orders that carry a buyer Message, are a Gift, or include Custom personalisation. | `Orders > (order row) > Message` | - |
| Ship by countdown | Shows days, hours and minutes left to ship, or how long the order is overdue. | `Orders > (order row) > Ship by` | - |

### Order detail drawer

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Overview tab | Lists receipt id, type, order date, store, buyer, payment method, paid and shipped flags, gift flag and the full money breakdown down to refunds and adjusted total. | `Orders > (order row) > Overview` | `order_detail` |
| Edit buyer field | Edits a buyer detail such as name or address line in place from the Overview tab. | `Orders > (order row) > Overview > (pencil icon)` | - |
| Items tab | Lists each item with variations, quantity, SKU, price and shipping. | `Orders > (order row) > Items` | `order_transactions` |
| Total Cost | Records one cost of goods figure for an item, including its shipping and fees. | `Orders > (order row) > Items > Total Cost` | - |
| Enter per-unit costs | Switches a multi-quantity item to one cost box per unit and totals them for you. | `Orders > (order row) > Items > Enter per-unit costs` | - |
| Use single total | Collapses per-unit costs back to a single total for the item. | `Orders > (order row) > Items > Use single total` | - |
| Tracking tab | Shows the tracking state, Printify tracking, supplier tracking entries grouped by the link they came from, and Etsy shipments. | `Orders > (order row) > Tracking` | - |
| Submit to Etsy | Sends a supplier tracking entry to Etsy as the shipment for this order, with an optional buyer message and a self-notification toggle. | `Orders > (order row) > Tracking > Submit to Etsy` (needs connected store) | `shop_order_tracking` |
| Manual Submit | Types your own tracking number and carrier and submits it to Etsy. | `Orders > (order row) > Tracking > Submit your own tracking to Etsy` (needs connected store) | `shop_order_tracking` |
| Delete tracking entry | Removes a supplier tracking entry and its history from the order. | `Orders > (order row) > Tracking > (x on an entry)` | - |
| Shipping tab | Shows the shipping address, email, phone and SKU as copyable rows, plus supplier tracking and Etsy shipments. | `Orders > (order row) > Shipping` | - |
| Copy All | Copies the whole shipping address as one block. | `Orders > (order row) > Shipping > Copy All` | - |
| Printify / Gelato Format | Copies a US address already laid out the way Printify and Gelato expect it. | `Orders > (order row) > Shipping > Copy Address` (needs US order) | - |
| Payment tab | Shows the price breakdown, payment info and every refund on the order. | `Orders > (order row) > Payment` | `order_payments` |
| Messages tab | Shows the gift information and the buyer message and personalisation text. | `Orders > (order row) > Messages` | - |
| Product tab | Shows the live listing behind the item: images, videos, title, description, details, personalisation, variations, tags and materials. | `Orders > (order row) > Product` (needs connected store) | `listing_detail` |
| Product Source Link | Saves the supplier or AliExpress URL you buy this product from. | `Orders > (order row) > Product > Product Source Link` | - |
| Notes tab | Keeps a free-text note against the order and saves it as you type. | `Orders > (order row) > Notes` | - |
| Printify tab | Connects the Etsy order to a Printify order, or shows and disconnects the one already linked. | `Orders > (order row) > Printify` (needs Printify connected) | - |

### Supplier sharing and export

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Share with Supplier | Creates a public link that shows a supplier only the orders matching your current filters. | `Orders > Share > Create Link` (needs connected store) | - |
| Link Name | Names the supplier link so you can tell it apart later. | `Orders > Share > Link Name` | - |
| Expires | Sets the supplier link to expire after 24h, 7d, 30d, or never. | `Orders > Share > Expires` | - |
| Download CSV | Exports the currently filtered orders as a CSV file. | `Orders > Share > Download CSV` | - |
| CSV Columns | Chooses which columns the CSV includes, with select all and deselect all. | `Orders > Share > (gear icon)` | - |
| Manage Links | Lists your active supplier links and the ones in the trash. | `Orders > (link icon) > Active` | - |
| Link trash | Holds deleted supplier links so they can be restored or removed permanently. | `Orders > (link icon) > Trash` | - |

### COGs import

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Upload File | Takes a CSV or Excel sheet of product costs as the first import step. | `Orders > Import COGs` | - |
| Currency | Says which currency the sheet is in and sets the rate to your store currency. | `Orders > Import COGs > Currency` | - |
| Select Store | Picks which store the imported costs belong to. | `Orders > Import COGs > Select Store` (needs connected store) | - |
| Preview Matches | Shows which sheet rows matched which orders before anything is written. | `Orders > Import COGs > Preview Matches` | - |

### Supplier link page (public)

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| [Supplier order list](https://eto.tools/supplier/{token}/) | The page your supplier opens from a share link, showing only the orders you shared and no seller data. | `Orders > Share > Create Link > (open the link)` (needs share link) | - |
| [Supplier search](https://eto.tools/supplier/{token}/) | Searches the shared orders by order number, name, SKU, product or tracking. | `Orders > Share > Create Link > (open the link) > Search` (needs share link) | - |
| [Supplier status tabs](https://eto.tools/supplier/{token}/) | Switches between pending, overdue, done and all shared orders. | `Orders > Share > Create Link > (open the link) > pending` (needs share link) | - |
| [Supplier filters](https://eto.tools/supplier/{token}/) | Narrows the shared list by country and by product. | `Orders > Share > Create Link > (open the link) > (country select)` (needs share link) | - |
| [Supplier sort](https://eto.tools/supplier/{token}/) | Orders the shared list by ship date, order value, order date, quantity or buyer name, in either direction. | `Orders > Share > Create Link > (open the link) > Ship date` (needs share link) | - |
| [Group by product](https://eto.tools/supplier/{token}/) | Groups the shared orders under the product they are for. | `Orders > Share > Create Link > (open the link) > Group by product` (needs share link) | - |
| [Paste tracking](https://eto.tools/supplier/{token}/) | Bulk-fills tracking numbers by pasting one order number and tracking number per line. | `Orders > Share > Create Link > (open the link) > Paste tracking` (needs share link) | - |
| [Supplier export CSV](https://eto.tools/supplier/{token}/) | Downloads the shared order list as a CSV. | `Orders > Share > Create Link > (open the link) > Export CSV` (needs share link) | - |
| [Supplier bulk actions](https://eto.tools/supplier/{token}/) | With rows selected, marks them done or not done, copies their addresses, or exports just those rows. | `Orders > Share > Create Link > (open the link) > Mark done` (needs share link) | - |
| [Supplier save bar](https://eto.tools/supplier/{token}/) | Holds unsaved tracking edits and writes them back with Save or drops them with Discard. | `Orders > Share > Create Link > (open the link) > Save` (needs share link) | - |
| [Supplier keyboard shortcuts](https://eto.tools/supplier/{token}/) | Cmd or Ctrl plus S saves pending edits, the slash key jumps to search, and Escape closes the paste dialog. | `Orders > Share > Create Link > (open the link)` (needs share link) | - |
| [Supplier display controls](https://eto.tools/supplier/{token}/) | Switches to compact rows, changes the text size, flips the theme, or switches the page between English and Chinese. | `Orders > Share > Create Link > (open the link) > A+` (needs share link) | - |