Skip to content
NETMETRİKDocumentation

DocumentationConfiguring the widget

Configuring the widget

You configure the widget's appearance and behavior from the configuration screen. The live preview on the right shows every change instantly; when you save, the embedded widgets update.

Last updated: 12 July 2026

General

  • Widget name: Visible only in your own panel; used to tell widgets apart.
  • Theme: The visual layout of the test — HIZTESTI Style (the default), OOKLA Style (side-by-side gauges + a live histogram), Classic (the same needle gauge as on consumer HIZTESTI.COM), LED Style (a plain large number on a dark panel) and Arc (a thin arc gauge).
  • Maximum speed: The gauge's upper limit. With Automatic selected, the scale adapts to the measured speed; with a fixed value selected, the gauge is always drawn against that limit.

Colors and logo

  • Background color and accent color: A six-digit HEX code (e.g. #0B1220).
  • Company logo: Upload a PNG or JPG file (up to ~1 MB) or enter a logo URL (only https://). For security reasons, SVG and other formats are not accepted.
  • Logo alt text: A short text describing the logo, for accessibility.

Icons

You choose the icons representing the client (user) and server sides in the test flow from ready-made sets: client icon (device, laptop, tablet, phone, user, globe) and server icon (server, tower, dish, satellite, cloud, database).

Metrics

Choose which measurements appear on the result card:

  • Speed unit: Mbps or MB/s.
  • Show latency (ping), Show jitter, Show upload speed — turning test phases on and off.
Turning phases off is an Enterprise feature
Download is always shown. Being able to turn off the latency / jitter / upload phases is available on the Enterprise plan only; on the Free and Business plans these phases stay on. Details: Plans and quota.

Server selection

When Allow server selection is off, the server picker is not shown in the widget and the test always runs on the lowest-latency server. Useful when you do not want visitors changing the result by trying a different server.

You can also decide which server the test runs on: pick one from "Server for this embed" on the Embedding tab and the embed code below is updated with data-server-id. This is not a setting — it is not saved, it is only written into the code you copy, so you can embed the same widget on different pages with different servers. If you pick nothing, the test goes to the lowest-latency server automatically.

Enterprise plan only
Disabling server selection and pinning a server to an embed are available on the Enterprise plan. Pinning only applies in shared network mode; if you test against your own servers, your own server is used anyway. Details: Plans and quota.

Language

The widget is translated automatically into 20 languages and picks the language from the visitor's browser settings — no configuration needed. If an unsupported language is selected, the test is shown in English. In Arabic and Hebrew the interface flows right to left.

Supported: Arabic · Simplified Chinese · Traditional Chinese · Danish · Dutch · English · German · French · Hebrew · Indonesian · Italian · Japanese · Korean · Polish · Portuguese · Russian · Spanish · Swedish · Thai · Turkish.

Custom translation — Enterprise
To enforce your own terminology, pick a language under Custom translation on the Interfacetab and write the texts you want (for example "DOWNLOAD SPEED" instead of "DOWNLOAD"). Anything you leave empty keeps the standard translation — you do not have to fill them all in.

Running the test only on your own URLs

When this switch on the Embedding tab is on, the test runs only when embedded on sites in your allowed-domain list; direct testing from your branded subdomain (yourbrand.hiztesticustom.com) is disabled.

Add an allowed domain first
If your allowed-domain list is empty, turning this on would stop the widget from working anywhere — that is why the switch is disabled while the list is empty. The setting is available on the Enterprise plan and is not a display preference but a server-side restriction: an embed on an unlisted page cannot start a test.

Test settings

  • Internet protocol version: Automatic (IPv6, falling back to IPv4), IPv4 only or dual-stack. Automatic is suitable for most sites.
  • Require a password: When enabled, the visitor enters the password you set before starting the test. Suitable for internal/restricted use. This feature is available on the Business and Enterprise plans; the password is stored securely on the server (it is not shown back in plain text).
  • Start automatically on page load:When enabled, the widget starts a test on its own on every page load where it is embedded (the "auto start on load" behavior). If a password is required, the test starts once the password has been verified.
Consumes quota on every view
With auto-start enabled, every page load where the widget appears runs a test and consumes your monthly quota — even if the visitor never clicks anything. Keep in mind this can burn through your quota quickly on high-traffic pages.

Test servers

Here you choose which servers the widget will run the test on: the shared HIZTESTI Servers Network (default, quota applies) or my own servers (paid plans; you select from your approved servers added to the network, unmetered). Details: target mode.

Publishing

When you save your changes, the embedded widgets pick up the new settings on their next load. To stop a widget temporarily, you can pause it; a paused widget does not serve a test on the pages where it is embedded. For allowed domains and the embed code, see the related article.