Skip to content

Travel advisories installation

Like the visa widget, the advisories board is a hosted drop-in: add a container, load one script. It works on any site, any CMS or none, with no build step and no API key.

Place an element with the data-visamundi-advisories attribute where the board should appear:

<div data-visamundi-advisories></div>

Add the script anywhere on the page. It auto-mounts every data-visamundi-advisories container it finds, fetching the aggregated advisories of the 5 ministries and rendering one card per destination:

<script src="https://advisories.visamundi.app/advisories.js" defer></script>

That’s it. The board renders inside a Shadow DOM, so its styles never clash with your site’s CSS (and vice versa).

Configure each board through data-* attributes on the container:

AttributeValuesDefaultDescription
data-langen · frenUI language and language of the advisory texts.
data-themelight · darklightVisual theme.
data-limitnumber24Max number of destinations shown (most recent first).
data-min-level14allPreselects the ”≥ N” level filter chip.
data-sourceUS · CA · DE · GB · FRallShow a single ministry’s advisories only.
data-consensuspresent or "true"offOnly destinations where every covering ministry (min. 4 of them) rates at least the active level (never below 2). Adds a “Consensus” badge to each card.
data-endpointURLhttps://advisories.visamundi.app/api/advisoriesOverride the data endpoint (self-hosting / a deploy preview).
<!-- French, dark, destinations rated ≥ 3 with all ministries agreeing -->
<div data-visamundi-advisories data-lang="fr" data-theme="dark"
data-min-level="3" data-consensus data-limit="12"></div>
<!-- The French ministry's view only -->
<div data-visamundi-advisories data-lang="fr" data-source="FR"></div>

The level chips in the board filter with a “at least this level” semantic (≥ 14); visitors can change the filter at any time, data-min-level only sets the starting point.

The data is a public, CORS-enabled JSON endpoint, so you can skip the script and render it yourself:

GET https://advisories.visamundi.app/api/advisories

See Data & source for the response shape and how the referential is built.

Request API access

Tell us a little about your integration and we'll get back to you within one business day with a partner token.