eSIM Plan Finder Tool

Embeddable widget for displaying eSIM plans on your website with customizable options.

Quick Start

Add this single line of code where you want the widget to appear:

Basic Installation
Copy and paste this code into your HTML
<script
  async
  src="https://esimcardlist.com/external/widget.js?locale=en"
></script>

Parameters

Customize the widget behavior using URL parameters:

locale
Set the widget language

Default: en

Available options:

  • en - English
  • de - German
  • es - Spanish
  • fr - French
  • ru - Russian
  • tr - Turkish
country
Pre-select a country by ISO code

Default: none

Examples:

  • US - United States
  • AE - United Arab Emirates
  • DE - Germany
  • JP - Japan
color
Customize the button color (hex, URL-encoded)

Default: #2563eb

Note: The color must be URL-encoded in URL. For example, #2563eb becomes %232563eb.

Live Demo

See widget in action with different configurations:

Basic Widget (English)
Default English widget
Widget with Custom Color
Green button color (#059669)
Widget with Pre-selected Country
Germany (DE) pre-selected

Examples

Here are some common usage patterns:

Basic Usage
Simple English widget with default settings
<script
  async
  src="https://esimcardlist.com/external/widget.js?locale=en"
></script>
German with Custom Color
German language with green button
<script
  async
  src="https://esimcardlist.com/external/widget.js?locale=de&color=%23059669"
></script>
Pre-selected Country (Japan)
English widget with Japan pre-selected
<script
  async
  src="https://esimcardlist.com/external/widget.js?locale=en&country=JP"
></script>
All Options Combined
French language, France pre-selected, red button
<script
  async
  src="https://esimcardlist.com/external/widget.js?locale=fr&country=FR&color=%23dc2626"
></script>

Features

  • Async Loading – Non-blocking, won't slow down your page
  • Shadow DOM Isolation – Widget styles won't conflict with your site's CSS
  • 6 Languages – English, German, Spanish, French, Russian, Turkish
  • Keyboard Accessible – Full keyboard navigation (Arrow keys, Enter, Escape)
  • Responsive – Works on mobile and desktop
  • Customizable – Button color can match your brand
  • Lightweight – No impact on page load times
  • Fail-safe – On error, widget simply doesn't appear

Browser Support

  • Chrome 81+
  • Firefox 86+
  • Safari 14.1+
  • Edge 81+

Note

The widget uses Shadow DOM for complete style isolation. Your website's CSS will not affect the widget, and the widget's CSS will not leak into your page.