Qlik-embed: some visualizations require utf-8 encoding when using "analytics/chart" or "analytics/sheet" UIs

Caterina_Fruci — Wed, 05 Feb 2025 08:11:36 GMT

Some charts may fail to load when using qlik-embed and the analytics/chart or analytics/sheet UIs due to incompatible charsets in the host page.

When using the following example code in the body of the HTML file to embed a Qlik Sense visualization object, with the ui attribute to analytics/chart, which indicates to qlik-embed that you wish to embed a specific visualization from a Qlik Sense application using the lightweight nebula object.

[ Fig.1 ]

<qlik-embed ui="analytics/chart" app-id="<APP_ID>" object-id="<CHART_ID>" ></qlik-embed>

The following error may occur when trying to render the KPI in your web application:

Failed to load visualization: 'kpi'

This is because the host page character set is not supported by the visualization object. Refer to the embedded visualization documentation for specific compatibility requirements: Qlik-embed charset compatibility

Resolution

Apply the following instructions in your HTML file element which enforces utf-8 encoding and solves the issue:

<meta charset="utf-8">

For usage where the encoding cannot be controlled by the user (such as embedding in a tool, e.g. Microsoft Excel ) and this error arises, the customer will have to embed with the "classic/chart" type and the option "iframe=true".

Environment

Qlik Cloud

article Qlik-embed: some visualizations require utf-8 encoding when using "analytics/chart" or "analytics/sheet" UIs in Official Support Articles

Qlik-embed: some visualizations require utf-8 encoding when using "analytics/chart" or "analytics/sheet" UIs

Resolution

Environment

Related Content