Key:created_by
![]() |
| Description |
|---|
| The editor or script that created the changeset. |
| Group: changeset |
| Used on: |
| 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
![]() |
| Description |
|---|
| The editor or script that created the changeset, node, way or relation. Used before 2009, now only on changesets. |
| Group: annotations |
| Used on these elements |
| Status: discardable |
| Tools for this tag |
|
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 =* 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 =* 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 |
|---|---|---|
=better osm.org v0.9 |
better-osm-org | 163071469 |
=bulk_upload.py |
Bulk_upload.py | 3284816 |
=CoMaps android 2025.05.22-14-test |
CoMaps | 166626185 |
=Every Door Android 5.2 |
Every Door | 158682052 |
=FireYak |
FireYak-Hydrants | 153380428 |
=gnome-maps 47.1 |
GNOME Maps | 158580294 |
=Go Map!! 4.3.0 |
Go Map!! | 158641307 |
=gtfs2osm v1.0 |
Gtfs2osm | 165881816 |
=https_all_the_things/0.2.0 |
Automated Edits/b-jazz-bot | 158665155 |
=iD 2.30.4 |
iD | 158641308 |
=iD 261-A |
OSMC Reitkarte | 158611990 |
=iLOE 1.9 |
iLOE | 26324008 |
=JOSM/1.5 (19253 en_GB) |
JOSM | 158675608 |
=Level0 v1.3 |
Level0 | 158672783 |
=MapComplete 0.47.8 |
MapComplete | 158673929 |
=MAPS.ME android / MAPS.ME ios |
MAPS.ME | 158659373 |
=Merkaartor 0.20.0 (en) |
Merkaartor | 158430018 |
=OpenStop 0.8.2+21 |
OpenStop | 160464272 |
=Organic Maps android 2024.10.23-2-FDroid |
Organic Maps | 158677537 |
=OsmAnd 4.8.6 |
OsmAnd | 158679215 |
=osmapi/4.2.0 |
Osmapi_(Python_library) | 158833645 |
=OsmHydrant v1 / http://yapafo.net v0.3 |
OsmHydrant | 153422852 |
=OsmInEdit 1.0.15 |
OsmInEdit | 158531843 |
=Osmose Editor |
Osmose integrated tags editor | 158659809 |
=osmtools/30252 (linux) |
Revert scripts | 158635833 |
=OSMyBiz |
OSMyBiz | 157646455 |
=OSM Contributor 3.0.23 |
OSM Contributor | 153254365 |
=Osm Go! 1.7.0 Android |
Osm Go! | 158647070 |
=Osm.Org Tags Editor |
OpenStreetMap Tags Editor | 158672442 |
=osm-relatify git#49d2b51 |
Relatify | 161475467 |
=osm-revert git#91c563c |
osm-revert | 158677347 |
=PLanes 0.8.10 |
Planes | 158549622 |
=Pic4Review 0.5.30 |
Pic4Review | 158491335 |
=Potlatch |
Potlatch | 158664310 |
=Rapid 2.4.3 |
RapiD | 158681526 |
=reverter_plugin/36343;JOSM/1.5 (19230 en)) |
JOSM + JOSM/Plugins/Reverter | 158671918 |
=RevertUI 1.0 |
RevertUI | 158614860 |
=StreetComplete 59.3 |
StreetComplete | 158601843 |
=StreetComplete_ee 59.2 |
SCEE | 158682642 |
=https://wheelmap.org |
wheelmap.org | 158678773 |
=Vespucci 20.1.4.0 |
Vespucci | 158601448 |

