Embed Speed Test Widget - SpeedMeter.dev

Method 1: iframe Embed

The simplest way to add the speed test. Just copy and paste the code.

Basic Usage

<iframe 
    src="https://speedmeter.dev/widget.html"
    width="100%" 
    height="300"
    frameborder="0"
    allow="clipboard-write">
</iframe>

With Options

<iframe 
    src="https://speedmeter.dev/widget.html?theme=minimal&compact=false"
    width="400" 
    height="350"
    frameborder="0"
    style="border-radius: 10px;">
</iframe>

URL Parameters

Parameter	Values	Description
`theme`	default, minimal, dark, transparent	Visual theme of the widget
`compact`	true, false	Compact mode (smaller size)
`hideMetrics`	true, false	Hide download/upload/ping details

Method 2: JavaScript Embed

More flexible integration with customization options via data attributes.

Basic Usage

<script src="https://speedmeter.dev/widget.js"></script>

With Options

<script 
    src="https://speedmeter.dev/widget.js"
    data-theme="minimal"
    data-compact="false"
    data-hide-metrics="false">
</script>

Data Attributes

Attribute	Values	Description
`data-theme`	minimal, dark, transparent	Visual theme (default is gradient)
`data-compact`	true, false	Compact mode
`data-hide-metrics`	true, false	Hide detailed metrics

Receiving Results (JavaScript)

Listen for test completion events:

window.addEventListener('message', function(event) {
    if (event.data.type === 'speedtest-complete') {
        console.log('Download:', event.data.results.download, 'Mbps');
        console.log('Upload:', event.data.results.upload, 'Mbps');
        console.log('Ping:', event.data.results.ping, 'ms');
    }
});

Available Themes

Choose a theme that matches your website design.

Default (Gradient)

theme= (no parameter)

Minimal (Light)

theme=minimal

Dark

theme=dark

Transparent

theme=transparent

Compact Mode

Use compact mode for smaller spaces like sidebars.

Compact Widget

compact=true

FAQ

Is it free?

Yes, the widget is completely free for any website, commercial or personal.

Do I need to register?

No registration required. Just copy the code and paste it into your website.

Are there usage limits?

No hard limits for reasonable use. If you expect very high traffic, please contact us.

Can I customize the appearance?

Yes, you can choose from 4 themes and use compact mode. For deeper customization, contact us.

Does it work on mobile?

Yes, the widget is fully responsive and works on all devices.

Need Help?

Have questions or need custom integration?

Contact Support