The hotspot login page is the first thing customers see when they connect to your Wi-Fi. The default MikroTik page works, but it has a plain design and doesn’t reflect your business’s identity. With your own template, customers immediately see the network name, a list of plans, and your admin’s contact information.
This guide applies to MikroTik routers running RouterOS v6 or v7 with the Hotspot Server enabled.
What You’ll Need
- A MikroTik router with Hotspot Server already active and ready for login.
- The WinBox app (or WebFig access) with the router’s admin account.
- A template file in ZIP format, such as a template you purchased from our store.
- A laptop connected to the router, and one smartphone for testing.
Step 1: Back up the old hotspot folder
Before changing anything, save a copy of the current login page. In WinBox, open the Files menu, locate the folder named hotspot (or whatever name your hotspot profile uses), then drag that folder to your laptop’s desktop. If the new template causes issues, you can simply upload this folder again.
Step 2: Customize the template configuration file
Extract the template’s ZIP file on your laptop. Most modern templates provide a single configuration file, usually config.js. Open it with a text editor like Notepad++ or Visual Studio Code, then change:
- network name or business name,
- the admin’s WhatsApp number,
- list of packages and prices,
- colors or logo, if available.
Save the file; do not change the names of other files called by the router, such as login.html, status.html, and logout.html.
Step 3: Upload the template to the router
In WinBox, open Files, create a new folder—for example, hotspot-baru, then drag the entire contents of the template folder (including the assets folder, such as assets or img) into it. Make sure the folder structure matches exactly that on your laptop. For slow networks, uploading via FTP may be more stable.
Step 4: Point the hotspot profile to the new folder
Go to IP → Hotspot → Server Profiles, select the profile used by your hotspot server, then change the HTML Directory field to hotspot-baru. Click OK. From that point on, the router will use the pages from the new folder.
Step 5: Test from Your Phone
Disconnect your phone from Wi-Fi, reconnect, then open a browser. The new login page should appear automatically. Test the following:
- Log in with a member account and with a voucher code.
- Enter an incorrect password to see the error message.
- After successfully logging in, open the status page and try the logout button.
If the page doesn’t appear automatically, type your hotspot’s DNS name (for example login.wifi) into your browser.
Common issues
- The display is messy without images: the assets folder hasn’t been uploaded yet or the folder name has changed.
- The old page is still showing: the HTML directory hasn’t been updated, or your phone’s browser is still holding the cache. Try incognito mode.
- The QR feature cannot open the camera: the browser only allows camera access on HTTPS pages. Other features continue to work.
Keep the old hotspot folder for at least a few days until the new template has proven to be stable.
With the steps above, updating the hotspot login screen takes about 10 to 15 minutes, without needing to change existing user or voucher settings.



