Skip to content
NETMETRİKDocumentation

DocumentationQuick start: embed the widget on your site

Quick start: embed the widget on your site

The whole flow, from creating your branded speed-test widget to embedding it on your site. With the free tier you can go live within minutes, without hosting a server.

Last updated: 12 July 2026
Prerequisite
A corporate account on the portal is enough — HIZTESTI Custom does not require server hosting. The free tier offers a single widget and a monthly test quota.

  1. Create a widget (deployment)

    Go to the HIZTESTI Custom page in the portal and create a deployment with New widget. A deployment is a single branded test that you will embed on your site; give it a name you will recognize (e.g. "Corporate site speed test").

  2. Set your branding

    From the configuration screen, choose the template, the background and accent color, your logo and the metrics to display. The live preview on the right shows the changes instantly. All options: Configuring the widget.

  3. Add your allowed domain

    In the Allowed domains section, add the site where the widget will run (e.g. kurum.com, or *.kurum.com for all subdomains). This list prevents others from using your code on their own site.

    If the list is empty
    If the allowed-domains list is left empty, the widget runs anywhere. In production, be sure to add your own domain.

  4. Copy the embed code

    Copy the embed code at the bottom of the configuration screen:

    HTML
    <!-- HIZTESTI Custom -->
<div id="hiztesti-test"></div>
<script src="https://hiztesticustom.com/v1/widget.js" data-id="<WIDGET-ID>" async></script>

    For environments where you cannot use a script (some CMSs, dashboards), an iframe alternative is also provided. Details: Embed code and allowed domains.

  5. Paste it into your site and publish

    Add the code to the page where you want the test to appear (that is, where the <div id="hiztesti-test"> element sits). When the page loads, the widget appears with your branding and visitors can start the test.

Trying it before going live
The Open live test page link on the configuration screen opens the widget at full size on a real page — you can test the look and the flow before embedding it on your site.

Settings

Two settings that change widget behavior without touching the embed code:

  • Maximum speed (Interfacetab): with "Automatic" selected, the gauge scale adjusts itself to the measured speed. Pick a fixed value to always draw the gauge against that ceiling.
  • Auto-start on load (Test tab): the test starts as soon as the widget is displayed. Every view counts against your monthly quota. On a password-protected widget, the test starts after the password is verified.

Next steps