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.
1. Add a container
Section titled “1. Add a container”Place an element with the data-visamundi-advisories attribute where the board
should appear:
<div data-visamundi-advisories></div>2. Load the script
Section titled “2. Load the script”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).
Options
Section titled “Options”Configure each board through data-* attributes on the container:
| Attribute | Values | Default | Description |
|---|---|---|---|
data-lang | en · fr | en | UI language and language of the advisory texts. |
data-theme | light · dark | light | Visual theme. |
data-limit | number | 24 | Max number of destinations shown (most recent first). |
data-min-level | 1–4 | all | Preselects the ”≥ N” level filter chip. |
data-source | US · CA · DE · GB · FR | all | Show a single ministry’s advisories only. |
data-consensus | present or "true" | off | Only 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-endpoint | URL | https://advisories.visamundi.app/api/advisories | Override 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
(≥ 1 … 4); visitors can change the filter at any time, data-min-level
only sets the starting point.
Prefer to build your own?
Section titled “Prefer to build your own?”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/advisoriesSee Data & source for the response shape and how the referential is built.
- Live demo — the board on real data.
- Data & source — the 5 feeds, the referential, and the endpoint.