1. Open the Machines Tab
From the bottom navigation bar, tap the Machines icon. It will turn green when active.
The Machines tab displays all machines assigned to your account. Each machine card shows:
Machine name and machine number
Location address (if configured)
Connection status — Online (green badge) or Offline
Stock bar — a color-coded bar showing overall stock health:
🟢 Green bar — all aisles in stock
🟠 Orange segment — one or more aisles running low
🔴 Red segment — one or more aisles disabled
7-day sales indicator
At the top of the screen you can:
Use the Search bar to find a machine by name or number
Filter your list by All, Online, or Offline
Toggle between List view and Map view using the icons on the right
2. Open a Machine — Overview Tab
Tap any machine card to open its detail screen. The machine will open on the Overview tab by default.
🔴 Red arrow — the Overview tab, currently active
🟢 Green arrow — the machine's Online status badge
🔵 Blue arrow — the Machine Configuration icon (sliders icon, top-right corner) for advanced settings
The Overview tab gives you a full snapshot of the machine:
Sales Summary — revenue for the last 7 days and last 30 days
Aisle Stock — a numbered grid showing the status of every aisle:
🟢 Green — In stock
🟠 Orange — Low stock
⚫ Grey — Out of stock
🔴 Red — Disabled
Last Transaction — the most recent completed sale on this machine
Location — the machine's address and location name, both editable via the ✏️ pencil icon
Machine Overview (Bottom)
🔵 Blue arrow — the Advanced → link under Quick Settings, which opens the full Machine Configuration screen
🟠 Orange arrow — the eye icon next to Machine Password, used to view your machine's current admin password
Scrolling down on the Overview tab also reveals:
Photos — tap the camera icon to add up to 8 machine photos for reference
Quick Settings — shortcuts for Screen Saver Ad and Top Banner Ad toggles
Advanced → link (🔵 blue arrow) — opens the full Machine Configuration screen covered in Step 5
3. Aisle Config Tab — Manage Your Aisles
Tap the Aisle Config tab from the top of any machine screen.
🔴 Red arrow — the Aisle Config tab, currently active
🟢 Green arrow — the toggle switch on an individual aisle card (enabled = green, disabled = grey)
At the top of the Aisle Config screen, a summary bar shows:
Total — total number of aisles on this machine
No Stock — aisles with zero stock remaining
Disabled — aisles currently turned off
Unassigned — aisles with no product assigned
Each aisle card displays:
Aisle number and toggle switch (enable/disable the aisle)
Product image and name
Retail price
Stock level bar and current stock count (e.g., 11 / 12)
− and + buttons to manually adjust the stock count
Fill button to quickly set the stock back to maximum capacity
4. Aisle Detail View — Edit a Single Aisle
Tap any aisle card to open its full detail screen.
🔴 Red arrow — the assigned product field, showing the product name where it can be modified.
🟢 Green arrow — the Fill to max shortcut, which instantly restores stock to the maximum quantity
Inside the aisle detail screen you can configure:
Product (🔴 red arrow) — the product currently assigned to this aisle. Tap the × to remove it and assign a different product
Selling Price — the retail price displayed to customers on the machine screen
Current Stock — adjust the quantity using the − and + buttons, or tap Fill to max (🟢 green arrow) to restore to full
Max Stock — the maximum number of units this aisle can hold
Low Stock Alert — the threshold at which a low-stock notification will be triggered
Age Verification — Minimum Age — set the minimum required age for purchasing this product (enforced only when age verification is enabled on the machine)
Tap Save Changes when done to apply all updates to the aisle.
5. Disabling an Aisle
To disable an aisle, tap the toggle switch on the aisle card in the Aisle Config screen and switch it to the off position.
🔴 Red arrow — pointing to the Disabled counter (showing 1) and the disabled aisle card (aisle 20), highlighted in red with a 🚫 icon and grey toggle
A disabled aisle will:
Show a 🚫 icon and a red outline on the card
Appear with a red stock bar
Be counted under Disabled in the summary bar at the top
No longer dispense product to customers until re-enabled
To re-enable the aisle, simply tap the toggle back to the on (green) position.
6. Machine Configuration — Advanced Settings
Tap the sliders icon (🔵 blue arrow, Screenshot above) in the top-right corner of any machine screen, or tap Advanced → (🔵 blue arrow, Screenshot above) from the Quick Settings section to open the full Machine Configuration screen.
Advertising
Enable Screen Saver Ad — turn on to display a screen saver advertisement when the machine is idle
Enable Top Banner Ad — turn on to show a banner ad at the top of the machine display
Enable Product Categories — turn on to display product category filters on the machine screen
Error Handling
Close Aisle upon Failed Dispense — when enabled, the aisle will automatically be disabled if a dispense attempt fails
Auto lock screen on serious failure — when enabled, the machine screen will lock automatically if a critical error is detected
Administrator
Machine Password — view or update the machine's access password
Machine debugging switch — enable for diagnostic and troubleshooting purposes
Enable Coupons — turn on to allow coupon codes to be used on this machine
Machine Mode, Shopping & Age Verification
Machine Mode
Machine mode — set the machine's operating mode (e.g., buyMode) using the dropdown selector
Enable prompt prior to purchase — when enabled, customers will see a confirmation prompt before completing a purchase
Shopping Cart
Enable Add to Cart — allows customers to add multiple products to a cart before checking out
Shopping Tips
Prompt switch — enables a tip prompt at checkout
Age Verification
Enable Age Verification — when enabled, customers must verify their age before purchasing age-restricted products
Refund Sensor
Enable Refund Sensor — when enabled, the machine will detect and process failed dispenses for automatic refunds
Electronic Lock & Payment
Electronic Lock (applies only to machines equipped with an electronic lock)
Electronic lock switch — enable to activate the machine's electronic locking mechanism
Payment
Accept Cash — enable to allow cash payments on this machine
Accept Credit Cards — enable to allow card payments via the connected card reader
Tap Save at the bottom of the screen after making any changes to apply the configuration to your machine.
7. Details Tab — Machine Information
Tap the Details tab from the top of any machine screen.
🔴 Red arrow — the Details tab, currently active
🔵 Blue box — highlighting the Subscription Expiry date, an important field to monitor
The Details tab is divided into two sections:
Machine Info
Machine Name — the display name of your machine (editable via ✏️)
Location — the physical address of the machine
Machine No — the unique machine serial number. Tap the copy icon to copy it to your clipboard
Subscription Expiry (🔵 blue box) — the date and time your VapeTM subscription expires for this machine. Monitor this to avoid any service interruptions
Machine State — current connectivity status (Online / Offline)
Machine Group — the group this machine belongs to (editable via ✏️)
Contact Info
Contact Name — the name of the on-site contact for this machine location (editable)
Phone — contact phone number for this location (editable)
Email — contact email address (editable)
Install Date — the date the machine was installed at this location (editable)
Notes — a free-text field for site notes, access instructions, or any other relevant information
⚠️ Important Notes
Subscription Expiry: Always keep an eye on the Subscription Expiry date in the Details tab. If your subscription lapses, machine functionality and remote management access may be affected. Contact support at [email protected] to renew.
Disabled aisles: A disabled aisle will not dispense products to customers. Always review the Aisle Config summary bar after restocking to ensure no aisles remain unintentionally disabled.
Save your changes: Any changes made in Machine Configuration or Aisle Detail screens will not take effect until you tap the Save or Save Changes button.
🔑 Machine Password: Keep your machine password secure. Use the eye icon to verify it without changing it.