Because "that one document I saved somewhere" is not a filing system.

#What It Does

Folders let you organize your documents into named collections, exactly like file folders on a computer — except these are searchable, the AI knows what's inside them, and they look considerably nicer than a manila envelope. Group your receipts together, keep warranties in their own folder, stash medical records separately, or create whatever structure makes sense for your life.

You can nest folders inside other folders, move documents between them, and let the AI generate custom icons that give you a visual hint of what's inside. It's the kind of organization that feels satisfying without requiring a label maker.

#Document folders and inventory folders

A folder holds one kind of thing — documents or inventory items, never both. That's why the Docs tab and the Inventory tab show different folders: your "Receipts" folder holds documents, your "Music" folder holds items, and neither clutters up the other's view.

Anywhere you pick a destination — moving things, filing a chat attachment, saving a generated image — you'll only be offered folders that can hold what you're filing. A new folder created from one of those pickers is made for that kind.

If you (or your AI) try to put an item into a documents folder, or a document into an inventory folder, it is refused and nothing moves — your AI is told why and picks or makes a folder of the right kind. A folder made inside another folder is the same kind as the one it sits in. That way an inventory folder never turns up on the Docs tab looking empty, and a document never hides in a folder the Docs tab doesn't show.

#How to Use It

#The Default Folder

Every account starts with My Documents as the root folder. This is home base — all documents land here unless you specify otherwise. You can create as many subfolders as you like inside it.

#Special Folders

  • Don't Panic — The help guides folder (the one you're reading right now). It's pinned to the top of your documents list so it's always easy to find. You can't rename, move or delete it — the app doesn't offer those on this folder — which is exactly the kind of guardrail a help folder should have.
  • Receipts — A common default for uploaded purchase records.

#iOS App

Creating a folder:

  1. Open the Context tab, then Docs
  2. Tap the New Folder button
  3. Enter a name for your folder
  4. The folder appears in your current location, ready to receive documents

Navigating folders:

  • Tap a folder card to open it and see its contents
  • The breadcrumb trail at the top shows your current path (e.g., My Documents > Receipts > 2026)
  • Tap any breadcrumb to jump back to that level — no need to hit the back button repeatedly

Moving documents:

  1. Enter selection mode by tapping Select, or long-press a document and choose Select (to move just one, long-press it and choose Move to Folder…)
  2. Tap to select the documents you want to move
  3. Tap the Move action
  4. Choose the destination folder
  5. Documents are moved instantly. If any of them can't move — one of ambientChat's own help pages, say — the rest still do, and you're told how many moved and why the others stayed
  6. Dropped them in the wrong place? Tap Undo on the notice and every document goes back to the folder it came from — one tap for the whole selection. Asking your AI to move a document gives the same Undo, and "undo that" works too

Selecting many at once, folders included:

  • In selection mode, slide your finger sideways across the cards to tick them all in one go, the way Photos does — everything from the card you start on to the card under your finger. Start on a ticked card and the slide unticks instead. Hold your finger near the top or bottom edge and the list scrolls, ticking as it goes. An up-and-down swipe still scrolls
  • Folders tick too. In selection mode, tapping a folder ticks it rather than opening it
  • Hold any ticked card and drag — the whole selection comes with it, items and folders together, onto a folder, a breadcrumb or the round up button. A badge on the card you're carrying says how many things are moving
  • With a folder ticked, the only button is Move — it moves everything ticked. Delete, Print and Export are for items and documents, so they come back when only those are ticked
  • A selection never lands inside a folder it holds: those folders don't light up, and the Move list leaves them out
  • One notice says what moved and where, with one Undo for the lot — and Select switches itself off, as it does after Move. Drag one card you didn't tick and only that card moves: your ticks stay as they were

Managing a folder (rename, edit, delete):

  1. Long-press a folder to open its actions sheet
  2. Choose Rename to fix a typo or rethink a name, Edit to change its details, or Delete to remove it
  3. Deleting a folder that isn't empty asks first, and says what will go to Trash — counting the receipts and manuals filed in other folders that only its items use
  4. Deleting offers an Undo — if you tap it by mistake, the folder comes right back, with everything that went with it

This works on both the Inventory and Docs tabs. Selecting a folder is also a route to sharing it — see the Sharing guide — and sharing a folder shares everything inside it, sub-folders included.

#Web

Creating a folder:

  1. Go to the Documents section
  2. Click the New Folder button
  3. Enter a folder name and confirm

