Skip to main content Skip to complementary content
Qlik Resources
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal

Uploading and managing themes

Add custom themes, including colors and backgrounds based on your company standards, to style your applications. You can upload and manage themes in the Administration activity center.

What you can customize

With custom themes you can precisely style an application by:

  • Changing the colors.

  • Adding images and backgrounds.

  • Specifying the font sizes and font colors globally or at a granular level.

  • Defining color palettes.

  • Customizing margins, padding, and spacing.

For information about how to create your own themes for applications, see Qlik Developer: Custom themes. For information about styling applications, see Styling an application.

Required roles

To upload and manage themes, you must have one of the following roles:

  • Tenant administrator

  • Analytics administrator

  • Custom role with the Manage themes permission set to Allowed.

File requirements and limits

Follow these rules to ensure your theme uploads and works correctly.

Supported file formats

Themes only support the following file formats:

  • HTML files

  • CSS files

  • JSON files

  • Images (PNG, JPEG, GIF, and SVG)

  • QEXT metadata files

  • Font files

File naming rules

Each file in the theme must have a file name and a file extension. Files that do not comply are ignored. Examples of ignored files include .gitignore and README.

File size and count limits

Theme ZIP files have these limits:

  • Maximum ZIP file size: 30 MB

  • Maximum size for any single file in the ZIP: 30 MB

  • Maximum number of files in the ZIP: 500

  • Maximum total uncompressed size: 100 MB

External resources and CSP

If your themes include links to external resources, the resource origins must be allowlisted in the Content Security Policy (CSP). For more information, see Managing Content Security Policy (CSP).

Unsupported file formats

For security reasons, themes can't include files with disallowed MIME types. MIME types (Multipurpose Internet Mail Extensions) indicate a file's format. If your extension contains a disallowed MIME type (for example, an executable file or a ZIP file), the upload fails.

The following MIME types are not allowed:

  • 'application/octet-stream'
  • 'application/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'

Managing themes

Themes are managed on the Themes page in the Administration activity center.

Themes table information

  • Name: Metadata name in the QEXT file

  • QEXT version: Metadata version

  • QEXT filename: Unique identifier for the theme definition file

  • Status: Migration status (temporary)

About migration status

Qlik is improving how the platform handles themes. During this transition, existing themes are moved to a new service. The migration status column is temporary and appears only while this work is in progress.

As of 2025-11-17, any theme you upload or access uses the new service automatically. If your theme is in regular use, no action is required.

Most themes migrate automatically when they are used. Themes that you have not used recently may need to be queued manually to be included in a scheduled migration run. To protect customer-owned content, Qlik does not migrate themes unless they are accessed or you confirm the migration. If you want to keep an unused theme (status Not migrated) available, you can migrate it manually.

Migration status values:

  • Not migrated: The theme has not been migrated.

  • Queued for migration: The theme has been queued and will migrate during the next scheduled migration run.

  • Migration in progress: The theme is currently being migrated.

  • Migrated: The theme has been successfully migrated.

Migration also applies to extensions. For details, see Uploading and managing visualization extensions.

Adding themes

Do the following:

  1. In the Administration activity center, go to Themes.
  2. Click Add.

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

  4. Optionally, add tags.

  5. Click Publish.

Information noteYou cannot upload a theme with the same QEXT filename as an existing one.

Editing themes

Do the following:

  1. In the Administration activity center, go to Themes.

  2. On the theme you want to edit, click More and select Edit.

  3. Use the editing panel to replace the theme or update tags.

  4. Save your changes.

Downloading themes

Use this to back up a theme before editing it or to move it to another tenant.

Do the following:

  1. In the Administration activity center, go to Themes.

  2. On the theme you want to download, click More and select Download.

  3. Save the ZIP file.

Migrating themes

Use the following steps to migrate themes with Not migrated status.

Do the following:

  1. In the Administration activity center, go to Themes.

  2. On the theme you want to migrate, click More and select Migrate.

The status updates as the migration progresses: Queued for migration, Migration in progress, and finally Migrated.

Deleting themes

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

Do the following:

  1. In the Administration activity center, go to Themes.
  2. Select the themes you want to delete.
  3. Click Delete.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here