This is the help page for editing the OpenStreetMap wiki. For support related to any other aspect of OpenStreetMap, please see the Main Help Page.
For frequently asked questions about the Wiki, see Wiki FAQ.
Getting started with wiki editing
We aim to build a user friendly wiki that helps OpenStreetMap contributors and users find the information they need quickly and easily. If you can help, please feel free to edit this wiki. Our general advise is to be bold - if a page can be improved, go forth and do it!
Jump straight in: Click 'Edit' at the top of any page, to edit the contents. You do need to create a wiki account before editing.
For introductory instructions on editing wiki pages, see Help:Wiki-Editing. This explains some of the wiki text syntax for achieving special effects in the text such as bold and italic text. You may also wish to visit Wikipedia's help. Wikipedia is the largest online Wiki, and has detailed articles covering almost every imaginable aspect of editing pages. It also has a group of volunteers who answer questions and provide help with editing. The OpenStreetMap Wiki shares the same platform as Wikipedia (namely Mediawiki), so much of what works there will work here too.
We cannot cover every topic about Mediawiki at https://wiki.openstreetmap.org/. Please refer to MediaWiki main help site.
- Main article: Wiki guidelines
Remember that anyone can edit anything on the OSM Wiki. This includes you. When adding to the wiki, you should seek to find the correct place within the current structure, to build upon the information we already have. This is better than creating a new page as your page where things are written your way. Also be prepared for others to edit the page after you.
The wiki currently needs some re-organisation, and this effort is being coordinated at WikiProject Cleanup. Large-scale re-arrangements or deletions may be necessary in order to achieve this. Feel free to get involved, but for any change which might be viewed as destructive, you should leave a trail of comments on the associated discussion pages, to explain what you are doing and why. For really big changes which might upset someone, it is best to hold a discussion about it first. Propose the change, discuss it, and reach agreement on the best organisation. Different people have different ideas for how to organise the wiki pages.
History and Discussion
All wiki pages have an associated history page where you can view previous versions of the page. You can also undo a recent edit if you are not happy with the result (although it is always worth previewing any changes before saving an edit). This can be accessed at the top right of each wiki page.
In addition to a history, all wiki pages also include a talk page. This is an ideal place to discuss potential changes to a page, particularly if they are large or could be deemed as controversial. This can be accessed by clicking "Discussion" at the top of each page.
Make a user page
You may want to start by editing your user page. If you wish to tell the OSM community where you are (for example, so neighboring OSM members can collaborate with you to map your locale), place some category links like the following at the bottom of your user page, as necessary to identify the area(s) you want to help map:
[[Category:Users in Country]]
[[Category:Users in State/Province]]
[[Category:Users in City]]
Country with the name of your country, etc. Then your username should appear under the Users by country category tree. If you happen to be the first user in a particular geographical region category (country, city, etc.), the category link at the bottom of your user page will appear in red until someone creates the category page. If you are new to Wiki editing, don't worry about this - someone else should eventually create it for you.
You may also create user subpages, to practice editing before you post something to the main Wiki. Wikipedia provides some help on this.
If you upload images of you or other specific for the user page, place it in Category:User images with code [[Category:User images]].
At your personal page, you can place ready stickers with various information using custom templates. Choose Userboxes by visiting the Category:Userbox.
- Main article: Wiki:Maps
This is the OpenStreetMap wiki - of course you can insert the OSM's map into any pages. If you want to use dynamic Slippy Map, see section Slippy Maps in Wiki:Maps.
Include images from Wikimedia Commons
Since April 2009 it is possible to include images from Wikimedia Commons on the OSM wiki.
Short HowTo: look at Wikimedia Commons for the desired picture and embed it here like this:
Options for resizing and placement are
[[Image:image.png|thumb/frame|left/right/center|size in px (e.g. 100px)|
alt=text describing picture (useful for people with screenreaders)|
description here is displayed below the image]]
200px|alt=photograph of Dunvegan Castle on the Isle of Skye in the mist|
Dunvegan castle on Isle of Skye]]
looks like this:
Dunvegan castle on Isle of Skye
For a more verbose HowTo see the Picture tutorial on Wikipedia.
Use only pictures from Wikipedia if the license is Public Domain or CC-BY or CC-BY-SA.
You are NOT allowed to use pictures with GNU-License like GFDL or GPL. In this case you can contact the author and ask if they want to make their picture available in CC-BY-SA for OSM.
You should probably not use any map image from Wikimedia, even where they are pronounced cc-by-sa on Wikipedia, because this community applies more strict criteria regarding derivative works.
See also Collaboration with Wikipedia.
How to purge cache
Include source code
Surround your code with
<syntaxhighlight lang="???">...</syntaxhighlight>, or
<source lang="???">...</source> (in use, but deprecated by MediaWiki and support may end once ),
where "???" is the programming language, one of (listed below in alphabetic order):
Initially this source code formatting and highlighting extension recognized the languages supported by the GeSHI highlighter; since June 2015 (and its integration in MediaWiki since version 1.26 or later, integrated on this wiki since end of May 2017), the extension uses the Pygments highlighter (bundled version 2.0.2) which is much better performing, and the list of supported languages was largely extended, with a few of them removed (old assembly languages rarely used) or supported under different names; this new list of languages also includes various predefined aliases. Additional aliases have also been added by the Mediawiki syntaxhighlight extension itself, for compatiblity with other MediaWiki extensions in order to help the transition from GeSHI to Pygments, including:
asp, bascomavr, basic4gl, cadlisp, cpp-qt, cpp-winapi, c_loadrunner, c_mac, c_winapi, dos, ecmascript, freebasic, gambas, gwbasic, html4strict, html5, j, java5, jquery, locobasic, mapbasic, modula3, netrexx, oberon2, ocaml-brief, oobas, oorexx, oracle11, oracle8, php-brief, plsql, povray, purebasic, pys60, rails, reg, rpmspec, rsplus, sdlbasic, standardml, thinbasic, tsql, upc, urbi, vb, visualfoxpro, visualprolog, xbasic, zxbasic.
Note: You also can (mis)use other language highlighting if your desired languages is not listed. E.g. for Overpass QL code, "cpp" (or just "c" as it avoids highlighting additional C++ keywords such as operator) is often used and looks fine. For Overpass XML code, the "xml" language is fine of course, and for MapCSS code you'll simply use "css".
For fragments of Mediawiki syntax (including invokation of templates and parser functions or in examples shown in template documentation pages), the "html5" language is frequently the best choice (but it won't highlight the wikikinks, template invokations, parser functions and magic keywords, highlighted as if they were part of standard HTML text elements). If the wiki code is a single template invokation (with only one parameter "| name = value" per source line), you may want to use the "ini" language.
For example the wiki syntax:
will render the embedded Perl source code as: