Weather conditions and icons

Understand weather condition codes, icons, and how to use them in your application.

The Current Weather Data API returns weather conditions as part of the weather array in the response.

Each entry includes:

• a numeric condition code (id)
• a short group label (main)
• a human-readable description (description)
• an icon code (icon)

Use the id field for application logic, and the description field for display.

Example response:

{
  "weather": [
    {
      "id": 500,
      "main": "Rain",
      "description": "light rain",
      "icon": "10n"
    }
  ]
}

The weather array may contain multiple entries, but most applications use the first item (weather[0]).

Weather icons

Weather icons provide a visual representation of the current conditions.

To display an icon, construct the URL using the icon value returned by the API:

https://openweathermap.org/img/wn/<ICON_CODE>@2x.png

Replace <ICON_CODE> with the appropriate icon code from the API response (for example, 10n for light rain). Icon codes ending in d are for daytime, and those ending in n are for nighttime.

The following sections include the icon list and commonly used weather condition codes.

Weather icon list

Day Icon	Night Icon	Description
01d	01n	Clear sky
02d	02n	Few clouds
03d	03n	Scattered clouds
04d	04n	Broken clouds
09d	09n	Shower rain
10d	10n	Rain
11d	11n	Thunderstorm
13d	13n	Snow
50d	50n	Mist

Weather condition codes

The Current Weather Data API uses numerical codes to represent different weather conditions. These codes are grouped by type of weather condition.

Use these codes to drive application logic (for example, grouping conditions or triggering UI changes).

Avoid relying on the description field for logic, as it is intended for display and may vary.

Group 2xx: Thunderstorm

This group represents various types of thunderstorms.

Code	Description	Icon
200	Thunderstorm with light rain	11d
201	Thunderstorm with rain	11d
202	Thunderstorm with heavy rain	11d
210	Light thunderstorm	11d
211	Thunderstorm	11d
212	Heavy thunderstorm	11d
221	Ragged thunderstorm	11d
230	Thunderstorm with light drizzle	11d
231	Thunderstorm with drizzle	11d
232	Thunderstorm with heavy drizzle	11d

Group 3xx: Drizzle

This group represents various types of drizzle as well as combinations with rain.

Code	Description	Icon
300	Light intensity drizzle	09d
301	Drizzle	09d
302	Heavy intensity drizzle	09d
310	Light intensity drizzle rain	09d
311	Drizzle rain	09d
312	Heavy intensity drizzle rain	09d
313	Shower rain and drizzle	09d
314	Heavy shower rain and drizzle	09d
321	Shower drizzle	09d

Group 7xx: Atmosphere

This group represents various types of atmospheric conditions.

Code	Description	Icon
701	Mist	50d
711	Smoke	50d
721	Haze	50d
731	Sand/dust whirls	50d
741	Fog	50d
751	Sand	50d
761	Dust	50d
762	Volcanic ash	50d
771	Squalls	50d
781	Tornado	50d

Group 800: Clear

This group represents clear sky conditions.

Code	Description	Icon
800	Clear sky	01d 01n

Group 80x: Clouds

This group represents cloud cover conditions.

Code	Description	Icon
801	Few clouds: 11-25%	02d 02n
802	Scattered clouds: 25-50%	03d 03n
803	Broken clouds: 51-84%	04d 04n
804	Overcast clouds: 85-100%	04d 04n