Docs

Getting Started

Embed Orizn travel widgets on your site in under 60 seconds. Five widgets, one script tag, every major CMS supported.

Quick start Platforms Widgets Parameters Theming FAQ

Quick start

Three steps, 60 seconds

Choose a widget, copy the snippet, paste it into your HTML. No build step, no API key required.

Choose a widget

Pick one of the five widgets on the landing page. Each one is self-contained, under 15 KB, and works independently.

See widgets

Copy the snippet

Two lines: a container div and an async script tag.

html

<div id="orizn-visa"></div>
<script src="https://visa.orizn.app/embed/visa.js" async></script>

Paste in your HTML

Works out of the box in WordPress, Ghost, Substack, Webflow, Framer, Wix, and any raw HTML page. The widget mounts itself the moment the script loads.

WordPressGhostSubstackWebflowFramerWixRaw HTML

Platforms

Snippets for every stack

Same widget, slightly different paste path depending on where you're publishing.

Drop the two lines anywhere inside the <body> of a static site.

html

<div id="orizn-visa"></div>
<script src="https://visa.orizn.app/embed/visa.js" async></script>

Widgets

All five snippets

Each widget ships its own script. Mix and match on the same page — the runtime is shared.

html

<div id="orizn-visa"></div>
<script src="https://visa.orizn.app/embed/visa.js" async></script>

Reference

Parameters

Every option is a data-* attribute on the container div. No JavaScript configuration required.

Common to all widgets

Param	Type	Default	Description
`data-lang`	string	"auto"	Override the auto-detected browser language (16 locales: en fr es de it pt ja ko zh ru ar hi th vi tl tr — ar renders RTL).
`data-theme`	"auto" \| "light" \| "dark"	"auto"	Forces light/dark theme. Default follows the visitor's OS.
`data-affiliate`	string	""	Your ORIZN-XXXXX or aff_… code (both formats work). Required to earn the 50/50 share.
`data-color`	hex	#2563EB	Accent color used for buttons, focus rings and CTAs (hex only).
`data-branding`	"on" \| "off"	"on"	White-label mode. "off" hides the “Powered by Orizn” footer, JSON-LD schema and orizn.app share mentions.
`data-radius`	int (px)	16	Corner radius of the widget card, in pixels.
`data-font`	font-family	system stack	Font family used across the widget.
`data-api`	origin URL	https://visa.orizn.app	Override the API origin (staging or proxy setups).
`data-no-cookie`	bool	false	Disables the orizn_passport cookie used for return-visit pre-fill.

Widget-specific

Param	Applies to	Type	Description
`data-destination`	visa, budget, checklist	ISO3	Pre-fill destination country (e.g. THA, JPN, USA).
`data-passport`	score, checklist, compare	ISO3	Pre-fill passport country (e.g. FRA, USA, DEU).
`data-country1`	compare	ISO3	First country to compare side-by-side.
`data-country2`	compare	ISO3	Second country to compare side-by-side.
`data-currency`	budget	string	Display currency (USD, EUR, GBP, JPY, etc.).

Customization

Theming

Two attributes are enough to fully blend the widget with your site.

data-theme

Accepts "auto", "light", or "dark". Auto follows the visitor's OS preference and updates in real time.

data-color

Any hex color (#2563EB by default). Used for buttons, focus rings, links and CTAs.

Full white-label. Set data-branding="off" to remove the “Powered by Orizn” footer, and use data-radius / data-font for the visuals. The whole palette is exposed as CSS custom properties you can override from your own stylesheet: --orizn-accent, --orizn-bg, --orizn-fg, --orizn-fg2, --orizn-border, --orizn-input-bg, --orizn-card-bg, --orizn-shadow, --orizn-radius, --orizn-font.

#orizn-visa .orizn-w {
  --orizn-bg: #111;
  --orizn-accent: #10b981;
}

Languages are automatic. Each widget detects the visitor's browser language and switches between 16 locales out of the box (en, fr, es, de, it, pt, ja, ko, zh, ru, ar, hi, th, vi, tl, tr — Arabic renders RTL). Override with data-lang if you want to force one.

Monetize

Earn 50% on every guide sold

Add your data-affiliate code and every conversion is tracked back to you for 30 days. Payouts processed monthly via Stripe, no minimum.

Create your affiliate account

Troubleshooting

Common issues

If something looks off, walk through these four checks before reaching out.

Back to all widgets

Ready?

Create your widget account — Free

Track impressions, manage your affiliate, get your snippet from a clean dashboard.
No credit card.

Track impressions & clicks per widget
50/50 affiliate share on every guide sold
Unlimited requests with your API key

Create my widget — Free

Already have an account? Sign in