Your First OpenStreetMap Edit: Add a Verified Website with JOSM

A familiar neighborhood can look complete on a map while still missing useful details. A local shop may have a name and a location, yet no link to the place where visitors can check its menu, hours, or contact information. Adding one carefully verified website is a small edit, but it teaches the full OpenStreetMap workflow from downloading data to reviewing and publishing a change.

OpenStreetMap, often shortened to OSM, is a shared geographic database built by contributors. JOSM, the Java OpenStreetMap editor, is a desktop application that gives you a detailed view of that data. How do you make a first OpenStreetMap edit without redrawing a road? Add one trustworthy fact to a place you know.

The smallest useful edit

OpenStreetMap stores details as tags. A tag is a key and value pair attached to a map element, such as a shop, building, or bus stop. The website=* tag records the official web address associated with a place.

This makes a good first edit because the change is narrow and easy to inspect. You do not need to move geometry, create a new road, or understand every part of the map database. You select an existing place, verify one fact, add the tag, and upload a small changeset.

Prepare JOSM and your account

Create an OpenStreetMap account and confirm your email address. Then install the current tested build of JOSM rather than the nightly development build. The tested build is the calmer choice for a first session. If you use the cross-platform Java archive instead of an operating-system installer, JOSM requires a Java runtime version 11 or newer.

Open JOSM and spend a moment looking at the interface. The large center area is the map. Panels on the right show filters, tags, and other details. Nothing you do becomes public until you upload it, so the early part of the process is a safe workspace for learning.

1. Download a small, familiar area

Use File > Download data, or press Ctrl+Shift+↓ on Windows and Linux. Mac users can use the corresponding menu command or the Mac shortcut shown by JOSM.

Choose an area of interest no larger than a few city blocks. A place you have visited is ideal because you can recognize the businesses and understand the street layout. Draw a box around it and download the OpenStreetMap data.

Keeping the area small matters. Large downloads take longer, are harder to review, and increase the chance that you will touch objects unrelated to your goal. A focused edit also makes the eventual changeset easier for other contributors to understand.

2. Find places that need a website

JOSM includes a filter panel that can hide data which does not match a search rule. Open the panel, click +, and enter this query:

name=* ((amenity=* "addr:housenumber"=*) | shop=*) -website=* -"contact:website"=*

Here, amenity means a mapped facility such as a cafe, library, or clinic. The shop key identifies a retail business. The query looks for named places, then excludes anything that already has either a website tag or a contact:website tag.

Enable the filter so the matching places remain visible. The filter changes only what you see in JOSM; it does not edit or delete anything in OpenStreetMap. If the map becomes empty, your selected area may be too small, or the businesses may already have website information.

3. Add the Website Wizard plugin

A plugin is an extension that adds a feature to JOSM. Open Preferences with F12, choose the puzzle-piece Plugins panel, and click Download list. Find WebsiteWizard, select it, and click OK.

The plugin is listed in JOSM’s available plugin catalog and adds a globe icon to the editor. Select that icon to open the Website Wizard panel. Its purpose is not to decide which website is correct for you; it makes the search-and-save part of the task less repetitive.

4. Verify the official website

Enter the city or neighborhood in the Website Wizard’s search prefix field. Then select one of the visible shops or amenities and click Search. Your browser will open a search for the place name together with that location hint.

Search results need careful handling. Review sites, social media profiles, directories, and business aggregators are not the same as an official website. Look for evidence that the page belongs to the exact place on the map. The business name and street address should agree, especially when several locations share a brand name.

Franchises deserve extra attention. A company-wide website may be valid for the brand, but a location-specific page is more useful when one exists. If the only result is ambiguous, skip that place and choose another. A missing tag is better than a confident-looking link for the wrong business.

When you find the official site, copy its clean, permanent address into the Website URL field and click Save. Prefer the secure HTTPS version, remove tracking parameters, and avoid shortened links. A durable address is more useful than the long search or advertising link copied from a results page.

JOSM will mark the selected object as modified. Select it again and inspect the Tags/Memberships panel to confirm that website=* was added. If anything looks wrong, press Ctrl+Z or the Mac equivalent before uploading.

5. Review and upload a small changeset

A changeset is a grouped record of related edits. Open the upload dialog with Ctrl+Shift+↑, review the list of modified objects, and write a clear comment such as:

Add verified websites to shops and amenities in [neighborhood]

Describe the source honestly. Because this workflow uses official business websites, choose or enter a source that reflects that evidence. Do not select survey unless you actually gathered the information through an in-person survey or direct observation.

For authentication, JOSM supports OAuth 2.0, an authorization method that lets the OpenStreetMap website grant JOSM an access token without handing the editor your password for every request. In Preferences > OSM Server, choose the OAuth option and authorize JOSM in your browser. The first authorization may open a web page where you log in and approve the requested access.

Before uploading, pay attention to JOSM’s validation messages. A validator is a built-in checker that reports possible data problems. Some warnings may have existed before your edit, so do not change unrelated objects merely to make the list shorter. Review anything connected to the object you modified, fix problems caused by your own change, and upload when the result makes sense.

Your first edit is now part of the shared map

After a successful upload, the website tag becomes part of OpenStreetMap’s central database. Map images and other OpenStreetMap-powered services may update later, so the new link might not appear everywhere immediately.

The same workflow can support a careful second edit: add a phone number or opening hours only when the official source clearly provides them. Keep the area local, group related changes together, and stop whenever the evidence is uncertain.

A first OpenStreetMap edit does not need to be ambitious. Download a small area, verify one fact, inspect the tag, and publish a changeset that another mapper can understand. That habit—small scope, reliable sources, and a final review—is the foundation of good mapping.