Skip to content

Finding things

The search box sits at the top of every page. Click it, or press ⌘ K on a Mac or Ctrl K on Windows, from anywhere in Bottle.

Start typing. After two letters Bottle shows what matches, best first, in groups: customers together, orders together, and so on. Press ↑ and ↓ to move, Enter to open, and Esc to close. A click works too.

Type this To find
A name, or part of one: kingston fish Customers, people, products, vehicles and bases
A postcode, with or without the space Delivery addresses, and the customer they belong to
A phone number, written any way The customer with that number
An email address, or part of one Customers and people
A tracking reference: 7K3M-9QWX That order
An invoice number: 42 or INV-BTL00042 That invoice
A shop’s own order number The order that came from the shop
A registration: KT70 ABC That vehicle
What a page does: shift patterns, xero The page of Bottle where you do it

Every word you type has to match somewhere, so kingston bar finds Kingston Fish Bar but not Kingston Arms. The words can be in any order, and in any of a record’s details: smith KT1 finds the Smith whose door is in KT1.

A small slip still finds the right thing. Kingstom finds Kingston, as long as the word is four letters or more.

Archived customers, products and vehicles are still found, below everything else, marked Archived.

Choosing a result takes you to the page that shows it:

  • A customer or a delivery address opens the customer.
  • An order opens the order.
  • An invoice opens on the Invoices page.
  • A product opens ready to change.
  • A vehicle or base opens ready to change, on Vehicles and bases.
  • A person is picked out on the People page.

When you open the search box without typing, it shows the last few things you opened from it. They are kept in this browser only, separately for each business. Clear forgets them.

Search only finds what you could already see. A driver finds pages they can open and the products they sell from the van, but not the customer book, invoices or who else works here. The same goes for API keys and connected assistants: they find only the kinds of record their permissions let them read. See For developers for the details.