Skip to content
Developer docs: all pages

Embeds

Put a Voydar vessel card, port board or mini map on any web page with an iframe. No key, no account, no cookies. Widgets are cached snapshots (vessel card 15 minutes, port board 30, map 5) and show only facts the public page shows. Add ?theme=light or ?theme=dark to force a theme; without it the widget follows the reader's system. The optional embed.js script sizes the iframe to its content. The "Share / Embed" button beside the title of every vessel and port page builds the snippet for you.

Every widget ends with a credit line: the Voydar logo and a link to the ship or port page, named for what it shows ("EVER GIVEN position on Voydar"). The copied code also puts the same link on a plain line under the iframe, so the credit stays where a site strips iframes (AMP pages, feed readers, some forums). Both are normal links that open in a new tab; keep them as they are.

Live example (the vessel card for EVER GIVEN, with the code that produced it):

Ever Given position on Voydar

<iframe src="https://www.voydar.com/embed/vessel/9811000" title="Ever Given · Voydar" width="100%" height="300" style="border:0;max-width:560px" loading="lazy" data-voydar-embed></iframe>
<p style="margin:4px 0 0;font-size:12px"><a href="https://www.voydar.com/vessel/9811000-ever-given" target="_blank" rel="noopener">Ever Given position on Voydar</a></p>
<script async src="https://www.voydar.com/embed.js"></script>

Widget URLs: a vessel by IMO (or mmsi-123456789), a port by UN/LOCODE, and a map by bbox=west,south,east,north (snapped to a 0.25° grid, at most 30° across), vessel=IMO or port=LOCODE.

https://www.voydar.com/embed/vessel/9811000?theme=dark
https://www.voydar.com/embed/port/NLRTM
https://www.voydar.com/embed/map?bbox=3.5%2C51.75%2C4.5%2C52.25
https://www.voydar.com/embed/map?port=NLRTM

Embedding is free with attribution: keep the "Data: Voydar" credit and the link back. See the embed terms.