Overview
This guide walks you through the process of creating a custom display theme for your vending machine and assigning it to the correct machine in the VapeTM portal.
Step 1 — Navigate to Display Customization
1.1 Log in to your VapeTM Portal
1.2 From the left-hand navigation menu, click on "Applications" (indicated by the top 🔴 red arrow) to expand the submenu.
1.3 Select "Display Customization" (indicated by the bottom 🔴 red arrow).
1.4 On the main page, you will see two options under "My Application". Click on the "Theme Management" card (indicated by the 🔵 blue arrow as shown).
Step 2 — Add a New Theme
2.1 You will land on the Theme Management tab. If no themes have been created yet, the table will display "No Data".
2.2 Click the "+ Add" button in the top-left corner (indicated by the 🔴 red arrow) to begin creating a new theme.
Step 3 — Select Screen Orientation & Theme Template
3.1 A "Create a theme" dialog will appear.
3.2 First, select your machine's screen orientation at the top of the dialog (indicated by the 🔴 red arrow):
Portrait Screen — For vertically oriented machine displays
Landscape Screen — For horizontally oriented machine displays
3.3 Next, select a Theme Template from the grid of layout options.
3.4 A live preview of the selected template will appear on the right-hand side of the dialog.
Step 4 — Configure Theme Name, Colors & Product Display
4.1 Scroll down within the dialog to access the theme configuration fields (as shown below).
4.2 Enter a Theme Name in the text field (e.g., "default" or "Black").
4.3 Select a Theme Color using the color picker dropdown — this sets the dominant tone for your theme.
4.4 Under Background Color Setting, configure the following:
Background Color — Main screen background
Popup Background — Background for pop-up windows
Label Background — Background for product labels
Product Tag Background — Background for product tags
4.5 Under Font Color Setting, configure the following:
Bid Price — Color for pricing text
Text — General text color
Content — Body content text color
Other — Miscellaneous text elements
Button Text — Text color on buttons
4.6 Under Product Display, configure the following:
Window Background — Upload a background image for product display windows. (🔴 Red arrow indicates the recommended size: 1000×380px, PNG format recommended)
Sold Out Label — Upload a custom "Sold Out" label image. (Recommended size: 110×75px)
Top Light — Upload a top light image for the display. (Recommended size: 200×200px)
Sell Out Button — Button displayed when a product slot is sold out (Recommended size: 120×38px)
Add to Cart Button — Button used when a customer adds a product to their cart (Recommended size: 60×38px)
Buy Button — Button displayed for direct product purchase (Recommended size: 60×38px)
Product Tray — Image representing the product tray in the display window (Recommended size: 120×40px)
4.7 Each product display element also has a Transparency slider — adjust this to control how visible the overlay appears on screen.
Step 5 — Preview & Confirm Your Theme
5.1 As you make changes, the live Vending Machine preview on the right side of the dialog will update in real time (as shown below).
5.2 Review the preview carefully to ensure your theme looks as intended before saving.
5.3 Once satisfied with your configuration, click the "Confirm" button at the bottom-right of the dialog to save the theme.
Step 6 — Verify the Theme Was Saved
6.1 After clicking Confirm, you will be returned to the Theme Management page.
6.2 A green "Theme added successfully" banner will appear at the top of the page (as shown below), confirming your theme has been saved.
6.3 Your new theme will now appear as a row in the Theme Management table, displaying:
User Account
Theme Name
Theme Template
Dominant Tone
Machine (empty until assigned)
Operation buttons: Add Machine | Machine Manage | Edit | Delete
Step 7 — Assign a Machine to the Theme
7.1 Locate your newly created theme in the table and click the "Add Machine" button in the Operation column (as shown below).
7.2 An "Add Machine" pop-up dialog will appear, listing all machines available under your account.
7.3 You can search for a specific machine using the Machine Number, Machine Name, or Machine Group Name fields, then click "Search".
7.4 Once you locate the correct machine, click the "Select" button in the Operation column next to it.
Step 8 — Confirm Machine Assignment
8.1 After clicking "Select", the button will change from blue "Select" to a red "Cancel" button (as shown below), confirming the machine has been successfully linked to the theme.
8.2 Close the dialog to return to the Theme Management table. Your machine will now appear in the "Machine" column of the theme row.
Important Notes
Image Format: Always use PNG format for Window Background, Sold Out Label, and Top Light uploads for best display quality.
📐 Recommended Image Sizes:
Window Background — 1000×380px
Sold Out Label — 110×75px
Top Light — 200×200px
Editing a Theme: You can always return to the Theme Management table and click "Edit" to update your theme settings at any time.
Deleting a Theme: Use the "Delete" button to remove a theme. Ensure the theme is not actively assigned to a machine before deleting.
One Machine Per Theme: Each machine can only be assigned to one active theme at a time. If you need to reassign, remove the current assignment first using the "Cancel" button in the Add Machine dialog.