Builder Widgets
Counter Widgets
Domain Widgets
Geoip Widgets
Speed Widgets
Weather Widgets

Embed a widget

To embed a widget you must first include this line of code one time in your web page:

  <script src="https://widget.vpn.com/vpn-widget.js"></script>
To place an embeddable widget in your web page create a div with class="vpn-widget" and type="[widget name]"




Optional attributes

  • class - You may assign any additional css classes to the containing div as you'd like.
  • border-color - You may specify a border color without using custom css. This value will be overridden by a style, if selected. You may specify a color or a hex triplet.
  • style - Because the widget is embedded in a <div> element you may specify your own styling for the contents of that div.
  • width - To size the widget specify the width attribute. The height will be calculated based on the width specified.
  • lang - Translate the widget to a specific language e.g. en, it, es.
  • units - For Weather widgets only you may choose 'imperial' or 'metric'.
  • layout - For some Weather widgets only you may choose 'vertical' (default) or 'horizontal'.
  • days - For Weather forecasts the number of days to show beginning with today.
  • scroll-days - For Weather forecasts limit the number of visible days and scroll the remainder.


By default the browser language will be used to translate each widget. You may override this with the `lang` optional attribute.


Widgets contain their own individual styling but you can use CSS to extend and override those styles. Widgets are wrapped in their own div which will be placed inside the div on your web page.

For instance, to change the widget title to red do so in a style and assign the class to your containing div:

    .red-header header {
        color: red;

  <div class="vpn-widget red-header" type="geoip/location">Loading...</div>
Use the !important css directive to do a hard override of any css style.