This page is incomplete. Lot's of tests not described.

Preferences > Data Validator

An OSM data validator that checks for common errors made by users and editor programs.

Tests

Following four general settings are available:

Use ignore list

enable/disable the use of the ignore list (default: enabled)
Advance preference: validator.ignore

Use error layer

enable/disable the creation of a validator layer highlighting the problematic objects (default: enabled)
Advance preference: validator.layer

Show informational level

enable/disable tests on informational level know as "Other" (default: disabled)
Advance preference: validator.other

Show informational level on upload

enable/disable tests on informational level on upload (default: disabled)
Advance preference: validator.otherUpload

All check boxes below are settings which test should be run on which action with a check box on the left for manual runs, On demand, and On upload on the right side.

By default, all error and warning tests are active.

1. If you are a OSM newbie and encountered validation error about objects you haven't touched, please ignore these messages for now.
2. Validator can be wrong or incomplete about all tagging practices. Don't fix errors when you aren't sure something is really wrong.
3. First, refer to Validator panel - how to use validator

The fourth column contains also (video) explanations. The table is incomplete.

Type	Message	What is checked	Additional help	Autofix
Addresses		errors in ​Addresses and ​Relation:associatedStreet. Advanced preferences: validator.addresses.max_duplicate_distance (default: 200.0) validator.addresses.max_street_distance (default: 200.0)
	House number without street	objects that have an addr:housenumber tag, but neither addr:street nor addr:place. The street name can also be provided using an associatedStreet relation or on interpolation way.	Add the missing street name information.	no
	Duplicate house numbers	two members of an associatedStreet relation have the identical house number.	It is possible with a low chance.	no
	Multiple street names in relation	name tag of an associatedStreet relation matches the name tags of the members with role street and the addr:street tag of the members with role house.		no
	House number too far from street	the houses of an associatedStreet are far away from the corresponding street.	Verify that the house really belongs the the street that is given by the relation.	no
	Multiple associatedStreet relations	an object is in more than one associatedStreet relation.		no
Barriers and entrances		errors in ​Barriers and ​Key:entrance.
Coastlines		​Coastline are correct.
	Reversed coastline: land not on left side	coastlines that are not counter-clockwise or that are otherwise misplaced (coastline misused as inland lake)	Reverse coastline
	Unconnected coastline: coastline ways do not form closed loops	coastlines ways that are not connected to the end of other coastline ways
	Unordered coastline: coastline ways are not connected start-to-end	coastline ways of which either the start is not connected to the end of another coastline or the end is not connected to the start of another coastline	Reverse coastline
Conditional Keys		usage of *:conditional tags.	Imprecise rules covered at ​osm wiki page "Conditional restrictions"
Crossing barriers / boundaries / ways
	Crossing ways	ways (with highway/railway/waterway tags) that cross in same layer with no crossing node	1. ​(video) usually you need to add a common node or 2. add appropriate ​Key:layer (and possibly ​Key:bridge or ​Key:tunnel)	no
	Crossing barrier/building	barrier crossing a building in same layer with no crossing node		no
Duplicated nodes		Advanced preference: validator.duplicatenodes.precision: rounding precision in degree (default: '0.0' or '1e7')
	Duplicated nodes	no nodes in the very same location	Merge the nodes into only one, adding the properties from all nodes to the merged one
Duplicated relations		no relations with same tags and same members with same roles.
Duplicated ways		no ways with same node coordinates and optionally also same tags.
Duplicated way nodes		ways with identical consecutive nodes.
	Duplicated way nodes	ways contain no loop edges (i.e., a single step from a node to itself)	Split the way, and delete the way consisting of the loop edge.
Highways		semantic checks on highways.
Lane tags		lanes:* tags, see ​Lanes
Tag checker (MapCSS based)		different kind of checks based on MapCSS, including external rules. See Tag checker rules tab and detailed description below.
Multipolygon		multipolygons are valid.
	Style for outer way mismatches	Within a multipolygon relation, one of the tags of the relation and the outer ways is shared but with different values	Copy relation related tags to the relation itself	no
	Style for inner way equals multipolygon	Within a multipolygon relation, one of the tags of the relation and the inner ways is shared and has the same value	Remove tag from inner way	no
	No style in multipolygon relation	The multipolygon relation is missing a tag describing what it represents	For a building, add building=yes to the relation etc.	no
Missing name:* translation		finds multilingual objects whose name attribute is not equal to some name:* attribute and not a composition of name:* attributes, e.g., Italia - Italien - Italy.
Opening hours syntax		correct usage of the opening hours syntax.	​common OH examples ​common mistakes ​complete OH spec
	Enable strict mode.	even stricter rules Preference: validator.OpeningHourTest.strict (default: false)
Overlapping ways		a connection between two nodes is not used by more than one way.	​(video) Using selection, split and middle mouse
	Overlapping (high)ways	two (high)ways that share the same nodes
Power lines		nodes in power lines that do not have a power=tower/pole tag.
Relation checker		errors in relations.
Almost right angle buildings		buildings with an almost right angle. Advanced preferences: validator.RightAngleBuilding.maximumDelta (default: 10.0) validator.RightAngleBuilding.minimumDelta (default: 1.0)
	Building with an almost square angle		If the angle should be a right angle, orthogonalize the way.	yes, #20038
Self-intersecting ways		ways that contain some of their nodes more than once.
	Self-intersecting ways	a way crosses itself	Remove the self-crossing, remove overlapping parts or split way
