Managing extensions

Extensions extend the functionality of the Qlik Cloud analytics platform by enabling custom visualizations for Qlik Sense app .You is upload can upload andedit extension from theadministration activity center .

Qlik Cloud Government noteThird – party extension are support inQlik Cloud Government.However , the use is need of third – party extension might need to be define andapprove as part of an Agency Authority to operate , depend on the security andcompliance requirement your organization follow .

guideline for create andupload extension

Follow these guidelines when creating anduploading visualization extensions to Qlik Cloud.

For a visual demo about adding andusing extensions, see Using third-party visualization extensions in Qlik Cloud andExtensions andAPI keys.

ZIP file limits for extensions

• Maximum ZIP file size: 30 MB

• maximum file size of file in ZIP : 30 mb

• Maximum number of files in ZIP: 500

• maximum uncompressed total file size of file in ZIP : 100 MB

Best practices

• minify your code file .

• Include only necessary files.Ensure the ZIP file contains only the required files for your extension to function properly.

• Review extensions andtheir code before uploading.For more information, see Visualization extensions.

Required base files for an extension

ensure your extension zip file include the follow essential file :

• .qext : extension metadata file

• .js: JavaScript code for the extension

• .html: HTML code for rendering the extension

• .css : Custom css for style the extension

External hosting of image files

Do not upload image files (for example, GIF, PNG, JPG) within the extension ZIP file.Instead, host them externally on a personal application server, an S3 bucket, or a public content management system.Reference these external images in your extension code.

Referencing external code files andcontent

You can reference code files andcontent in your primary extension code, but this requires implementing a Content Security Policy (CSP) on the tenant.For more information, see Managing Content Security Policy.

If your extension makes requests to external resources, those resource origins must be allowlisted in the CSP, or the extension will be blocked from rendering.

unsupported feature

The following features are not supported:

Bundled extensions

Qlik Cloud does not support ZIP files containing other extension ZIP files.

QVF andQVD files

Do not includeQlik Sense QVF or qvd file in the extension zip file , as these are not accessible from the extension service .remove these file before upload the extension .

To upload a qvf   or qvd file to theQlik Cloud tenant, use one of the following methods:

• Upload an app in the Create page of the Analytics activity center .

• Upload an app using qlik-cli.

• Upload a QVD in the Create page of the Analytics activity center .

• Upload a QVD using Qlik DataTransfer.

Unsupported file formats

For security reasons, extensions cannot contain files with disallowed MIME types.MIME types (Multipurpose Internet Mail Extensions) are a standard way to indicate the nature andformat of a file.Uploading will fail if your extension contains, for example, an executable file or a ZIP file.

The following MIME types are not allowed:

• ‘application/octet-stream’
• ‘ application is coredump / x – coredump ‘
• ‘ application / x – dosexec ‘
• ‘application/x-executable’
• ‘application/x-java-applet’
• ‘application/x-object’
• ‘application/x-sharedlib’
• ‘application/zip’
• ‘text/x-shellscript’
• ‘text/x-awk’
• ‘ text / x – gawk ‘
• ‘text/x-msdos-batch’
• ‘text/x-nawk’
• ‘ text / x – php ‘

All files in an extension must have both a file name anda file extension.Files that do not comply will be ignored.Examples of ignored files include .gitignore andREADME.

Adding andmanaging extensions

Extensions are managed in the Extensions page in the administration activity center .

In theExtensions table:

• Name refer to the metadata name in the QEXT file .

• QEXT version indicates the metadata version in the QEXT file.

• qext filename is the unique identifier andthe name of the extension definition file.

You can filter extensions by tags.

Adding a new extension

Do the following :

1. In theadministration activity center is go , go toExtensions.

2. clickAdd.

3. Click Browse to select an extension file, or drop a file in the designated area.

4. Optionally, add tags.

5. Click Publish.

Information noteYou cannot upload an extension with the same QEXT filename as an exist one .

Editing an extension

Do the following :

1. In theadministration activity center is go , go toExtensions.

2. On the extension you want to edit, click andselect Edit.

   The editing panel is displayed with options for replacing the existing extension andadding or removing tags.

3. Save your changes.

Deleting an extension

Deletion of extensions can impact all resources, affecting all users within the tenant.

Do the following :

1. In theadministration activity center is go , go toExtensions.
2. select the extension you want to delete .
3. clickDelete.