MikroTik Guide

How to Set Up a MikroTik Hotspot Login Template (Step-by-Step)

A complete guide to replacing the default MikroTik hotspot login page with your own template: back it up, upload it via WinBox, configure the hotspot profile, and then test it on your phone.

Cara Memasang Template Login Hotspot MikroTik (Langkah demi Langkah)

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:

  1. Log in with a member account and with a voucher code.
  2. Enter an incorrect password to see the error message.
  3. 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.

Tim Digitize Store

The Digitize Store team: technicians and digital product makers helping you choose and use technology well.

✉ Newsletter

Practical tech tips, straight to your inbox

Free. Pick your topics and unsubscribe any time.