Skip to main content Skip to complementary content

Managing themes

Themes are managed in the Management Console, on the Themes page.

Themes overview

The following properties are present.

Properties for themes
Property Description

Name

This is the metadata name contained in the QEXT file, which is different from the QEXT filename.

Description

Short description of the theme.

Tags

Tags for filtering.

Author

Creator of the theme.

QEXT filename

Identifier that must be unique. Filename of the theme definition file. Different from the name of the theme.

QEXT version

Metadata version contained in the QEXT file.

Published

Date of publishing.
Updated Date of last update.

In the table, sort by using the arrows in the properties header. Filter by using the Tags drop-down menu, or by selecting the tags in the table.

Information noteThemes that contain links to external resources must have its origins allowlisted in the Content Security Policy.

Themes with external resources

Themes that contain links to external resources must have its origins allowlisted in the Content Security Policy.

See also: Managing Content Security Policy

Supported file formats and size

Themes only support HTML files, CSS, JSON, and images (PNG, JPEG, GIF, and SVG), along with QEXT metadata files and font files.

ZIP files containing themes have the following limits:

  • Maximum ZIP file size: 30 MB

  • Maximum file size of files in ZIP: 30 MB

  • Maximum number of files in ZIP: 500

  • Maximum uncompressed total file size of files in ZIP: 100 MB

Uploading of themes that contain files with the following disallowed MIME types will fail:

  • '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'
Information noteAll files in a theme must have a file name and a file extension. Files that are not complying to this will be ignored. Examples of ignored files: .gitignore and README.

Adding a new theme

Do the following:

  1. In the Management Console, go to the Themes section and Click Add in upper the right-hand corner.
  2. In the pop-up, click Browse to select a theme file, or drop a file in the designated area.

    Information noteYou cannot upload a theme with the same QEXT filename as an existing one.
  3. Optionally, add tags.

  4. Click Publish.

  5. If the theme you just uploaded contain external resources, you need to add the origins in the Content Security Policy to the allowlist. See Managing Content Security Policy.

Editing a theme

You can edit one theme at a time.

Do the following:

  1. In the Management Console, go to the Themes section and select the check box for the theme you want to edit.
  2. In the upper right-hand corner, click Edit.

    The editing panel is displayed with options for replacing the existing theme and adding or removing tags.

  3. Make your edits and save.

Deleting a theme

Do the following:

  1. In the Management Console, go to the Themes section and select the check boxes for the themes you want to delete.
  2. In the upper the right-hand corner, click Delete.
Information noteDeletion of themes can affect all resources. All users within a tenant are affected by a deletion.

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 – let us know how we can improve!