Skip to main 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 or extension.

Short description of the theme.

Tags

Tags for filtering.

Author

Creator of the theme or extension.

Creator of the theme.

QEXT filename

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

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.

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.

Maximum size of a file within a theme folder is 250 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'
Note: All 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.

    Note: You 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 allow list the origins in the Content Security Policy. 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 the 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.
Note: Deletion of themes can affect all resources. All users within a tenant are affected by a deletion.