XUND
Guides

Script embed

Embed the app with a single script tag.

The quickest way to add the Symptom & Illness Check App to a page: place one <script> tag inside the element the app should fill.

Working examples

Runnable PHP, .NET, and Android projects that embed the app are in the frontend integration guide on GitHub.

<div id="xund-container" style="width: 100%; height: 100vh;">
  <script
    src="https://public.xund.solutions/embed.js"
    client-id="YOUR-CLIENT-ID"
    webapp-code="YOUR-WEBAPP-CODE"
    auth-code="AUTH-CODE-FROM-YOUR-SERVER"
    app-language="en"
  ></script>
</div>

How it works

The script creates an iframe inside the tag's parent element and loads the app into it, so give that element a width and a height. Attribute names are kebab-case (app-language, not appLanguage).

Attributes

AttributeRequiredDescription
client-idyesYour Client Id.
webapp-codeyesYour Web App Code.
auth-codeyesA fresh auth code from your server for each page load — see Authentication.
app-languagenoThe app's language, for example en or de.

All attributes are listed in the parameter reference.

When to use the JS API instead

The script embed covers the check itself. To read the report in your page, react when it is shown, change the report's action button, or set your own colours, use the JS API.

Last updated on

On this page