Navigating:

  • Click folder cards to drill down
  • Use the breadcrumb trail to navigate back up, or the round up arrow at its start to go up one level
  • The folder view shows document thumbnails and counts at a glance
  • Folders, documents and items are all the same size tile in Thumbnails view — a small picture on the left, the name and counts beside it — so a folder and the documents inside it line up in one grid. Folders keep their lilac colour so you can still tell them apart at a glance
  • In List and Text list view, folders are one to a line too, at the top of the same list as your items or documents, with the same move, trash and ••• controls — and you can still drag things onto a folder's row
  • Every tile carries the same three round buttons in its bottom-right corner: move to a folder, move to Trash, and ••• for Share and Rename

Moving documents and items (drag-and-drop):

  • Simply drag a document or item card and drop it onto a folder card to move it — or onto a breadcrumb to move it back up a level
  • This is the fastest way to organize in the web interface — grab, drag, done
  • Works the same on the Inventory and Documents views
  • Folders drag too: drag a folder onto another folder to put it inside, or onto a breadcrumb to move it back up — on iPhone, hold the folder until it lifts, as you would an item. A notice says where it went, with Undo. A folder only lights up where it can go: never inside itself or one of its own folders. The Don't Panic help folder, and folders shared with you, stay where they are

Moving documents and items (folder button):

  • Click the small round folder icon on the tile (next to the trash icon) — folders have one too, so you can move a whole folder the same way
  • Choose the destination from the folder list — Home appears when you're inside a folder, to move things back to the top level

Selecting many at once, like on a desktop:

  • Drag a box: press on empty space between or below the cards and drag — everything the box touches is ticked, folders included, and Select turns on by itself. Near the top or bottom edge the list scrolls so the box can keep growing
  • Hold Shift while you drag to add to what's already ticked — and with Shift held you can start the box on a card, which is how you do it in the List and Text list views where rows sit edge to edge. Hold Cmd (Mac) or Ctrl (Windows) to flip what the box touches
  • Shift-click ticks everything from the last thing you clicked to this one; Cmd/Ctrl-click ticks or unticks just one — neither opens the card
  • Then drag any ticked card (or ticked folder) onto a folder, a breadcrumb or the up arrow: the whole selection goes, items and folders together. A label under the pointer says how many are moving — "3 items · 2 folders"
  • A selection never lands inside a folder it holds — those don't light up
  • One notice says what moved and where, with one Undo for the lot — and Select switches itself off, as it does after Move. Drag one card you didn't tick and only that card moves: your ticks stay as they were

Moving in bulk:

  • Click Select, tick the cards you want, then Move to folder — one confirmation moves them all (Inventory and Documents alike)
  • With a folder ticked, the bar offers only Move, which moves everything ticked. Delete, Print, Export and Combine are for items and documents — deleting a folder takes everything inside it, so that stays a folder's own button
  • Every selected document is tried: if a few can't move (a Don't Panic help page can't be renamed or moved, so it offers neither), the rest still go, and one message says how many moved and why the others stayed

