
Troubleshooting
Common JoomWeather symptoms, likely causes, and fixes.
| 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.