Key:created_by

changeset key: created_by
Description
The editor or script that created the changeset.
Group: changeset
Used on:
may be used on changesets
Status on changesets:
de facto

This tag is used to describe the computer program (editor or script) which made the changes', similar to a user agent in the HTTP headers. It is automatically added by editors to a saved changeset, see also a list of other changeset tags Changeset#Tags on changesets / Proposed features/changeset tags. It was also automatically added by editors to individual elements during beginning of OSM, see #History.

As entity key

created_by
Description
The editor or script that created the changeset, node, way or relation. Used before 2009, now only on changesets. Show/edit corresponding data item.
Group: annotations
Used on these elements
should not be used on nodesshould not be used on waysshould not be used on areasshould not be used on relations (except multipolygon relations)may be used on changesets
Status: discardable

It should no longer be added to individual elements, i.e. nodes, ways, or relations. Like other discardable tags, it is automatically removed by many editors. A chronological chart of the of created_by item amounts can be found here.

History

Prior to version 0.6 of the API the created_by=* tag was applied to individual objects (nodes, ways and relations and even segments in earlier protocol versions). However, with the introduction of changesets to provide non-geographic "meta data" it makes more sense for the created_by tag to be recorded there. The number of nodes, ways or relations that still have a created_by tag is slowly decreasing, since this key is silently dropped by OSM editors like JOSM, iD, Potlatch, Potlatch2 when objects get modified.

Guidance

Guidance to users

  • You should not edit this value to record your own name. Your user name will be recorded anyway (and in addition) automatically on upload.
  • You should not remove the created_by tag on objects you are not otherwise modifying. If we wanted to remove them in bulk we'd do it some other way.
  • You may remove the created_by tag on nodes/ways/relations that you are modifying in a changeset anyway. This is what JOSM, iD, Potlatch, Potlatch2 and some other editors do automatically.
  • You may use the created_by tag as an indicator for objects that have not been edited for a long time and could use a review.[1]

Guidance to software developers

The guidance to users plus:

  • You should record a created_by tag on a changeset when saving changes
  • The created_by tag may contain a revision number, version number or similar. This helps people track down problems if a version of your editor/script has a bug in it.
    • Alternatively, potlatch2 splits information into created_by, version and build tags.
  • You should not add or update the created_by tag on nodes/ways/relations.
  • You can remove it silently on edited elements and hide this tag from mappers – it is widely accepted as discardable
  • For translation QA : please add the 'language' version (like: de,en,es,it,hu)

Changeset search

The data from key created_by=* is used as a basis to filter changesets according to the editor software used. For example, OSMCha offers such an option (under Filter >> Editor).

Examples

Tag Used by editor Example changeset
created_by=better osm.org v0.9 better-osm-org 163071469
created_by=bulk_upload.py Bulk_upload.py 3284816
created_by=CoMaps android 2025.05.22-14-test CoMaps 166626185
created_by=Every Door Android 5.2 Every Door 158682052
created_by=FireYak FireYak-Hydrants 153380428
created_by=gnome-maps 47.1 GNOME Maps 158580294
created_by=Go Map!! 4.3.0 Go Map!! 158641307
created_by=gtfs2osm v1.0 Gtfs2osm 165881816
created_by=https_all_the_things/0.2.0 Automated Edits/b-jazz-bot 158665155
created_by=iD 2.30.4 iD 158641308
created_by=iD 261-A OSMC Reitkarte 158611990
created_by=iLOE 1.9 iLOE 26324008
created_by=JOSM/1.5 (19253 en_GB) JOSM 158675608
created_by=Level0 v1.3 Level0 158672783
created_by=MapComplete 0.47.8 MapComplete 158673929
created_by=MAPS.ME android / MAPS.ME ios MAPS.ME 158659373
created_by=Merkaartor 0.20.0 (en) Merkaartor 158430018
created_by=noteSolver_plugin/0.5.0;JOSM/1.5 (19431 en_GB) JOSM + noteSolver JOSM 170031156
created_by=https://openaedmap.org OpenAEDMap 175980254
created_by=OpenStop 0.8.2+21 OpenStop 160464272
created_by=Organic Maps android 2024.10.23-2-FDroid Organic Maps 158677537
created_by=OsmAnd 4.8.6 OsmAnd 158679215
created_by=osmapi/4.2.0 Osmapi_(Python_library) 158833645
created_by=OsmHydrant v1 / http://yapafo.net v0.3 OsmHydrant 153422852
created_by=OsmInEdit 1.0.15 OsmInEdit 158531843
created_by=Osmose Editor Osmose integrated tags editor 158659809
created_by=osmtools/30252 (linux) Revert scripts 158635833
created_by=OSMyBiz OSMyBiz 157646455
created_by=OSM Contributor 3.0.23 OSM Contributor 153254365
created_by=Osm Go! 1.7.0 Android Osm Go! 158647070
created_by=Osm.Org Tags Editor OpenStreetMap Tags Editor 158672442
created_by=osm-relatify git#49d2b51 Relatify 161475467
created_by=osm-revert git#91c563c osm-revert 158677347
created_by=PLanes 0.8.10 Planes 158549622
created_by=Pic4Review 0.5.30 Pic4Review 158491335
created_by=Potlatch Potlatch 158664310
created_by=Rapid 2.4.3 RapiD 158681526
created_by=reverter_plugin/36343;JOSM/1.5 (19230 en)) JOSM + JOSM/Plugins/Reverter 158671918
created_by=RevertUI 1.0 RevertUI 158614860
created_by=StreetComplete 59.3 StreetComplete 158601843
created_by=StreetComplete_ee 59.2 SCEE 158682642
created_by=Vespucci 20.1.4.0 Vespucci 158601448
created_by=https://wheelmap.org wheelmap.org 158678773
created_by=Speed/Limit Flutter App Speed/Limit Flutter App 176063813

References