Managing a folder (rename, share, move, delete):

  • Click the folder's round ••• and choose Rename or Share — sharing a folder with a person or group shares everything in it, see the Sharing guide
  • The round folder icon moves the folder somewhere else; the round trash can moves it (and what's inside) to Trash, where you can restore it. A folder that isn't empty asks first, and says what will go — counting the receipts and manuals filed in other folders that only its items use
  • Documents and items have the same •••, so you can rename or share one without opening it

#Via Chat

Your AI assistant knows about your folder structure. Try:

  • "What folders do I have?"
  • "Show me documents in my Kitchen folder."
  • "How many receipts are in my Receipts folder?"
  • "What's in the Warranties folder?"
  • "Put everything in Home that's food into the Food folder."
  • "File everything in Home into the right folders — create any you need."
  • "Move everything out of every folder back to Home."

The last three are one step for your AI, however many items are involved: it files by category, by folder, or by "in any folder" rather than item by item, so a few hundred items sort in seconds. The answer says what went where, and the Inventory tab and folder counts update on the spot.

#Via Claude Desktop (MCP)

If you're connected via MCP, the following tools are available:

  • list_views — List folders at a given level of the hierarchy
  • get_view — Get folder details and its contents
  • get_view_tree — See the entire folder hierarchy with item, document, and subfolder counts
  • get_view_members — Get items and documents in a folder
  • create_view — Create a new folder (idempotent — won't create duplicates)
  • update_view — Rename a folder, change description, sort order, or thumbnail mode
  • reorder_views — Batch update sort order for multiple folders
  • generate_view_icon — Generate an AI icon for a folder
  • add_items_to_view — Tag items with a folder (keeps prior memberships)
  • move_items_to_view — Move items to a destination folder
  • file_items — File items into several folders in one call, by explicit ids or by a filter (a category, everything in Home, everything in another folder)
  • undo_bulk_change — Undo a filing: every item goes back to the folders it was in, including an item that was in two
  • remove_items_from_view — Remove items from a folder

For the full tool reference, see MCP Tools — Complete Reference.

The AI navigates your folder structure automatically when answering questions about your documents.

#Folder Features

#Thumbnails & Icons

Folders display a collage of document thumbnails so you can see at a glance what's inside — a folder full of receipts looks different from one full of product manuals. If a folder has fewer documents, it shows individual thumbnails instead of a collage.

After a move or a filing, the folders you just touched update their picture and count straight away. When one request touches many folders at once — filing a few hundred items into a dozen folders, say — the first few update immediately and the rest catch up within a few seconds, rather than holding up the answer.

#AI Folder Icons

The system can generate a custom AI icon for your folder based on its name and contents. A folder called "Kitchen Appliances" might get a toaster icon, while "Travel Documents" might get a suitcase. These are generated automatically but can be regenerated if you'd prefer a different look.

#What a folder card counts

Each folder card says what is directly inside it: "5 documents · 2 folders" on the Docs tab, "12 items" on the Inventory tab. A card only says Empty when there is truly nothing in the folder. Things shared with you that you filed into the folder count too. Things inside its subfolders are counted on those subfolders' cards.

Photos taken while scanning an item, and files you uploaded from an item's own card, belong to that item. They are not counted as documents anywhere, so the Documents number at the top of the iOS app matches what the Docs tab lists.

#Sorting your folders

The sort control at the top of Documents and Inventory — Name, Added, Modified, and the rest — now orders your folders as well as the documents and items beneath them. Folders still come first as their own group; they are simply arranged by whatever you picked instead of always sitting in alphabetical order.

A folder can only answer some of those questions. It has a name and two dates, but no value, no expiry date, no file size — so picking Value or File size orders the items or documents while the folder block keeps the arrangement you dragged it into. Picking My order on Documents leaves your folder arrangement exactly as you set it, which is the whole point of it.

When you sort by a date, each folder card tells you the date it is being sorted by, on its own line under the counts — "3 documents · 1 folder" then "Updated Sep 3, 9:41 AM" — so the new order has a visible reason rather than looking shuffled. The time is in your own time zone, and the year appears only when it is not this year. Modified on a folder means the last time it was touched: filing something into it, moving something out, or emptying it, and also renaming it or changing its icon. Most of the time it answers "which folder did I last put something in?", which is usually why you reached for it.

Modified is on both menus now. Inventory gained it alongside Documents, so an inventory folder can be ordered by what you last put in it, and the items inside it by when you last changed them. On Inventory it orders your whole collection; on Documents it orders the documents already loaded, as it always has.

#Nested Folders

Folders can contain subfolders for deeper organization. A structure like Receipts > 2026 > March is perfectly valid if that's how your brain works. The breadcrumb trail keeps you oriented no matter how deep you go.

#Seeing where an item is filed

Open any inventory item and you'll find Filed in just under Category, naming the folder it lives in. Tap it to jump straight to that folder. If the item isn't in a folder at all, it reads Home.

An item can be in more than one folder — filed under both "Pool" and "Spares", say — in which case you'll see something like Pool +2, and tapping opens the folder picker so you can see and change the full set.

Filed in is about organization; Last seen further down the same card is about physical location — the Zone a beacon last spotted the thing in. They're different questions, which is why they have different names.

Search results carry the folder too, as a small line under each result. That's where it does the most work: when two similar-looking things come back, the folder is usually what tells them apart. Inside a folder, results don't repeat it — every row would say the same thing.

Your AI knows this as well now. Ask "which folder is my salt cell in?" or "what's in the garage that's expiring?" and it can answer directly, including through Claude Desktop and other connected apps.

#Tips & Tricks

  • A filing can always be undone. When you drag items onto a folder, use Move to Folder (on the list, a selection, or an item's page), or ask your AI to move or file them — even "move everything out of every folder" — a notice says what moved, with an Undo button. With the AI you can also just say "undo that". Every item goes back to exactly the folders it was in, and an item you have moved again since stays where you put it.
  • Keep it flat unless you have a reason not to. A handful of well-named top-level folders (Receipts, Warranties, Medical, Home, Work) is usually better than an elaborate hierarchy. You can always add depth later.
  • Use descriptive folder names. "Stuff" and "Misc" are the enemies of future-you. "Kitchen Appliance Manuals" is a folder name that pays dividends when you're troubleshooting your dishwasher at 10 PM.
  • The Don't Panic folder stays pinned at the top. No matter how many folders you create, the help guides are always right there. It's the one folder that genuinely wants to be found.

#Options

Setting What It Does Default
Default upload folder Where new documents go when you don't choose a folder My Documents
AI folder icons Whether the system generates custom icons for folders On

#Known Limitations

  • No drag-and-drop on iOS Drag-and-drop works everywhere now. On iOS, long-press a card for a moment and drag it onto a folder or breadcrumb; the web interface supports the same gesture with the mouse on both Inventory and Documents. Selection mode + Move remains available on every surface for bulk reorganizing.
  • Deeply nested folders can be hard to navigate on mobile. The breadcrumb trail helps, but on a phone screen, four or five levels deep starts to feel cramped. Consider flattening your structure if you find yourself scrolling the breadcrumbs.
  • Deleting a folder sends what's only in it to Trash too — and brings it all back. The folder goes to Trash with its sub-folders, the documents filed in them, and the items filed only there. Each of those items takes its receipts and manuals with it when no other item uses them, even if they're filed in another folder — the confirmation counts them before you say yes. Items also filed in another folder stay there; a document also linked to an item that stays keeps that link. Undo, or restoring the folder from Trash, brings all of it back as it was. Restore just one of its items from Trash and the receipts and manuals that went with it come back too; restoring the folder later brings back the rest and puts every link back. A receipt or manual you restore on its own shows up on its items again.
  • A folder deleted while you were using it. If you picked a folder — the folder chip in Add Items, Save to on the web Scan page, a Radar Save you moved with Change, or Image Studio's Save to — and that folder is then deleted (on another device, or by your AI), your next save isn't lost: it goes to the usual place instead and tells you where — for example "That folder no longer exists, so it was saved to Home instead." Image Studio and the web Scan page name My Documents, and Radar saves go back to the visit's own folder and name it. The app also forgets that folder, so later saves don't try it again. (Image Studio still makes, and charges for, the picture.)
  • Same-name folders collapse to one. If you (or an AI on your behalf) try to create a folder that already exists with the same name in the same parent, you'll get the existing one back rather than a duplicate. Names are matched after trimming whitespace.

#Version History

Version Date What Changed
33 2026-11-09 Select many at once, folders included: on the web drag a box, Shift-click and Cmd/Ctrl-click; on iOS slide a finger across the cards. Then drag any ticked card and the whole selection moves, with one Undo — also onto a new up-one-folder button AMB-1270
32 2026-11-09 After you drop a selection onto a folder, Select switches itself off, as it does after Move; dragging one unticked card leaves your ticks alone AMB-1270
31 2026-10-29 Moving a folder on the web now says where it went — "Moved “Garage” to Tools" — with Undo, as the iPhone does; and the same words on both AMB-2829
30 2026-10-29 When adding an item to a folder, or taking it out, fails because of a problem on our side, connected AI apps and the in-app assistant now say so in plain words, never the server's internal error text AMB-2803
29 2026-10-29 A move or a filing that fails now reads the same on every path: a folder move says why (never the request's own text), the scan's Change folder says what the Move picker says, the web's Undo of a removed share says when it fails, and a drag of several shared cards says once "2 documents filed. 1 couldn't be filed." AMB-2802
28 2026-10-29 Moving an item or a document, or filing something shared into a folder, now says so when it fails, on iPhone and the web, by a drag, the Move sheet or File into folder, instead of leaving it where it was without a word AMB-2800
27 2026-10-27 Steps now name the tabs the app has today — Context → Docs and Control — instead of the retired "My Things" and "Account" AMB-2584
26 2026-10-25 A folder holds one kind. Inventory folders no longer turn up on the Documents tab (and document folders never on Inventory). Filing an item into a documents folder, or a document into an inventory folder, is refused instead of quietly turning the folder into both kinds, and a folder card counts only its own kind again AMB-2327
25 2026-10-23 A deleted folder no longer loses your save. Saving into a folder that was deleted since you picked it now saves to Home instead and says so (Radar saves go to the visit's folder), instead of a generic "scan failed" — and Add Items, the web Scan page, Radar Save and Image Studio forget that folder AMB-2278
24 2026-10-21 Folder cards and the Documents number tell the truth. A folder holding only items no longer reads Empty on the Documents tab — it says "12 items" — and the Documents number at the top of the iOS app no longer counts scan photos or files uploaded from an item's card, so it matches what the Documents tab lists AMB-673
23 2026-10-11 Moving several documents never stops part-way — if one can't move (a Don't Panic help page, which no longer offers Rename or Move), the rest still do, and one message says how many moved and why the others stayed, on iOS and the web AMB-1883
20 2026-10-27 Deleting a folder says what goes, receipts and manuals included. A folder's items take the receipts and manuals only they use to Trash with them, wherever those are filed, and restoring the folder brings them back; the confirmation on iOS and the web counts them before you say yes (AMB-2416, AMB-2616)
21 2026-10-27 Restoring one item brings back its own paperwork. An item restored on its own from a deleted folder brings back the receipts and manuals that went with it, and a document restored on its own is listed on its items again (AMB-2616)
22 2026-11-07 Drag a folder into a folder. On iOS and the web, a folder can be dragged onto another folder, or onto a breadcrumb, to move it there, with Undo
19 2026-10-25 Moving documents can be undone too. Dragging documents onto a folder, Move to Folder, or asking your AI shows the same Undo notice moving items does, on iOS and the web; one Undo puts a whole selection back where each document came from — Home, if its folder has since been deleted (AMB-2470)
18 2026-10-24 A move you make by hand can be undone too. Dragging items onto a folder or using Move to Folder shows the same Undo notice the AI's filings do, on iOS and the web (AMB-2344)
17 2026-10-21 Filing into folders can be undone. Moving or filing items with your AI — even emptying every folder back to Home — shows an Undo in the chat, and "undo that" works too; every item goes back to the folders it was in (AMB-1446)
16 2026-09-26 iOS: long-press a document or item for Share, Rename, Move to Folder…, Select and Move to Trash — moving one no longer needs selection mode (AMB-1468)
15 2026-09-26 Web: in List view, folders are one to a line like your items and documents, instead of a grid of tiles above the list (AMB-1273)
14 2026-09-26 Web: folders, documents and items are one tile size, with the same round move, trash and ••• (Share, Rename) buttons on every tile — a folder can now be moved or trashed straight from its tile, and a document or item renamed or shared without opening it (AMB-1273)
13 2026-09-25 "Move everything out of every folder" is one quick step. Your AI can now name "everything that's in a folder" as a set, so emptying every folder back to Home takes seconds instead of the minutes it spent listing hundreds of items one by one (AMB-1346)
12 2026-09-18 A big filing no longer waits for every folder's picture. A request that touches many folders updates the first few cards immediately and the rest within seconds, instead of the answer stalling for minutes while each card was redrawn (AMB-1231)
11 2026-09-18 Asking your AI to file items by category is now one step, whatever the count — it files by filter (a category, everything in Home, everything in a folder) instead of listing and naming every item, so a few hundred loose items sort in seconds instead of running past the reply's time limit (AMB-1203)
10 2026-09-18 Inventory gains the Modified sort option Documents already had, and on Inventory it orders the whole collection rather than a page of it (AMB-1142)
9 2026-09-17 New "Sorting your folders" section — the sort control now orders folders as well as their contents on iOS and web, and folder cards show the date they are sorted by (AMB-573, AMB-1136)
8 2026-08-11 New "Seeing where an item is filed" section — Filed in on item detail (iOS + web), the folder on search results and chat item cards, and folder names now reaching your AI and connected apps (AMB-702)
7 2026-07-26 New "Document folders and inventory folders" section — destination pickers offer only folders that can hold what you're filing, and a folder widens to hold both kinds when you deliberately file the other kind into it
6 2026-07-05 Added folder management (rename / edit / delete with Undo) on iOS long-press + web menu; folder is a route to sharing; clarified that deleting a folder keeps its contents (AMB-429/430/432, v0.13.2)
5 2026-07-02 Web: item drag-and-drop + folder button + bulk move (parity with documents); iOS drag-and-drop limitation lifted (AMB-420)
4 2026-06-07 Terminology: "Admin Web" → "Web" (the web interface)
3 2026-05-27 Updated MCP tools section with current view/folder tool names (AMB-188)
2 2026-05-02 Note same-name folder collapse (AMB-106)
1 2026-03-01 Initial guide