Skip to content

Troubleshooting

Common JoomWeather symptoms, likely causes, and fixes.

Updated 2 min read
Symptom Likely cause Fix
"Weather data unavailable" with no further detail Transient network failure reaching the provider Usually resolves itself; if persistent, confirm your server can make outbound HTTPS requests to api.open-meteo.com / api.openweathermap.org.
"The city … could not be found" The city name didn't match anything in the geocoder Try a more specific name, or add a country code (City, GB); as a fallback, switch Location mode to Coordinates and enter the latitude/longitude directly.
"An OpenWeatherMap API key is required" Provider is set to OpenWeatherMap but the key field is empty, invalid, or not yet active Double-check the key was copied in full with no leading/trailing spaces; note new keys can take a couple of hours to activate.
"The configured coordinates are invalid" Latitude outside −90…90 or longitude outside −180…180 Check the values — a common mistake is swapping latitude and longitude.
Module doesn't appear on the frontend at all Wrong position, unpublished, or not assigned to the current page Check Status = Published, confirm Position matches one your template actually renders, and check the Menu Assignment Tab.
Custom colours on the Colours tab don't seem to do anything Colour scheme is still set to a preset (or "Design default") The pickers only take effect when Colour scheme is set to Custom colours — they're intentionally hidden otherwise.
A gradient colour doesn't apply Only one or two of the three gradient stops were filled in All three (start / middle / end) must be set; a partial set is ignored and the layout's own gradient is used instead.
Icons look like plain grey clouds regardless of condition icon_style set to Mono solid, and the module is inheriting a grey text colour from the template Expected behaviour for Mono — it always uses one solid colour. Try Duotone or Full colour instead if you want condition-specific colours.
The module overlaps other content on a particular position Some templates render certain positions inside decorative/hero sections that assume very short content Try a different position, or check with your template's documentation for what that position is designed to hold.

If none of the above matches what you're seeing, check your site's PHP error log — the module never suppresses errors, so a fatal error there points directly at the cause.

Image

Everything you need to build on Joomla — one subscription away.

Resources