A short path from an empty till to a real sale. Browsing this help does not change your shop.
Words used in this guide:POS (point of sale) is the system you use to ring up sales, take payment and print receipts. A till is the same thing in many countries, also called a cash register or just the register: here it means one device running VesselTill. Sync is the optional paid Google Drive backup and All tills view.
Open your own till
Open POS in the browser/profile you will use for trading. The free POS needs no account. Use your regular browser, not private mode. On phones, open the cart from the bottom of the screen; on larger screens it is alongside Products.
Set currency and shop details
Use the currency button in the header (for example ZAR). Choose before setting your prices: this is not an exchange-rate converter. In Settings → Business Details, enter your business name, then Save Profile. Set tax only if applicable to your business; check inclusive versus added tax.
Add one real product—or a one-off item
In Products choose + Add product (or + Add your first product). Enter a name and price. Leave stock blank if you do not count units; zero means none in stock. Save & sell 1 saves it and adds one to the cart—it does not yet record a sale. For something you will not keep in the catalogue, use + Custom item in the cart instead.
Have many products? Import a spreadsheet. Keep demo templates out of your real trading shop unless you intend to add their sample catalogue.
Review, receive payment, then confirm
Check item, quantity, currency, tax and total. Tap Charge. Choose Cash, Card, Digital or Split. Receive and independently confirm the customer’s payment, then tap Confirm & Receipt. Cash calculates change. Card uses your own terminal; Digital uses your own provider. VesselTill records payment—it does not move money or process cards.
Give a receipt and check History
Choose WhatsApp, PDF or Print, or close the receipt. Closing does not undo the sale. Find it in Receipt History before recording it again: a failed print/share does not mean the sale failed.
Save your first backup
Open Backup → ⬇ Full Backup (JSON). Check that the file actually appears in Downloads and copy it somewhere separate from the till. Repeat at the end of each trading day. Keep more than one dated copy.
Practising? Use a separate test browser/profile or device—not an established shop. Do not clear real shop data to start a demo. If a test sale was accidentally recorded in your real shop, use the documented Void flow rather than deleting storage.
One tab or window at a time
VesselTill works in one tab or window at a time on each device, so your stock and receipt numbers stay right. If you open it a second time, the new tab shows Use VesselTill here. Tap it to move the till to that tab; the other tab stops. Finish any sale first: a sale that is not finished in the other tab is not carried over. The customer, kitchen and pickup displays are separate pages and keep working.
📦 Loading Your Products
➕
No spreadsheet? Add products by hand. Tap + Add product in the product grid (or + Add your first product on an empty shop), type a name and a price, and tap Save & sell 1 to sell it straight away. Stock, category and barcode are optional: leave stock blank if you don’t count it. Products you add by hand are kept when you import a spreadsheet later.
✎
Change a product any time. Tap the ⋯ button in the corner of a product to open its sheet. Details: change the name, price, category or barcode (old receipts keep the name and price they were sold at). Stock: add stock you received, take off damaged or lost stock, or enter a count, each with a reason. History: see what changed and when. Archive hides a product you no longer sell: it leaves the till, search and scanning, but nothing is deleted, and the Archived filter brings it back. If you upload your spreadsheet again, products that are in the file are read from the file.
1
Prepare your Excel or CSV file
Create a spreadsheet with a sheet named Products (or leave the sheet name as-is). The columns VesselTill reads are:
On a narrow screen, scroll within this table to see all columns. With a keyboard, focus the table area and use the arrow keys.
Spreadsheet product columns
Column name
Required?
Example value
Notes
Description
Required
Chicken Mayo Wrap
The product name shown on the card
Price
Required
49.99
Numbers only — no currency symbols
Barcode
Optional
6001234567890
Enables barcode-scanner lookup
Qty
Optional
24
Starting stock count — decreases with each sale
Category
Optional
Beverages
Shown as a small label on the product card
2
Add a Staff sheet (optional)
If you want to track which staff member made each sale, add a second sheet in the same file and name it Staff. Put one staff name per row in column A. A staff selector will then appear in the cart header.
3
Upload the file
In the Products tab, tap ↑ Upload Excel and select your file. Products load instantly. The imported catalogue is saved in this browser on this device; you do not need to upload it at every launch. Re-upload at any time to update prices or add new products. A ⬇ Demo Template button sits right next to Upload Excel if you want to test with sample data first.
4
Search and filter products
Use the search bar at the top of the Products tab to find products by name, category, or barcode number. Results update as you type.
Out of stock? A counted product at zero cannot be added to the cart. Use the product’s ⋯ → Stock → + Add stock for a delivery, or Set to a count after a physical count. Do not restore a full backup just to restock. Re-importing a stale spreadsheet with quantities can also undo your current counts.
Receive stock, record a loss, or correct a count
Open the product’s ⋯ sheet, then Stock.
Choose + Add stock for units received, − Take off for losses, or Set to a count for the actual total on your shelf.
Enter the quantity, choose a Reason (received, count/correction, damaged/expired, lost/stolen, own use or other), and add an optional note.
Tap Save stock and check In stock now.
Example: 8 on hand plus a delivery of 12 means Add stock 12. A physical count of 12 means Set to a count 12—not Add 12. Stop counting stock for this product removes unit tracking. Product History keeps the latest 100 changes; sales are in Receipt History.
Re-import safely: what changes and what stays
Back up before a bulk update. Imports rebuild the spreadsheet-derived catalogue from the valid rows in the new file. A missing spreadsheet product is not guaranteed to remain in the active catalogue. Manually created products are kept.
Matching: saved records are looked up by barcode first, then case-insensitive name. Keep identifiers consistent; avoid duplicate names/barcodes.
Prices and descriptions: spreadsheet rows use values from the new file. Edits made in the app can be overwritten on re-import.
Stock: an explicit Qty from the file wins—even if it is higher than today’s count. Blank/missing Qty carries forward an existing counted quantity when a match is found; otherwise it is uncounted. Negative imported counts are clamped to zero.
Manual products: a file row sharing a barcode with a manually added product is skipped; the hand-added product stays.
Marks: matching products retain favourite/Regular, bought-from-customer and archived marks and product history when saved data is available. A storage-read failure can fall back to file values, so inspect results.
Read the import summary: detected columns, missing names/invalid prices, duplicate warnings, skipped rows and changed stock counts. Missing names and non-positive/invalid prices are skipped. Use clear headers and numeric selling prices; check a few products before taking payment. Store barcodes as text in Excel to protect leading zeros.
Find, edit and archive products
Search by name, barcode or category. Use product filters, the Regular/favourite star and grid/list view where available. In ⋯ → Details, change a product then tap Save changes. Existing receipts retain the name and price recorded at sale time.
Archive this product hides it from normal selling/search/scanning without deleting its history. Use the Archived filter and its product sheet to bring it back. Re-importing a matching archived product preserves that mark; do not assume a new upload unarchives it.
Buy stock from a customer (second-hand / buy-sell shops)
In the cart, choose Buy from Customer. On a phone, use the Cart button to open even an empty cart. If staff are loaded, select the staff member first.
Enter description, optional barcode/category, quantity and total price paid for the purchase, plus any notes. Choose Cash, Card or Digital.
Check carefully, pay the seller outside VesselTill and choose Confirm Purchase. Find the resulting Purchase Note in Receipt History.
This is money out, stock in—not a customer sale or supplier-invoice system. A matching barcode, then case-insensitive name, adds units to an existing product. Otherwise it creates a product with an initial selling price based on the per-unit purchase cost: review and change that selling price before reselling. A matching archived product is brought back into use.
The Bought product filter helps find these items. Current End of Day shows purchases separately, and cash purchases reduce expected drawer cash. Purchase voiding is not supported in this version of the app: double-check before confirming and keep a separate audit trail for any correction.
🛒 Making a Sale
1
Select a staff member (if set up)
If you added a Staff sheet to your Excel file, choose the serving staff member from the dropdown in the cart header. This is recorded on every receipt and report for that sale.
2
Add products to the cart
Tap any product card on the left to add one unit to the cart. Tap again to add another. In the cart, use the + and − buttons to change quantities, or tap − until the item is removed.
To add something not in your product list, tap + Custom item in the cart, type a name and price, and tap Add to Cart. Recent custom items are shown as quick-tap chips for reuse.
3
Scan a barcode (optional)
Tap the Scan button next to the search bar to open the barcode scanner. Point your camera at a barcode — the matching product is added to the cart automatically. If your device has no camera, switch to the Type Barcode tab inside the scanner and enter the number manually (useful with a USB barcode reader).
4
Apply a discount (optional)
In the cart footer, enter a percentage in Discount %. Check the total before charging. This discounts the whole basket. Do not edit or re-import the product catalogue as a workaround for a one-sale discount: catalogue price changes affect future customers too.
5
Set tax (optional)
Enter a percentage in the Tax % field. By default, tax is added on top of the price. If your Excel prices already include tax (e.g. VAT-inclusive), toggle Tax incl. on — VesselTill will extract the tax portion instead of adding it.
6
Enter a customer name (optional)
Type a customer name in the field below the staff selector. It appears on the receipt and in the transaction history, making it easier to find a specific sale later.
7
Tap Charge
When the cart is ready, tap the green Charge button to open the payment screen.
Mixed tax rates and inclusive prices
The cart’s Tax % and Tax incl. are defaults. With tax added, 100 at 15% totals 115. With tax included, 115 already contains the tax; it is not added again.
Open a cart line’s tax control (or press T for the last line outside a field/dialog). Choose Default, a preset rate (0%, 9%, 21%) or custom rate, and whether that line’s price includes tax. Confirm the picker. This override applies to the current sale only—not to the saved product or next customer. Check each marked line and the final tax total before Charge.
Use the rates and tax treatment required for your business. VesselTill’s calculations are not tax or registration advice.
💳 Payment Methods
VesselTill supports four payment modes. Select one on the payment screen after tapping Charge.
💵
Cash
Enter the amount tendered — VesselTill calculates the change automatically and shows quick-amount buttons.
💳
Card
Process the payment on your own card machine. VesselTill records it as a card payment for your reports.
📲
Digital
For EFT, e-wallets, or mobile payments (e.g. SnapScan, Zapper). Confirm receipt, then tap Confirm.
🔀
Split
Divide a payment across two methods: Cash + Card, Cash + Digital, or Card + Digital.
→
Confirm & Receipt
Once the payment details are filled in, tap Confirm & Receipt. The sale is saved to history, stock is decremented, and the receipt screen opens automatically.
Confirm outside payments and avoid duplicate sales
Card: collect payment on your own card terminal and record its reference if needed. Digital: choose the provider/method, show your saved payment QR if useful, and verify receipt in your own provider account. A displayed QR, customer screenshot or selected payment method is not proof of settlement.
Split: choose two methods and fill the requested portions. Check their sum and any cash change before confirming. If payment or printing seems interrupted, check Receipt History before ringing it up again.
Use Settings to add your provider’s QR image; VesselTill cannot confirm that a scan paid you. It does not store card credentials or operate your card terminal.
🧾 Receipts
After confirming a payment, the receipt screen opens with four delivery options.
💬
WhatsApp
Tap WhatsApp to open a number entry screen. Select a country dial code, enter the customer's number, and VesselTill opens WhatsApp with a pre-formatted receipt message ready to send. Recent numbers are saved for quick reuse.
📄
PDF Receipt
Downloads a clean PDF receipt to your device. Share it by email, save to Google Drive, or print later.
🖨
Print
Opens your browser’s print window. Choose an installed, compatible printer and check paper size and preview. Printer availability depends on your device, operating system and drivers; not every thermal/Bluetooth printer supports browser printing.
✕
No receipt
Tap Close to dismiss without sending a receipt. The sale is still saved to history regardless.
ℹ️
You can re-send a receipt for any past sale. Open the Receipt History tab, find the transaction, tap it, and choose the delivery method from the receipt screen.
🖨️
Using a thermal printer? Receipts, PDFs and kitchen tickets print in solid black. For heavier, easier-to-read type switch on Settings → Receipt Text → Bold, larger receipt text. VesselTill prints through your device’s normal print window, so choose your printer there, or download the 80 mm PDF receipt.
Receipt delivery, privacy and printing
WhatsApp prepares a message for you to review and send in WhatsApp; it is not an automatic delivery guarantee. Confirm the country code and number before sending. Remember a customer’s number only when appropriate. PDF files and receipts can contain customer or shop details—share them only with the intended recipient.
A failed print or share does not reverse the sale. Reopen the original in Receipt History and try again. Browser printing uses your device’s installed printers. If thermal output is clipped, check roll size, margins and scaling in the print window, or try the receipt PDF. Kitchen ticket width is a separate setting.
To customise the heading, logo, tax number and footer, use Settings.
🍽 Orders & Kitchen Tickets
For restaurants, cafés, bakeries, food trucks — anyone who takes an order first and gets paid later, or is paid first and then hands over the order when it is ready. An order is kept in its own list and only becomes a sale (receipt, stock, end-of-day totals) once it has been paid.
1
Place an order
Add products to the cart, then tap Order (next to Charge). Type a table or customer name and, if you like, a note for the kitchen, then tap Place order. The cart clears, ready for the next customer. Tap ✎ note on any cart line to add a note to just that item (a serial number, a size, “no onions”).
2
Find it in the Orders tab
The Orders tab appears after your first order. Orders are grouped as Waiting for payment and Paid · waiting to be collected, longest-waiting first, and the badge shows how many are still open.
3
Add items or pay
+ Add items loads the order back into the cart (the buttons become Save order and Pay order). Pay opens the normal payment screen and creates the normal receipt, which also shows the order number. After payment the order stays on the Orders tab with a greyed-out Paid ✓ button.
4
Mark it collected
When the customer has their order, tap Collected. It moves to Closed today, with a link to its receipt.
5
Kitchen tickets
Tap 👁 View on an order to preview its kitchen ticket without printing, or 🖨 Print to print it. Tickets are laid out for thermal printers (large order number, table or name, PAID / NOT PAID, items with quantities and notes, no prices). Choose 80 mm or 58 mm paper in Settings → Orders.
6
Cancel or refund
An unpaid order can be cancelled with a reason. A paid order can’t be cancelled from the Orders tab — open its receipt and refund it from Receipt History.
ℹ️
Item notes are printed under the item on the customer’s receipt. Untick Show on the customer’s receipt in the note window to keep a note private. Orders work on one device today; the End of Day screen warns you about any unpaid orders. Don’t need orders? Switch them off in Settings → Orders (not possible while orders are still open).
Ready is not Paid or Collected
Use Ready on the Orders tab or Kitchen Display when preparation is complete. It can be set on an unpaid or paid open order; undo Ready if marked by mistake. Ready does not record payment, deduct stock as a sale, or hand the order over.
Receive payment using Pay, then mark Collected when handed over. Check both the payment and collection state; the Pickup Screen’s ready number alone does not show whether payment has been received. Orders and their preparation state are local to this till, not a shared multi-device queue.
Open the Receipt History tab. Use the date filter to narrow down the list if needed. Tap the transaction to open it.
2
Tap "Return / Exchange"
Inside the transaction detail, tap the amber Return / Exchange button to open the returns flow.
3
Select what's being returned
Tick the items the customer is bringing back and set the quantity for each. The refund amount calculates automatically.
4
Refund or Exchange
Choose Refund to return money to the customer, or Exchange to swap for a different product. Exchanged items are added to a new cart for you to complete. Stock levels are updated accordingly.
⚠️
You can also Void a sale from the Receipt History tab to cancel it entirely. Voided sales are removed from your totals in the End-of-Day report and stock is restored. Use this for mistakes, not for legitimate returns — use the return flow for those.
Refunds, store credit and outstanding exchanges
In the return flow select the original items/remaining quantities, tap Next, then choose Refund or Exchange. Refund offers Cash, Card or Store Credit; check the calculated amount and tap Confirm Return. Exchange applies return value as credit to the next sale—select replacement items and finish checkout.
Recording a refund does not send money. Hand over cash or use your own payment provider/terminal to refund externally. Record the actual outcome. For a refund still awaiting collection, use Receipt History’s Uncollected refunds filter and mark Collected only after it is handed over.
Review Pending exchanges and Abandoned in Receipt History. Where offered, Reopen & use credit resumes the replacement sale. Do not start another return just because an exchange was interrupted; inspect the existing record first.
Void a mistake—or restore an accidentally voided receipt
Find the record in Receipt History and choose Void.
Check it is a mistaken record, choose a reason and confirm Void receipt.
Find it under Voided if needed. Use Restore with a reason only when the original record should be active again.
Voids leave an audit record and change reports and stock. Restoring reverses those void effects. A sale with an existing return/exchange is blocked from being voided, and purchase voids are not supported in this version of the app. Do not use voids instead of a legitimate customer return, or expect a void to reverse a bank/card transaction.
📊 History & End-of-Day Reports
→
Receipt History tab
The Receipt History tab shows every completed sale in reverse-chronological order. Use the date picker at the top to filter by a specific day. Tap any sale to view the full receipt, re-send it, or initiate a return.
→
End-of-Day report
Open the EOD tab and select a date (today by default). The report shows total revenue, number of transactions, a breakdown by payment method (cash / card / digital / split), and a per-product sales summary. Export it three ways:
Download PDF — saves a formatted report to your device
Send by Email — opens your email client with the report pre-filled
Print — sends to your printer via the browser dialog
Close a trading day safely
Open End of Day (or tap the header’s Today summary). Select the correct day, week or month. Tapping the date opens a calendar where each day is shaded by its number of sales: no colour means no sales and darker green means busier. Point at or tap a day to see how many sales it had. Receipt History uses the same calendar for its date filter.
Review sales, refunds, payment methods, products, staff and Tax / VAT Collected. Tax totals are net of refunds.
Check warnings and outstanding unpaid orders, exchanges and uncollected refunds. A stored order is not a completed sale.
Use the Cash-Up fields to enter your opening float and actual cash count; compare expected versus counted cash and investigate differences rather than changing sales to force a match.
Save/share/print the report as needed, then export Full Backup (JSON).
Business day: Settings → Business Day Start Time changes the reporting boundary. At 07:00, a sale at 06:00 Saturday belongs to Friday. This also changes how earlier records are grouped; it does not create new sales. Keep the device clock/timezone correct.
Receipt CSV exports contain item rows, so a receipt total may repeat across its items. Do not sum repeated receipt-total cells as if each row were a separate sale.
Cash-up, paid-ins and paid-outs
Cash-up appears in Day view, not Week/Month. Enter Opening Float, record genuine paid-in/paid-out adjustments with reasons where offered, then enter actual cash counted. Do not enter a sale, refund or purchase again as an adjustment if it has already affected the drawer.
Expected cash is opening float + cash sales − collected cash refunds + paid-ins − paid-outs − cash purchases. A cash refund awaiting collection is not treated as already handed out. Compare the over/short difference and investigate mistakes; an accurate report can legitimately show a shortage.
Full Backup does not include every setting or record: keep separate copies of per-day cash-up adjustments and audit history. Keep report exports and independent reconciliation records as well as your Full Backup.
Settings, language & displays
Personalise your till without confusing saved business settings with one-sale changes.
PIN lock and staff PINs
PIN lock is optional and free. Open Settings → PIN lock and tap Turn on PIN lock. Type your name (it goes on your sales) and a 4 to 8 digit owner PIN, and choose when the till locks itself. VesselTill then shows a recovery code: write it down or save it as a file, away from the till. It is the only way to set a new owner PIN if you forget yours (lock screen → Forgot the owner PIN?).
If both the owner PIN and the recovery code are lost, nobody can unlock the till, not even VesselTill: the PINs are kept only on your device. On the lock screen, tap Forgot the owner PIN? → Clear this till and start again and type DELETE. For safety the till is only cleared after a 10-minute wait, and the screen shows when your last backup was made; anyone who unlocks the till with a PIN in that time cancels it. Clearing deletes everything VesselTill keeps on that device, but receipt numbers carry on from where they were, so a restored backup never clashes with new sales. Then restore your latest backup: from Google Drive if you use Sync, or a Full Backup file in the Backup tab. Sales made after that backup cannot be brought back, so keep backups if you use PIN lock. With Sync, the cleared device counts as a new device; if all your Sync devices are in use, a device that is no longer used frees its place after 30 days.
Add each staff member with their own PIN under + Add staff member (staff from your Excel Staff sheet appear there too; tap Set PIN). Every PIN must be different, because the PIN tells the till who is selling: sales are recorded under the person who unlocked it.
The till locks when it opens, after the idle time you chose, and when anyone taps 🔒 Lock in the cart. When a staff member is signed in, these need the owner PIN for that one action: refunds and exchanges, voids, discounts, the tax setting, adding or changing products, importing products, Buy from Customer, End of Day (including paid in and paid out), Sync, Backup, Settings and restoring or deleting data. Five wrong PINs in a row make the till wait before the next try.
PINs are kept on this device only, never the PIN itself, and they are not in backups: after restoring a backup on another device, turn PIN lock on there too. PIN lock keeps people at the till out of what they should not do; it does not encrypt your data, so keep your backups safe as well.
Business details, logo and receipt text
Open Settings; tap a section title to expand it. Under Business Details, set name, optional branch/location, phone, address and VAT/tax number. Add a logo under Business Logo (PNG/JPG/JPEG/WEBP, up to 500 KB). Set Receipt Footer and Receipt Text → Bold, larger receipt text if needed. Tap Save Profile; do not leave an unsaved-changes notice behind.
Check a receipt and report after changing your profile. Never use a footer to promise policies your shop does not actually follow. Backups can include these details and the logo.
Payment QR codes
Use Settings → Payment QR Codes → + Add QR Code to add an image from your actual payment provider. Give it a recognisable label. Show the relevant saved code on the payment screen or Customer Display. Verify that it belongs to the correct business before customers use it.
Showing a code is not payment processing or automatic payment verification. Confirm funds with your provider before recording the sale.
Language, currency and appearance
Use Settings → Language to select a menu language. Untranslated text remains English; report translation issues through Contact. Choose from the languages listed in your app’s Language menu.
Use the header currency picker before entering prices. Choose from 57 currencies, including ZAR, USD, EUR, GBP, KES, NGN, GHS, INR, AUD, HTG and KWD. JPY and several others use no decimal places; Gulf dinar currencies include three-decimal options. Currency selection changes denomination/formatting—not the value through a foreign-exchange conversion.
The sun/moon button switches theme. This help uses the same vt-theme preference on the same site. Use the theme control here to choose light, dark or the system setting.
Customer Display, Kitchen Display, Pickup Screen and Queue Screen
On a desktop, open Displays above the Products grid, or Settings → Displays.
Choose the screen and move the new window to the second monitor. Allow popups for VesselTill if the browser blocks it.
Keep the original POS window open and use the same browser/profile and site. These windows communicate on this device; opening a URL on another phone/tablet is not remote pairing.
Customer Display: customer-facing cart/total, receipt/payment-facing information and your saved Pay Here QR options. M opens/focuses it from the POS.
Kitchen Display: open orders with items, notes and waiting times. Tap Ready; the Ready area lets you undo an accidental mark. Sound is optional and requires enabling it. F toggles fullscreen.
Pickup Screen: Preparing and Ready for pickup order numbers, without customer names/items. Use it for waiting customers.
Queue Screen: calls the next customer in big letters with a chime. Opening it (or Settings → Displays) adds a Next button beside Customer name. Type a name or a message such as “Till / POS 2, please” and press Next, Q or Enter in the box; an empty box calls “Next customer, please”. Between sales the box is cleared after calling, so the message does not land on a receipt; during a sale the name stays, for that customer’s receipt. ↻ calls the same again. The last few calls show underneath; they stay on this device and start again each business day.
All displays keep the screen awake while they are open (in browsers that support it). If a screen shows Reconnecting to the till… for a while and then says it lost contact, VesselTill was closed or the computer went to sleep: open VesselTill again in the same browser.
Kitchen/Pickup show orders taken with the Order button, not ordinary instant checkout sales. If a screen says it lost contact, its contents may be stale: return to the original till window. These are local displays, not Sync’s read-only All tills view or a network kitchen-order system.
💾 Backup & Restore
A backup is only useful if you still have the file. Shop records live in this device’s browser. A different browser/profile/device has separate storage. Download Full Backup JSON and keep a separate copy daily; check that it is present and readable. A backup timestamp says an export was requested, not that you verified a copy elsewhere.
→
Full Backup (recommended daily)
In the Backup tab, tap ⬇ Full Backup (JSON). This downloads a single file containing all your receipts, products, and stock quantities. Save it to Google Drive, WhatsApp yourself, or email it. This is the file used to restore your data.
→
Export receipts as CSV
Tap ⬇ Receipts Spreadsheet (.csv) to download all receipts as a CSV file you can open in Excel or Google Sheets for further analysis.
→
Export stock snapshot
Tap ⬇ Download Stock CSV or ⬇ Download Stock JSON to export your current product list including live stock quantities after all sales, returns, and exchanges. Useful for stock-taking.
→
Restore from backup
In Backup, tap the restore drop zone and choose a Full Backup JSON, or drag it onto the zone. There is not a single “merge or replace everything” choice: new receipt numbers merge, while other fields have different rules. Read the restore rules first, and export your current till before proceeding.
→
Backup reminder banner
If more than 24 hours have passed since your last backup, a yellow banner appears at the top of the screen. Tap Back up now to export immediately, or dismiss it for the current session.
💡
Moving to a new device? Back up on the old device (Full Backup JSON), open VesselTill on the new device, go to the Backup tab, and restore the file. Check the imported records and settings before trading on the new device.
Choose the right export
On a narrow screen, scroll within this table to see all columns. With a keyboard, focus the table area and use the arrow keys.
Which file should I keep?
Export
Use
Full recovery?
Full Backup (JSON)
Receipts, voided records, products, staff, business profile/logo, QR codes, custom digital methods, orders and included till settings.
Yes, through the restore rules below; not every device preference is included.
Receipts Spreadsheet (.csv)
Item-level analysis in a spreadsheet.
No
Stock CSV / Stock JSON
Current product/stock records (stock JSON also carries staff).
No—these are not Full Backup files.
The Full Backup includes currency, default tax/inclusive setting, kitchen ticket width, business-day start and Orders switch. It is not a clone of your Google session or device identity. Keep several dated copies separate from the till; backups may contain personal/customer information.
Before restoring: the actual merge and overwrite rules
First download a backup of the till as it is now. Verify the incoming file’s shop and date. A restore is not an undo-to-that-exact-time operation. Do not restore an unrelated shop into a working till.
Receipts: incoming receipt numbers not already present are added. Existing numbers are skipped; current receipts are not deleted.
Voided records: missing numbers merge into the voided bin.
Orders: merge by order ID; a more recently edited incoming copy replaces that order’s fields.
Products/stock: if the backup has products and your till already has products, a separate confirmation asks whether to overwrite them. Declining that prompt is not cancellation of the whole restore—receipts may already have merged.
Staff: incoming staff fills an empty staff list; it does not replace an existing list.
Business profile, logo and QR codes: fields included in the backup can replace current values. A stored empty logo can clear the logo. These are not protected by the products prompt.
Custom digital methods: missing methods are added. Included valid till settings are applied; Orders will not be hidden while active orders remain.
Inspect the result message, Receipt History, open orders, products/stock, currency, tax and business profile afterwards. Older backups may lack newer fields. A Full Backup is not a safe way to add a delivery of stock: use Stock adjustments.
Move a till to a new device
On the old till, finish or account for open orders and take a fresh Full Backup (JSON). Keep an extra copy before making changes.
Transfer that file securely. On the new device, open the real POS in the regular browser/profile you plan to use.
Open Backup, select the JSON and follow the restore prompts. Check receipts, current stock, orders, business details, currency and tax.
If you use Sync, connect the intended Google account separately. Restoring a file does not transfer the old till’s permanent device identity.
Only retire the old till after confirming the new one has what you need. Keep the backup. Do not run both as if they share one live stock ledger.
Adding a second trading till is a different task: each till keeps its own stock and sales; see Optional Sync. Do not merge unrelated tills just to obtain an All tills report.
On-device recovery points: helpful, but not an off-device backup
Open Login / Sync → View recovery points where shown. The app keeps up to five rotating local recovery points; receipt/void history in each is limited to the latest 90 days. They are designed for recent mistakes and use the same merge/overwrite restore rules—not an exact rollback.
Export a fresh Full Backup before applying one. Recovery points live in the same browser storage as your till. Clearing storage, losing the device or some uninstall actions loses both. A separate Full Backup copy or successful Drive backup protects against a different class of loss.
Optional Sync & All tills
The core single-device POS stays free. Sync adds Google Drive backup/restore and a read-only view across tills; it is not a requirement for taking a sale.
Connect Google and understand the plan
While online, open Login / Sync in the POS.
Sign in with the Google account intended for this shop and review the requested access. Use that same account on other tills you want in the group.
If eligible, choose Start free trial / Start my free trial. The offered trial is 14 days with no card. Trial eligibility is checked by the service; it is not renewed by reinstalling or clearing storage.
Review the panel’s status and expiry before relying on Drive backup/restore. The current app shows $6/month or $60/year; confirm the actual terms on the plan/checkout screen before paying.
The standard recurring Sync plan and its trial support up to three POS devices; Founding Member supports up to five. Paid subscribers also receive white label (removal of “Powered by VesselTill” from dashboard/receipts); that extra is not part of the trial. See Founding Member below for the separate one-time option, subject to availability.
Founding Member: one-time lifetime Sync
Founding Member is a separate, limited offer: $50 one-time for lifetime VesselTill Sync, with up to 5 POS devices on your Google account and white label (no “Powered by VesselTill” on the dashboard and receipts). Unlike standard recurring Sync, there are no monthly or yearly renewals. The standard recurring plan and trial support up to 3 POS devices.
Open Login / Sync and look for the Founding Member card. You can also open the Founding Member options in the POS. The card shows availability; it may be sold out or no longer offered.
Already subscribed? Cancel your existing Sync subscription first using Manage or cancel subscription, then return to the Founding Member option while spots remain. Review your billing status and the current offer before buying; leaving a till group does not cancel a subscription.
Review the one-time purchase terms in the app and payment provider’s checkout before confirming. Once membership is confirmed, the Founder tab shows your private Founder number and View receipt & billing.
14-day refund: request a refund within 14 days of buying through the app’s Contact page (or Contact me in the Founder tab). A full refund ends the membership and releases your Founder number. “Lifetime” means for as long as VesselTill Sync is offered, with at least 90 days’ notice if that ever changes. Refunds are not offered after 14 days. Check your receipt and current in-app terms for your purchase details.
Founding Member changes the plan’s device allowance and billing model—not how stock or orders work. Each till still keeps its own stock and orders, and All tills remains a read-only summary. The free single-device POS stays free whether or not you buy membership.
Back up to Drive and verify success
Sync saves backups to your own Google Drive. Use Back up now when you need a fresh copy, then check the success/status message and timestamp. The Backup tab’s Last backup line distinguishes a downloaded file backup from a Google Drive backup. Pending changes or a stale time are not proof of a completed upload.
Keep the till open and online to let backup finish. A Google reconnect may be needed after reload or token expiry. Offline selling stays local until the connection and eligible Sync access are available again. Keep occasional Full Backup files as a second copy you control.
Restore from Drive follows the same receipt merge and product/profile overwrite rules. Choose the correct till’s backup and first export the current device. A restored backup does not turn two tills into one shared live inventory.
All tills: a read-only summary, not shared stock
When Sync is active, open the Sync tab / All tills view (or View all tills in the multi-till controls). It may reconnect Google before loading Drive. Name each device clearly so you can identify its backup.
Use the view to review combined/by-till sales, payment breakdown, best sellers, staff, returns and low-stock information from uploaded summaries. Read timestamps and currency labels. A till that is offline or has not uploaded recently can show older information.
Each till has separate stock, sales and orders. All tills is read-only; it does not reserve stock, push edits to every till, or share open orders. A second till can have a short till code in receipt numbering to prevent clashes. Do not manually copy device identity or treat file restoration as joining the same live till.
Pause, leave, reconnect and subscription changes
Pause sync: stops sharing while local selling continues. Resume sync resumes the connection/backup flow. Check the last successful upload afterwards.
Leave group: detaches this till from the group while retaining its own local data. Read the confirmation; leaving is not a local-data reset and is not subscription cancellation.
Reconnect Google: refreshes access and current account/plan status. Cached plan text after reload is only what the till last knew.
Trial ended: the app offers plans rather than another trial. Local POS and manual file backups remain available; eligible Drive backup/restore needs a plan.
Manage or cancel subscription: opens the billing flow. Read the stated end date; the app describes access continuing to the end of the paid period after cancellation. Confirm the actual result in billing rather than assuming closing a window cancelled it.
If the device limit or wrong-account message appears, check the signed-in Google account and use Contact if unresolved. Do not clear shop storage to try to bypass trial/device restrictions.
Check the contents of your Drive backup
When Sync is active, its Backup health card shows the last backup and saved receipt/product counts. Check my backup compares the Drive copy with this till. If counts have not been recorded yet, the card explains they appear after a next successful backup; do not mistake that for a guarantee the latest sale is already uploaded.
Use the check before retiring a device or relying on a move. Follow any reconnect/account/error message; never clear local records just because the cloud count differs. Keep a fresh manual Full Backup as a separate copy.
📲 Install as an App
VesselTill is a Progressive Web App (PWA). Installation adds a home-screen or desktop icon. The core till is designed to work offline after its app files have been cached; installation alone is not proof that everything is ready. Open it online first, check Backup’s offline-readiness message, and test reopening on your device before relying on it away from a connection.
→
On Android (Chrome)
A banner will appear at the bottom of the screen asking you to install VesselTill, or tap the install button in the app header. Tap Install — an icon is added to your home screen and the app opens in its own window, without the browser bar.
→
On iPhone / iPad (Safari)
Open pos.html in Safari. Tap the Share button (the box with an arrow), then select Add to Home Screen. Give it a name and tap Add. The VesselTill icon will appear on your home screen.
→
On Windows (Microsoft Store)
Get the Windows app from the Microsoft Store. It is the same VesselTill as the website — it opens in its own window, works offline and keeps your data on your device.
→
On Desktop (Chrome or Edge)
Click the install icon in the address bar (looks like a computer screen with a down-arrow), or use the browser menu → Install VesselTill. The app will open in its own dedicated window.
Offline does not mean every service is offline. Selling and local records are designed to work without a connection once cached. Google sign-in, Drive backup/restore, billing, sending WhatsApp/email messages, support and downloading updates need internet. Network-dependent receipt apps may open a draft offline but cannot deliver it until connected.
Troubleshooting & safe recovery
Start with checks that preserve records. Do not clear browser data, uninstall, or reset the shop as a first fix.
Products missing or prices/stock look wrong
Clear the product search and inspect filters (including Archived). Check that you are in the right browser/profile/device. After import, inspect its summary and detected selling-price/Qty columns. A file with invalid prices can skip rows; a stale Qty column can overwrite counts. Compare with your dated backup before importing again. For a delivery use Stock, not Full Backup restore.
Scanner does not add the product
Check that the product is active, has stock (if counted) and has the expected barcode. Check camera permission for this site. In Scan, try Type Barcode for manual/USB-reader entry. Or focus product search, scan/type the exact code and press Enter. Duplicate barcodes and lost leading zeros can cause confusion; correct the catalogue rather than recording the wrong item.
Receipt/PDF/print/share did not work
First look in Receipt History: confirmation may already have saved the sale. Reopen that receipt instead of charging again. Check Downloads, popup permissions and browser print settings. For WhatsApp/email, check your external app, intended recipient and network; opening a prepared message is not the same as sending it. If a printer is unavailable, save the PDF for later.
Offline reopening fails or a screen seems stale
Reconnect once and open the normal hosted POS in your usual browser/profile. In Backup, check its offline-readiness message. Keep it open long enough for caching and then test reopening on your device before the next offline shift. Do not clear storage to fix caching. Installation and the home-screen icon alone do not guarantee all required files are cached.
For Kitchen/Pickup/Customer Display, keep the original POS window open on the same device/browser/site; check popup blocking and reconnect the display window. A stale display must not be used as proof of an order’s latest payment state.
Google Drive is not updating
Check internet, correct Google account, active plan/trial, paused state and last successful backup. Use Reconnect Google if asked and retry once the status refreshes. A local sale remains on the till even when an upload fails; take a Full Backup file while investigating. All tills reflects uploaded snapshots, so it can lag behind live selling.
My records seem gone
Stop before entering replacement data. Check the original browser/profile, device and exact VesselTill site first. A different storage area can look like a new shop. Look for your dated Full Backup file or the correct Drive backup; read the restore rules before applying it. On-device recovery points cannot help if the browser’s data itself has been erased.
Contact support from the app with device/browser, app version, what happened and exact error text. Redact customer details in screenshots. Never send passwords, Google tokens, card information or a full shop backup unless you have deliberately agreed a secure support process.
⌨️ Keyboard Shortcuts
Press ? in the POS when not editing a field, or use its keyboard icon, to open the in-app list. Most global shortcuts are inactive while a dialog is open. These shortcuts are for the POS—not for this help page.
On a narrow screen, scroll within this table to see all columns. With a keyboard, focus the table area and use the arrow keys.
POS keyboard shortcuts
Task and context
Keys
Focus search / barcode entry
/
Add a single matching search result (while in search)
Enter
Open checkout with a non-empty cart (outside fields/dialogs)
Enter
Increase / decrease the last cart line
+ or = / − or _
Remove the last cart line
Backspace or Delete
Clear the cart
Shift + C
Custom item
N
Barcode scanner
S
Customer Display
M
Tax picker for the last cart line
T
Visible tab by its on-screen position; Orders/Sync may change positions
Search + Enter works like a barcode scanner. Type or scan a barcode into the search bar and press Enter — if it's an exact match, the product is added straight to the cart and the search box clears itself, ready for the next scan. Typing a distinctive part of a product name down to a single match works the same way.
While typing: normal global shortcuts are suppressed in inputs, textareas, selects and editable content. Esc still tries to close a dialog (or blur the field). / focuses search only when you are not editing a field. Payment-method keys work only with the payment dialog open and no field focused.
✨ Tips & Tricks
📞
Save WhatsApp numbers
Tick "Remember this number" when sending a WhatsApp receipt. The number is saved so repeat customers get served faster.
🔢
Quick cash amounts
On the cash payment screen, tap the quick-amount buttons to fill common note denominations in one tap — no typing required.
🔍
Filter history by date
Use the date picker in the Receipt History tab to jump to any past trading day instantly. Clear it to see all-time history again.
🧾
Re-send any receipt
Open any past sale from the Receipt History tab and issue a fresh WhatsApp message, PDF, or printed receipt for it.
🔄
Update product prices
Edit your Excel file and re-upload it at any time. Existing sales and receipts are not affected — only future sales use the new prices.
📱
Works on any screen
On mobile the cart slides up from the bottom. On tablet and desktop the cart sits alongside your product grid. One app, every screen size.
🌍
Multi-currency support
Choose your trading currency from the header before setting prices. This changes currency formatting, not an exchange-rate conversion. Check new receipts and reports after a change.
🔖
Version history
Tap the version badge next to the VesselTill logo in the header to see the changelog — what's new and what was fixed in each update.
🌓
Light & dark mode
The sun/moon icon in the header follows your device's system setting by default, or tap it to switch manually. Your choice is remembered on that device.
ℹ️
About & Terms, right in the app
The POS includes About, Terms & Privacy and a keyboard-shortcut list. Use these for product information and the current in-app shortcut reference.
💬
Got a question or found a bug? Open the Contact tab inside the POS — every message goes directly to the founder. You can also send a compliment if VesselTill is working well for you 🙏