Location Messages
How to send a location message on the WhatsApp Cloud API using latitude, longitude, name, and address fields.
On this page
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#
| Field | Required | Description |
|---|---|---|
latitude | yes | Latitude as a string (decimal degrees) |
longitude | yes | Longitude as a string (decimal degrees) |
name | no | Location name shown above the pin |
address | no | Address 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#
Frequently asked#
How do I send a location pin on WhatsApp API?
Set type to "location" and provide latitude, longitude, and optionally name and
address in the location object. The recipient receives a tappable map pin.
How do I find the latitude and longitude for my store?
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.
Can I send a live location (updates in real time)?
No. The WhatsApp Cloud API only supports sending a fixed location pin, not a live/real-time location.
Gotchas & common mistakes#
Was this page helpful?
Still stuck? Open a support ticket and our team will help.