Troubleshooting
Table of contents
Error loading settings from the imported file
The following errors are a result of a JSON settings file failing verification. This could be due to many reasons, but the most common are explained below.
Invalid value of version: [number]
Reason: Your settings file is outdated.
Solution: Export a new settings file with the same settings.
There is a possibility that you can manually edit your JSON settings file to fix this error. If you’d like to take your chances, refer to the Import and Export page regarding this.
Invalid value of [key]: [value]
Reason: A subkey was found with an invalid or disallowed value.
Solution: Review the error to fix your settings file, or export a new settings file.
As seen in the example screenshot above, it mentions that the value of clockDisplay was invalid, as it doesn’t match any of the expected values. Change the value of the subkey in your JSON file to one of the allowed values.
Unexpected keys: [keyName]
Reason: Extraneous keys or garbage data was found in the JSON file.
Solution: Remove the extra keys from your JSON file, or export a new settings file.
Missing subkeys: [subkeys]
Reason: Critical subkeys were missing in the JSON file.
Solution: Ensure you are importing the correct JSON file. Export a new settings file if the current file is corrupted.
Invalid settings file toast
Reason: The file you uploaded couldn’t be decoded as valid JSON or didn’t have a .json file extension.
Solution: Check that the file you uploaded was a valid JSON file. Export a new settings file if the current file is corrupted.
Network problems
Online Web Clock is designed to work completely offline, however, it may display an error for certain actions which require an internet connection.
Iconify icons not loading
Iconify MDI icons are used in a few places on the website, such as the menu panel buttons and weather widget. If there is no internet connection and icons are not cached, as a fall-back, the menu and panel buttons use emoji or Unicode characters.
| Iconify icon | Fallback |
|---|---|
 |  |
The weather widget also uses Iconify icons, but there is no fallback as the weather widget is not displayed if there is no internet connection.
Weather widget
In order to enable the weather widget, you need an active internet connection. If the connection to the OpenWeatherMap API fails, the weather widget will not be enabled and an error will not be displayed. This behavior may be changed in the future.
Additionally, the widget will be hidden and disabled if connection is lost when it automatically refreshes.