Developers / Embeddable widget
Free "What Is My IP" widget for your website
One script tag. Visitors see their public IP address, city, country and internet provider, live, in a box that matches your site. No account, no API key, no tracking cookies.
1. Paste this where you want the box
<script src="https://www.ipaddressdetails.com/widget.js" async></script>2. Customise (optional)
Options reference
| Attribute | Values | Default |
|---|---|---|
| data-theme | dark, light | dark |
| data-layout | card, inline | card |
| data-fields | comma list of ip, location, isp, asn, timezone, hostname | ip,location,isp |
| data-title | any text; "" hides the heading | Your IP address |
| data-target | CSS selector of a container to render into | after the script tag |
iframe version
For page builders that strip scripts. Query parameters: theme, fields, title.
<iframe src="https://www.ipaddressdetails.com/widget/embed?theme=dark" width="320" height="180" style="border:0" loading="lazy" title="Your IP address"></iframe>Live preview
This is the real widget running on this page, showing your connection.
Licence
Free for personal and commercial sites. Keep the "Powered by IP Address Details" link visible and unmodified; that link is how the widget stays free. Do not proxy or cache the API responses for other purposes — for that, get a free API key (1,000 requests/day) instead.
Need the raw data?
The widget calls our IP Geolocation API. Use it directly for server-side geolocation, fraud checks or localisation.
curl https://www.ipaddressdetails.com/api/v1/ip/8.8.8.8Frequently asked questions
Is the widget free?
Yes, for any website, personal or commercial. The only condition is that the "Powered by IP Address Details" link stays visible. Lookups run against our free API tier, which is rate-limited per visitor, not per site.
Does it slow my page down?
No. The script is ~3 KB, loads async, injects one stylesheet and makes a single JSON request. It never blocks rendering and fails silently if our API is unreachable.
What data does it collect about my visitors?
The visitor's browser requests its own IP details from our API. We log the request for rate limiting and aggregate usage statistics only; we do not set cookies, fingerprint, or share visitor data with third parties. See our privacy policy.
Can I style it to match my site?
Use data-theme="light" or "dark", choose card or inline layout, and override the .ipad-widget CSS classes on your own stylesheet. Keep the attribution readable.
Can I use it inside WordPress, Webflow, Notion or Ghost?
Anywhere you can paste an HTML/script embed: a WordPress Custom HTML block, Webflow Embed element, Ghost HTML card. Notion does not run third-party scripts; use the iframe version there via an embed proxy.
Is there an iframe version?
Yes — https://www.ipaddressdetails.com/widget/embed renders the card standalone. Add ?theme=light or &fields=ip,location. Use it where scripts are blocked.