Similarly named ways		ways with similar names that may have been misspelled.
	Similar named ways	ways with very similar names, possibly a typo
Tag checker		errors in tag keys and values.
	Check property values	misspelled property values. Uses the loaded tagging presets files for checking
	Presets do not contain property key	the property key is in no preset	Check the key or Load the preset	no
	Presets do not contain property value	the property value is in no preset	Check the value or Load the preset	no
	Check for fixme.	any property with the word "fixme" inside
	fixme		Check if you can fix the issue or if it was fixed already. If so, remove the "fixme", otherwise do nothing.	no
Turn-restrictions		​turn-restrictions are valid.
	No "from" way found No "to" way found No "via" node or way found	all necessary elements of a turn restriction relation are present.		no
	More than one "from" way found More than one "to" way found More than one "via" node found	at most one way with role from and to and at most one node with role via in a turn restriction relation.		no
	Cannot mix node and way for role "via"	there is either a "via" node or multiple "via" ways, but not a mix of nodes and ways with role via.		no
	The "from" way does not start or end at a "via" node. The "to" way does not start or end at a "via" node. The "from" and the first "via" way are not connected. The "via" ways are not connected. The last "via" and the "to" way are not connected.	the different parts of a turn restriction relation are connected. is also aware of oneway streets and considers parts unconnected, if they cannot be traveled in the intended order due to the oneway restriction.	Make sure that consecutive member of a turn restriction relation are connected. (Ways must be connected end-to-end.)	no
	Unknown role	the role for members of a turn restriction relation is either from, to (ways) or via (nodes and ways)		no
	Unknown member type	only nodes and ways (and not relations) are members of a turn restriction relation.		no
	Superfluous turn-restriction as "to" way is oneway	The turn restriction is not needed, because the corresponding turn would mean to enter a oneway street from the wrong side.	Verify that the "from" and "to" ways are correctly assigned and delete the relation if it is indeed superfluous.	no
Unclosed Ways		ways which should be circular are closed.
	Unclosed ways	way types, which should be closed really are closed	Close unclosed ways	no
Unconnected highways / natural lands and landuses / power ways / railways / waterways		a way has an endpoint very near to another way. Advanced preferences: validator.UnconnectedWays.node_way_distance (default: 10.0) validator.UnconnectedWays.way_way_distance (default: 0.0)
	Way end node near other highway	End point of a way is very near to other ways	Connect the ways or when really unconnected set a 'noexit' tag to prevent further warnings	no
Untagged and unconnected nodes		untagged nodes that are not part of any way.
	Unconnected nodes without physical tags	untagged nodes that are not part of any way	1. If it is yours node, you are to decide if to remove it otherwise 2. Download parent relations and contact mappers who added these nodes in unclear cases
Untagged, empty and one node ways		untagged, empty and one node ways.
	Incomplete ways	ways with zero or only one node	Removes the way
	Untagged ways	untagged ways	1. describe them correctly if you know this objects or 2. leave them until somebody describes them	no
Way connected to Area		ways connected to areas.
	Way terminates on Area	First/Last node of way connected with area	Optionally, either continue the way, unglue it from area or add a tag describing an entrance.	no
Wrongly Ordered Ways		direction of water, land and coastline ways.
Uncategorized		Descriptions that need to be checked, updated and added to one of the categories above.
	Check property keys	misspelled property keys. See the words.cfg​ for file of misspelled property keys	Replace wrong key with right one
	Empty properties	properties with empty values
	Key 'x' invalid. - ...	illegal key combinations, names and similar issues
	Nodes with the same name	two nodes have equal name
	Unknown property value	proper use of tags	If it is your new tag, it is good idea document it at wiki ​Any tags you like

Tag checker rules

This tab consists of two list and some buttons. On the left side all available rules are listed and on the right side all downloaded and local rules.

Available rules (left)

There is a search text box on top and below first the internal MapCSS rules and then the external ones are listed. Some more info about each item will be displayed in a tooltip when hovering the mouse over it. Items which are already on the Active rules list on the right side are highlighted with a different background color which changes if the item is enabled/disabled on the right side. To get items from the left to the right, select them and use the blue, right arrow head button between the lists. With the button at the bottom reloads the available rules list from JOSM (file).

Active rules (right)

Rules can be enabled/disable with the check box in front of each entry.
The three buttons on the right allow to:

• manually add rules from url or local file
• modify selected entry
• delete items from the list

The reset button at the bottom resets the active rules to default.

MapCSS-based tests

Type	Message	What is checked	Additional help	Autofix
Addresses
Tag combinations
Deprecated features
Geometry
	Overlapping areas	areas overlap	Remove overlapping only when really wrong.	no
Highways
	Highway without a reference	there is a ​ref tag for highways that are tagged tertiary. Not always required, see for instance ​Highway	Optionally, add ​noref=yes	no
Multiple values
Numeric values
Religion
Relations
Territories
Unnecessary tags
Wikipedia

Advanced Preferences

More advanced preferences not described, yet.

• validator.auto_reload_local_rules - wether to auto-reload local rules after file changes
• validator.autozoom - wether to Zoom to problem, automatically
• validator.ignorelist - the ignore list
• validator.ignorelist.version - format version of the ignore list

See also

• Validator panel
• JOSM Validator Custom rules from "Tag Checker Rules"
• MapCSSTagChecker - about the syntax of validator checks, which are based on MapCSS

---

Back to Preferences Dialog
Back to Main Help