Medium integration

Embed Orizn widgets in Medium

Step-by-step guide to add visa, budget, and travel widgets to your Medium site in under 2 minutes.

Medium does not allow custom JavaScript or arbitrary iframes inside articles. There is no HTML block and no plug-in surface. The only path is to use Medium's auto-embed (Embedly) on a hosted Orizn URL, or screenshot the widget and link it to your affiliate page.

Tested with Medium 2026 (current editor)Free forever

What you'll get

Three quick wins

📰

Embedly auto-preview

Drop an embed.orizn.app URL on a blank line — Medium calls Embedly and renders a rich card.

🖼️

Linked screenshot fallback

Paste a widget screenshot, then hyperlink it to your affiliate page. Works everywhere.

🔗

Affiliate query string persists

Medium does not strip URL parameters, so ?affiliate=ORIZN-XXXXX survives.

Setup

Step-by-step in Medium

Five concrete steps from opening the editor to hitting publish.

1

Understand the limitation

Medium does NOT allow JavaScript embeds. There is no HTML block, no Custom Code element, no plugin. Anything beyond text, image, code-snippet block, and a small whitelist of Embedly-supported services (YouTube, Twitter, GitHub Gist, Figma) will not render.

2

Capture a widget screenshot

Open https://embed.orizn.app/widgets/visa?destination=THA in a browser. Take a high-res screenshot (at least 1600px wide on a Retina display). This is your visual fallback — readers see exactly what the live widget shows.

3

Insert the screenshot into the post

In the Medium editor, click the + (plus) button → Image → upload your screenshot. Add a caption like 'Tap to check Thailand visa requirements'. The image becomes the visual hook.

4

Hyperlink the screenshot to your widget URL

Click the image to select it, then press Cmd/Ctrl+K. Paste the URL https://embed.orizn.app/widgets/visa?destination=THA&affiliate=ORIZN-XXXXX. Hit Enter. The image is now a clickable affiliate link.

5

Publish

Hit Publish (top right) → Publish now. Clicks on the screenshot land on the live widget page on embed.orizn.app, your affiliate code attached. Bonus: try pasting the URL on its own line too — Medium might auto-generate an Embedly preview card.

Code

The snippet for Medium

Copy the variant that matches your setup. Switch tabs to see the affiliate or iframe versions.

url
https://embed.orizn.app/widgets/visa?destination=THA

Watch out

Common Medium pitfalls

The things that catch first-timers — fix in advance.

No HTML or script ever

Medium has no plans to support custom JS. Even on Medium Partner Program paid accounts, the editor is identical.

Embedly cards may not render

Medium calls Embedly which fetches OG metadata. We provide OG tags, but Medium's whitelist sometimes refuses non-major-domain previews.

Image compression

Medium re-encodes uploaded images aggressively. Upload at 2x resolution so the screenshot still looks crisp.

Custom domains via Medium do the same

Brand subdomains served by Medium have identical restrictions. Migrating to Ghost or self-hosted is the path if you need real widgets.

FAQ

Questions about Medium

Is there any way to make the widget interactive on Medium?

No. Medium does not allow JavaScript in posts. The screenshot-as-affiliate-link pattern is the canonical workaround.

Will my affiliate tracking still work?

Yes. The URL query parameter ?affiliate=ORIZN-XXXXX is preserved when readers click through, and the orizn_passport cookie tracks conversions for 30 days.

Can I use Medium's code-block for the snippet?

Only for demonstrating the HTML to readers (tutorial-style). The code block renders as static text — it never executes.

Should I switch off Medium to do this properly?

If embedded widgets matter for your monetization, Ghost, WordPress, or Webflow are all stronger fits. See those guides linked below.

Other platforms

Embed Orizn elsewhere

Ready?

Ready to embed in Medium?

Grab the snippet, paste it where the steps above describe, and ship in two minutes.