Key:contact:* - Other languages
 Prefix contact:*
|
 |
| Description |
|---|
The contact:* keys describe contact information.  
|
| Group: annotations |
| Used on these elements |
|
| See also |
| Status: in use |
| taginfo: contact:* |
This page describes a key prefix rather than a simple key.
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.
Some details below are incompatible with phone numbers outside of Germany or when written in languages other than German.
What is used here: phone and fax number format (
DIN 5008): +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialing>
| Key | Value | Element | Comment | Taginfo | Photo | |
|---|---|---|---|---|---|---|
Contact details | ||||||
| contact:phone | +44 11223 456-789 |    
|
Telephone number ( DIN 5008 format: +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialling>). See also the more popular phone=*.)
|
| ||
| contact:website | http://example.com |
|
Website-url (see also the more popular website=* and website:*=*) | 
| ||
| contact:email | mail@example.com |
|
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). |
| ||
| Key | Value | Element | Comment | Taginfo | Photo | |
Social media, messengers, web services | ||||||
| contact:facebook | full facebook URL or FacebookUserName |
|
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:instagram | full instagram URL or InstagramUserName |
|
Instagram account name (also used on Threads) or full Instagram URL |  
| ||
| contact:vk | VK.com |
|
VK link to social network service | 
| ||
| 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:mastodon | @username@server.example |
|
Mastodon social network handle or full URL | 
| ||
| contact:matrix | @username:server.example |
|
Matrix social network handle | 
| ||
| contact:mobilizon | @username@example.com or https://example.com |
|
Mobilizon social network handle or full URL | 
| ||
| contact:sip | sip@example.com |
|
SIP address | |||
| contact:diaspora | username@server.example |
|
Diaspora social network handle or full URL | 
| ||
| contact:gnusocial | username@server.example |
|
GNU Social social network handle or full URL | 
| ||
| contact:xiaohongshu | Xiaohongshu URL |
|
Xiaohongshu social network handle or full URL | 
| ||
| contact:user_defined | user defined |
|
All commonly used namespace keys according to Taginfo | |||
| Key | Value | Element | Comment | Taginfo | Photo | |
Mail address | ||||||
| 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) to receive mail instead of to their physical address. The value should contain the box number as well as a post office identifier, such as a post code. Note this may be different from addr:postcode=*. | 
| ||
This table is a wiki template with a default description in English. Editable here.
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 (2023-10-09) 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.
Organic Maps displays contact: addresses on POI's pop-ups when it exists.
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[1][2][3][4].
Popularity of phone=* and contact:phone=* indicating ongoing and uninterrupted preference of simple tagging scheme over contact: prefix, see also [5] which is most probably induced by editor presets.
There were also attempts to deprecate, mechanically retag or promote either version of many other contact tags[6]
