Skip to main content
A location message sends a map pin to the recipient showing a specific geographic location with a name and address. The recipient can tap it to open the location in their maps app.

​
Sending a location

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919959623255",
  "type": "location",
  "location": {
    "latitude": "13.167466",
    "longitude": "78.388695",
    "name": "Mulbhagal",
    "address": "Mulbhagal, Karnataka, India"
  }
}

​
Fields

FieldRequiredDescription
latitudeyesLatitude as a string (decimal degrees)
longitudeyesLongitude as a string (decimal degrees)
namenoLocation name shown above the pin
addressnoAddress text shown below the name
The name and address fields are optional but always include them — without them the recipient only sees a pin with no context.

​
How to get latitude and longitude

Open Google Maps, right-click any location, and copy the coordinates shown at the top of the context menu. Example: 13.167466, 78.388695.

​
Reference image

Location received

​
Frequently asked

Set type to "location" and provide latitude, longitude, and optionally name and address in the location object. The recipient receives a tappable map pin.
Open Google Maps, right-click your store location, and copy the coordinates at the top of the menu. Use those values as strings in the latitude and longitude fields.
No. The WhatsApp Cloud API only supports sending a fixed location pin, not a live/real-time location.

​
Gotchas & common mistakes

  • Skipping name and address — the recipient only sees a blank pin. Always add a meaningful name and address so they know what the pin represents.
  • Coordinates as numbers vs strings — pass latitude and longitude as strings ("13.167466") not numbers. Some clients reject numeric values.
  • Wrong coordinate order — latitude comes first, longitude second. Swapping them pins the location in the wrong place.