Entry formalities script configuration
Options are data-* attributes on the <script> tag (or the options object
passed to VisamundiInfo.init()).
Options
Section titled “Options”| Attribute | Default | Description |
|---|---|---|
data-country | auto-detect | Destination, ISO alpha-2 or alpha-3. Comma list for several: TH,VN. |
data-nationality | FRA | Traveller nationality, ISO alpha-2 or alpha-3. |
data-lang | <html lang>, else fr | fr or en. Set it explicitly. |
data-sections | visa,visas,vaccines,customs | Sections to show: visa (verdict sentence), visas (visas and authorisations), vaccines, customs. |
data-reason | tourism | Travel reason(s) used to filter the visas shown. See below. |
data-target | before the script | CSS selector of the container(s). All matching elements are filled. |
data-iso-pattern | — | Regex whose group 1 is an ISO code, run on the URL then on page links. |
data-detect-jsonld | off | Also read schema.org addressCountry from JSON-LD. |
data-key | — | Partner key, sent as X-Embed-Key (reserved). |
data-style | — | none disables the default CSS. |
data-manual | — | Do not auto-run; call VisamundiInfo.init({...}). |
data-api-base | https://embed.visamundi.app/api/info | Override the data endpoint. |
Country detection
Section titled “Country detection”When data-country is absent, the first source that gives a country wins:
data-countryparameter.<meta name="visamundi:country" content="EG">in the page.- JSON-LD
addressCountry, only withdata-detect-jsonld(off by default: on many travel sites it is the seller’s address, not the destination). data-iso-pattern: your regex, applied to the page URL, then to thehrefof every link on the page.- A country slug in the URL path (
/voyages-inde/…,/sejour-egypte/), matched against the Visamundi country list. Prefixes such asvoyage(s)-,sejour(s)-,circuit(s)-are ignored.
If nothing is found, nothing is displayed.
Using data-iso-pattern
Section titled “Using data-iso-pattern”Useful when your URLs carry a code rather than a name. Example for a site whose
breadcrumb links contain destination=LCAI.JP.OSA:
<script async src="https://embed.visamundi.app/infos.js" data-iso-pattern="destination=[A-Z0-9]+\.([A-Z]{2})(?:\.|&|$)"></script>Group 1 must capture the ISO code (JP).
Travel reason
Section titled “Travel reason”data-reason filters the visas and authorisations section. Default:
tourism.
| Value | Value | ||
|---|---|---|---|
tourism | Tourism | student | Study |
business | Business | transit | Transit |
medical | Medical | ngo | NGO |
traditional-medecine | Traditional medicine | relative | Family visit |
conference | Conference | religious | Religious |
event | Event | all | No filter |
Pass several values separated by commas: data-reason="medical,tourism".
What is displayed
Section titled “What is displayed”Verdict sentence, for example: For a traveller holding a French passport going to Japan: no visa is required for a stay of up to 90 days. Possible outcomes: visa-free (with the allowed stay), visa required, visa on arrival, e-visa / eTA, special permit, entry not permitted, no information.
Visas and authorisations: one accordion per document (type, stay, validity, entries, fee, online or on arrival, documents to provide). When several visas of the same type apply, they are grouped in one accordion that gives the number of visas, the starting fee, the maximum stay, and the documents of the cheapest one.
Vaccines: mandatory vaccines listed with their comment; recommended vaccines in a closed accordion.
Customs: alcohol, tobacco, currency, medicines, when available.
The block ends with the Source: Visamundi mention and logo.
Full example
Section titled “Full example”<div id="formalities"></div><script async src="https://embed.visamundi.app/infos.js" data-target="#formalities" data-nationality="FRA" data-lang="en" data-sections="visa,visas,vaccines,customs" data-reason="tourism,business"></script>