The Orizn visa checker widget answers "do I need a visa?" for 199 passports across 250 destinations in 16 languages. Drop two lines of HTML on any destination guide and your readers get live policy data sourced from 200+ government feeds.
What it does
The visa checker widget is the most-requested embed in our suite. It answers the single most common question travel content has to handle — "do I need a visa?" — without sending readers to a third-party site and breaking your funnel.
Under the hood, the widget queries Orizn's visa graph: a database of 39 601 passport-destination cells reconciled nightly from embassy feeds, IATA, government press releases, and our scraper of 200+ official sources. Each cell carries policy type (visa-free, visa-on-arrival, e-visa, embassy, refused), max stay, processing time, fee, and source-of-truth URL.
Readers select their passport from a searchable picker (199 options, native-language names), tap their destination, and the result card returns in under 200 ms with the rule, the next-step CTA, and an optional affiliate link to the full Orizn travel guide for that destination. The widget is fully self-mounting — no init function to call, no React provider to wire — and works on any HTML page, every major CMS, and inside React/Next.js via next/script.
Widget builder
The widget below runs the exact production script you'd paste on your own site. Every option updates the preview and the snippet instantly — language, theme, colors, white-label, then copy the two-line snippet.
Live preview · updates as you type
The widget above runs the exact production script you would paste on your own site — async, zero dependencies, scoped CSS. Every option on the left maps to a data-* attribute in the snippet.
Features
Specific, sourced features — not generic checkboxes. Every item below is in the production widget today.
Visa rules change without notice. Our pipeline pulls from 200+ official embassy sites, IATA, and Timatic-equivalent feeds every 24 hours and reconciles conflicts before publishing.
Full ISO 3166-1 coverage. Visitors pick their passport once and the widget remembers it across return visits via a single first-party cookie.
When a visa is required, the widget surfaces the nearest embassy or e-visa portal with a direct link, no extra clicks.
Result card shows the destination's average daily budget and the visitor's passport mobility score, so the widget answers three questions at once.
One tap copies a deep link with the visitor's passport pre-filled, so they can DM the result to a travel partner without losing context.
Auto-detects the visitor's browser language. Pin a specific locale with data-lang if your audience is single-language.
Add data-affiliate="ORIZN-XXXXX" (aff_… codes are accepted too) and every guide purchase routes 50% to you, attributed for 30 days post-click.
Vanilla JS, no React, no jQuery. Lighthouse impact is negligible and CSS is scoped to avoid clashes.
Where it shines
The widget is general-purpose, but four audiences ship it most often. Recognize yourself in any of these and you'll get value within minutes of pasting the snippet.
Embed once at the top of every country guide. Readers answer "do I need a visa for Vietnam?" without leaving your article.
Drop the widget on existing posts with high traffic. The 50/50 guide revenue share monetizes pages that AdSense underpays.
Add the widget to your welcome page or a pinned post. Subscribers get instant visa lookups, you get attributed sales.
Pin the widget on your /resources page. Members coordinating their next country hop check eligibility in seconds.
How the data is sourced
Visa policies are reconciled from official embassy feeds, IATA Timatic-equivalent sources, government press releases, and an in-house Rust scraper covering 200+ ministry sites. Every cell exposes its source URL on hover, and the entire graph is rebuilt nightly with a quality gate that requires two-source agreement before publishing a policy change.
Reference
Every option is a data-* attribute on the container div. No JavaScript configuration is required — paste, set the attributes you want, ship.
| Param | Type | Default | Description |
|---|---|---|---|
data-destination | ISO3 | "" | Pre-fill the destination country (e.g. VNM, THA, JPN). Visitors can still change it. |
data-lang | string | "auto" | Override the auto-detected browser language. Accepts 16 locales: en, fr, es, de, it, pt, ja, ko, zh, ru, ar, hi, th, vi, tl, tr (Arabic renders RTL). |
data-theme | string | "auto" | Force theme: "auto" (follows OS), "light", or "dark". |
data-affiliate | string | "" | Your ORIZN-XXXXX or aff_… code (both formats work). Required to earn the 50/50 revenue share on guide sales. |
data-show-score | bool | true | Toggles the visa-free score chip in the result card. |
data-show-budget | bool | true | Toggles the inline daily budget estimate under the visa result. |
data-show-guide | bool | true | Toggles the "Buy the full travel guide" CTA used for affiliate conversions. |
data-color | hex | #2563EB | Accent color used for buttons, focus rings, links and result chips. Hex values only (sanitized). |
data-branding | string | "on" | Set to "off" to white-label: hides the "Powered by Orizn" footer, the JSON-LD schema and the orizn.app mention in share texts. |
data-radius | int | 16 | Corner radius in px for the widget card and inputs. |
data-font | string | "system-ui" | Font-family used across the widget. Any CSS font stack works. |
data-no-cookie | bool | false | GDPR mode: when true, the widget writes no cookie at all (passport memory across visits is disabled). |
data-api-key | string | "" | Optional Orizn API key. When set, checks count against your plan's quota instead of the shared public pool. |
Integrations
Same two-line snippet, slightly different paste path depending on your stack. Detailed step-by-step guides per CMS:
Monetize
Add data-affiliate="ORIZN-XXXXX" to the container div — both ORIZN-… and aff_… code formats are accepted. Every guide purchase a reader makes through the widget is attributed to you for 30 days, with payouts processed monthly via Stripe. No minimum, no clawback, full transparency on the affiliate dashboard.
FAQ
Real questions from developers, bloggers and affiliate marketers integrating the widget. If yours isn't here, the docs at /embed/getting-started cover the long tail.
Related widgets
All five widgets share the same runtime, so adding a second one to the page costs nothing extra. The suite is designed to be combined.
Live daily, monthly, yearly cost for 195 countries in 50+ currencies.
Mobility rank + 4-axis breakdown for 199 passports, refreshed nightly.
Side-by-side cost, visa, safety and climate for any two countries.
Personalized documents, vaccines, packing and money checklist per trip.
Ready to embed?
Two lines of HTML, zero dependencies, free forever. Add an affiliate code and start earning 50% on every guide your widget sells.