Managing themes
Themes are managed in the Management Console, on the Themes page.
Themes overview
The following properties are present.
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.
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'
Adding a new theme
Do the following:
- In the Management Console, go to the Themes section and Click Add in upper the right-hand corner.
-
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. -
Optionally, add tags.
-
Click Publish.
-
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:
- In the Management Console, go to the Themes section and select the check box for the theme you want to edit.
-
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.
-
Make your edits and save.
Deleting a theme
Do the following:
- In the Management Console, go to the Themes section and select the check boxes for the themes you want to delete.
- In the upper the right-hand corner, click Delete.