# Stores — where everything is

> Connect Etsy shops to Eto and control what each one shows on the rest of the app. Every feature on the page, with the exact path to reach it. 45 features. The page itself is at https://eto.tools/dashboard/stores/.

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

## Stores

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

Connect Etsy shops to Eto and control what each one shows on the rest of the app.

### Connecting a store

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Add store | Starts the Etsy OAuth flow and opens the connect panel with the authorisation link. | `Stores > Add store` | - |
| Connect your Etsy store panel | Shows the generated Etsy authorisation link and waits for Etsy to call back. | `Stores > Add store > Connect your Etsy store` | - |
| Copy link | Copies the Etsy authorisation URL to the clipboard and starts polling for the callback. | `Stores > Add store > Copy link` | - |
| Cancel | Closes the connect panel and stops listening for the Etsy callback. | `Stores > Add store > Cancel` | - |
| Connected shop | Shows the shop name Etsy returned once the callback lands, then reloads the store list. | `Stores > Add store > Connected shop` | - |
| Store connection limit warning | Blocks a new connection and offers an upgrade when the plan store limit is already used up. | `Stores > Add store` | - |

### Store list

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Your stores | Lists every connected shop as a card with its icon, shop id and active listing count. | `Stores` | `stores_list` |
| Refresh from Etsy | Re-pulls the shop list from Etsy and updates the cards in place. | `Stores > Refresh from Etsy` (needs connected store) | `store_sync` |
| Search stores | Filters the cards by shop name as you type; only appears once two or more stores are connected. | `Stores > Search stores...` | - |
| Clear search | Empties the search field and shows every store again. | `Stores > Search stores... > Clear search` | - |
| All | Shows every connected store and carries a live count. | `Stores > All` | - |
| Hidden | Shows only stores that are hidden from at least one page or dashboard panel. | `Stores > Hidden` | - |
| Select all | Ticks every store currently on screen, so a filter or search narrows what gets selected. | `Stores > Select all` | - |

### Store card

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| [Store name link](https://eto.tools/dashboard/stores/{shop_id}/) | Opens the per-store detail page; only clickable once details have been loaded. | `Stores > store card > shop name` | `store_detail` |
| Load details | Fetches the shop profile from Etsy for a store that has never been synced. | `Stores > store card > Load details` (needs connected store) | `store_sync` |
| Refresh store details | Re-fetches that one shop profile from Etsy and updates its card. | `Stores > store card > refresh icon` (needs connected store) | `store_sync` |
| Disconnect store | Opens the disconnect confirmation for that store. | `Stores > store card > close icon` | - |
| Disconnect store? modal | Confirms removing the store from Eto; the card disappears at once and the cascade runs in the background. | `Stores > store card > close icon > Disconnect` | - |
| Order notifications | Switch that turns on a notification in Eto whenever that store takes an order. | `Stores > store card > Order notifications` (needs connected store) | - |
| Visibility | Expands the per-store panel of switches that hide the shop from individual pages. | `Stores > store card > Visibility` | - |
| Hide on pages: Orders | Hides this store from the Orders page. | `Stores > store card > Visibility > Hide on pages > Orders` | - |
| Hide on pages: Finance | Hides this store from the Finance page. | `Stores > store card > Visibility > Hide on pages > Finance` | - |
| Hide on pages: Listings | Hides this store from the Listing Manager store chips. | `Stores > store card > Visibility > Hide on pages > Listings` | - |
| Hide on dashboard: Orders | Hides this store from the dashboard order feeds. | `Stores > store card > Visibility > Hide on dashboard > Orders` | - |
| Hide on dashboard: Finances | Hides this store from the dashboard finance figures. | `Stores > store card > Visibility > Hide on dashboard > Finances` | - |
| Hide on dashboard: Entire store | Hides the store from the dashboard completely and locks the two dashboard sub-switches on. | `Stores > store card > Visibility > Hide on dashboard > Entire store` | - |

### Bulk actions

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| Selected count bar | Floating bar that appears as soon as one store card is ticked. | `Stores > store card checkbox` | - |
| Select all | Selects every store that passes the current filter and search. | `Stores > store card checkbox > Select all` | - |
| Clear | Drops the whole selection. | `Stores > store card checkbox > Clear` | - |
| Notifications on | Turns order notifications on for every selected store at once. | `Stores > store card checkbox > Notifications on` (needs connected store) | - |
| Notifications off | Turns order notifications off for every selected store at once. | `Stores > store card checkbox > Notifications off` (needs connected store) | - |
| Visibility menu | Opens a menu that hides or shows every selected store on one page at a time. | `Stores > store card checkbox > Visibility` | - |
| Hide on pages rows | Show and Hide buttons that set Orders, Finance or Listings visibility for the whole selection. | `Stores > store card checkbox > Visibility > Hide on pages` | - |
| Hide on dashboard rows | Show and Hide buttons that set dashboard Orders, Finances or Entire store visibility for the whole selection. | `Stores > store card checkbox > Visibility > Hide on dashboard` | - |

### Store detail page

| Feature | What it does | Where | API |
| --- | --- | --- | --- |
| [Load Store Stats](https://eto.tools/dashboard/stores/{shop_id}/) | Fetches the shop profile, stats and shipping profiles from Etsy for a store with no data yet. | `Stores > store card > shop name > Load Store Stats` (needs connected store) | `store_sync` |
| [Refresh](https://eto.tools/dashboard/stores/{shop_id}/) | Re-pulls this shop profile from Etsy and reloads the page with the fresh figures. | `Stores > store card > shop name > Refresh` (needs connected store) | `store_sync` |
| [View on Etsy](https://eto.tools/dashboard/stores/{shop_id}/) | Opens the public shop page on Etsy in a new tab. | `Stores > store card > shop name > View on Etsy` | - |
| [Stats row](https://eto.tools/dashboard/stores/{shop_id}/) | Shows active listings, total sales, favourers and review average for the shop. | `Stores > store card > shop name` | `store_details_cached` |
| [Order Notifications](https://eto.tools/dashboard/stores/{shop_id}/) | Switch that turns Etsy order webhooks for this store into Eto notifications. | `Stores > store card > shop name > Order Notifications` (needs connected store) | - |
| [Shop Information](https://eto.tools/dashboard/stores/{shop_id}/) | Lists currency, shipping-from country, location, languages and the shop creation date. | `Stores > store card > shop name > Shop Information` | `store_details_cached` |
| [Shop Status](https://eto.tools/dashboard/stores/{shop_id}/) | Shows vacation mode, custom requests, Etsy Payments and Direct Checkout state. | `Stores > store card > shop name > Shop Status` | `store_details_cached` |
| [Shipping Profiles](https://eto.tools/dashboard/stores/{shop_id}/) | Lists each saved shipping profile with processing and delivery times, method, carrier and cost. | `Stores > store card > shop name > Shipping Profiles` (needs connected store) | `shipping_profiles_live` |
| [Shop Announcement](https://eto.tools/dashboard/stores/{shop_id}/) | Shows the shop announcement text pulled from Etsy. | `Stores > store card > shop name > Shop Announcement` | `store_details_cached` |
| [Digital Sale Message](https://eto.tools/dashboard/stores/{shop_id}/) | Shows the message Etsy sends to buyers of digital items. | `Stores > store card > shop name > Digital Sale Message` | `store_details_cached` |
| Back to stores | Returns to the store list. | `Stores > store card > shop name > back arrow` | - |