Key:created_by

From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg changeset | key: created_by
Created by JOSM 15 6115 de.png
Description
Tag representing editor or script which 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

Public-images-osm logo.svg created_by
Created by JOSM 15 6115 de.png
Description
Tag representing editor/script which created/(edited) this item. Edit this description in the wiki page. Edit this description in the 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)

Examples

Tag Used by editor Example changeset
created_by=Every Door Android 5.2 Every Door 158682052 (achavi, OSMLab)
created_by=FireYak FireYak-Hydrants 153380428 (achavi, OSMLab)
created_by=gnome-maps 47.1 GNOME Maps 158580294 (achavi, OSMLab)
created_by=Go Map!! 4.3.0 Go Map!! 158641307 (achavi, OSMLab)
created_by=https_all_the_things/0.2.0 Automated Edits/b-jazz-bot 158665155 (achavi, OSMLab)
created_by=iD 2.30.4 iD 158641308 (achavi, OSMLab)
created_by=iD 261-A OSMC Reitkarte 158611990 (achavi, OSMLab)
created_by=JOSM/1.5 (19253 en_GB) JOSM 158675608 (achavi, OSMLab)
created_by=Level0 v1.3 Level0 158672783 (achavi, OSMLab)
created_by=MapComplete 0.47.8 MapComplete 158673929 (achavi, OSMLab)
created_by=MAPS.ME android / MAPS.ME ios MAPS.ME 158659373 (achavi, OSMLab)
created_by=Merkaartor 0.20.0 (en) Merkaartor 158430018 (achavi, OSMLab)
created_by=OpenStop 0.8.2+21 OpenStop 158677347 (achavi, OSMLab)
created_by=Organic Maps android 2024.10.23-2-FDroid Organic Maps 158677537 (achavi, OSMLab)
created_by=OsmAnd 4.8.6 OsmAnd 158679215 (achavi, OSMLab)
created_by=OsmHydrant v1 / http://yapafo.net v0.3 OsmHydrant 153422852 (achavi, OSMLab)
created_by=OsmInEdit 1.0.15 OsmInEdit 158531843 (achavi, OSMLab)
created_by=Osmose Editor Osmose integrated tags editor 158659809 (achavi, OSMLab)
created_by=osmtools/30252 (linux) Revert scripts 158635833 (achavi, OSMLab)
created_by=OSM Contributor 3.0.23 OSM Contributor 153254365 (achavi, OSMLab)
created_by=Osm Go! 1.7.0 Android Osm Go! 158647070 (achavi, OSMLab)
created_by=Osm.Org Tags Editor OpenStreetMap Tags Editor 158672442 (achavi, OSMLab)
created_by=osm-revert git#91c563c osm-revert 158677347 (achavi, OSMLab)
created_by=PLanes 0.8.10 Planes 158549622 (achavi, OSMLab)
created_by=Pic4Review 0.5.30 Pic4Review 158491335 (achavi, OSMLab)
created_by=Potlatch Potlatch 158664310 (achavi, OSMLab)
created_by=Rapid 2.4.3 RapiD 158681526 (achavi, OSMLab)
created_by=reverter_plugin/36343;JOSM/1.5 (19230 en)) JOSM + JOSM/Plugins/Reverter 158671918 (achavi, OSMLab)
created_by=RevertUI 1.0 RevertUI 158614860 (achavi, OSMLab)
created_by=StreetComplete 59.3 StreetComplete 158601843 (achavi, OSMLab)
created_by=StreetComplete_ee 59.2 SCEE 158682642 (achavi, OSMLab)
created_by=https://wheelmap.org wheelmap.org 158678773 (achavi, OSMLab)
created_by=Vespucci 20.1.4.0 Vespucci 158601448 (achavi, OSMLab)

References