|The contact:* keys describe contact information.|
|Used on these elements|
|Status: in use|
The prefix for several contact:*=* keys to describe contact information.
You should only add contact information to POIs and not to any private address!
Email-addresses which are only available on a website after solving a captcha, or which are in other ways obfuscated to protect against SPAM-bots should not be tagged in OSM. The same applies to fax and phone numbers.
What is used here: phone and fax number format (): +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialing>
|contact:phone||+44 11223 456-789||Telephone number (phone=*.)format: +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialling>). See also the more popular|
|contact:website||http://example.com||Website-url (see also the more popular website=* and website:*=*)|
|contact:firstname.lastname@example.org||E-mail address (see also the more popular email=*)|
|contact:fax||+44 11223 456-789||A dedicated telephone number connecting to a telefacsimile (fax) machine. See also the more popular fax=*).|
|contact:mobile||+44 11223 456-789||A telephone number connecting to a mobile phone. The more general tag contact:phone=* should be preferred.|
|contact:tty||+44 11223 456-789||A dedicated telephone number connecting to a teletypewriter (tty).|
Social media, messengers, web services
|contact:facebook||full facebook URL||Facebook profile - preferably the full URL (because there are many different kinds of pages in facebook), though simply the public username is also used. (see also facebook=*)|
|contact:vk||VK.com||VK link to social network service|
|contact:instagram||Username||Instagram account name or full URL|
|contact:twitter||OpenStreetMap||Twitter account name or full URL (see also twitter=*)|
|contact:youtube||Youtube account/channel URL||YouTube URL of account or channel officially used by the POI. Sometimes only the YouTube username is indicated.|
|contact:ok||ok URL||ok link to social network service.|
|contact:webcam||webcam URL||For denoting a webcam's location, use a node with the tag surveillance:type=camera. See also Webcams for more information|
|contact:telegram||https://t.me/Example or Telegram number||Telegram account name or full URL or Telegram number officially used by the POI.|
|contact:whatsapp||WhatsApp number||WhatsApp number officially used by the POI.|
|contact:linkedin||Username||LinkedIn account name or full URL|
|contact:pinterest||Pinterest URL||Pinterest URL officially used by the POI.|
|contact:viber||+44 11223 456-789||Viber account name (phone number) or full URL|
|contact:foursquare||https://foursquare.com/v/Example||Foursquare account name (hash) or full URL|
|contact:skype||SkypeName||Skype login name|
|contact:xing||Username||XING account name or full URL|
|contact:tiktok||Username||TikTok account name or full URL|
|contact:vhf||VHF Channel or Frequency||Of interest for maritime and airport services|
|contact:flickr||Flickr URL||Flickr URL. Similar to all others, this is where the POI can be officially contacted, or where they broadcast information. This should not point to a self-taken photo depicting the POI.|
|contact:email@example.com||Mastodon social network handle or full URL|
|contact:firstname.lastname@example.org||Diaspora social network handle or full URL|
|contact:email@example.com||GNU Social social network handle or full URL|
|contact:user_defined||user defined||All commonly used namespace keys according to Taginfo|
|contact:street||street name||For use when the contact address is not the same as the address of the physical location.
For denoting the street name where a POI is located, see also addr:street=*
|contact:housenumber||housenumber||For use when the contact address is not the same as the address of the physical location. (Status: "draft" )
For denoting the housenumber where a POI is located, see also addr:housenumber=*
|contact:postcode||postcode||For use when the contact address is not the same as the address of the physical location.
For denoting the postcode number where a POI is located, see also addr:postcode=*
|contact:city||city name||For use when the contact address is not the same as the address of the physical location.
For denoting the city name where a POI is located, see also addr:city=*
|contact:country||country||For use when the contact address is not the same as the address of the physical location.
For denoting the country where a POI is located, see also addr:country=*
|contact:pobox||Post Box Number||Companies and organizations sometimes have a Post Office Box (P.O. Box/ PO Box) to send mail to instead of to their physical address. See also addr:postbox=*|
This table is a wiki template with a default description in English. Editable here.
Addressing scheme in France
Note that in France (especially),
contact:housenumber keys are mostly used on POIs to add their addresses without consideration of whether the physical address is different from the postal address but instead of
addr: keys reserved for mapping addresses as unique features.
This usage is relatively widespread, see TagInfo
contact:housenumber page, it has not yet (2022-08-30) been approved by the community.
A draft about this usage called "Schéma de Charlieu" can be found on the OSM wiki.
Qwant Maps promotes the display of the values of these POIs labels when they exist.
Existing tagging schemes
For the most common keys, the shorter version outside the 'contact' scheme is used more frequently: phone=*, fax=*, email=* and website=*, with other contact tags used rarely outside the namespace scheme. Both schemes have been in use for a long time and still exist in parallel. Many applications are able to use both of them.
At the same time a proposal to deprecate contact:phone=* was not successful - Discussions/tagging/contact:phone or phone. Idea of deprecating either tags without contact: prefix or ones with contact prefix is repeatedly suggested, often triggering huge discussion and ending with conclusion that there is no consensus. Please, read past discussion before starting a new one.
There were also attempts to deprecate, mechanically retag or promote either version of many other contact tags
- phone=* - A telephone number associated with the object
- website=* - Specifying the link to the official website for a feature
- email=* - An email address associated with the object
- url=* - Specifying an url related to a feature
- fax=* - A fax number associated with the object
- Bremen Schema - A schema that proposes to add contact information about a POI to the node via using contact:* instead of adding addr:*
- Key:operator#Further details - subkeys used to add further detail about the operator
- emergency:phone=* - A phone number for emergencies associated with the object
- addr:*=* - addr is the prefix for several addr:* keys to describe addresses
- OpenLinkMap - A slippy map, making this tag's data available as clickable POIs
- JOSM preset
- wikipedia:Telephone numbering plan
- wikipedia:List of country calling codes
- wikipedia:E.164 (ITU-T recommendation on how to save phone numbers)
- OmniROM devs will use OSM phone numbers
- https://lists.openstreetmap.org/pipermail/tagging/2019-December/thread.html#49474 - December 2019 thread
- https://lists.openstreetmap.org/pipermail/tagging/2019-August/thread.html#47668 August 2019 Thread
- https://lists.openstreetmap.org/pipermail/tagging/2020-May/thread.html#52379 - May 2020 thread, over 50 messages
- https://lists.openstreetmap.org/pipermail/tagging/2022-January/thread.html#63734 January 2022 thread
- Contact:website / website / url
- Proposed features/Social media contact prefix