Changeset

Nodes, ways, and relations created or modified in JOSM are only available locally unless they are published on a server to make them useful for other mappers. The process of publishing data is called uploading.

Because there are hundreds of mappers publishing their geo-data on the OSM server it is important to track who published what data in which context. It would be tedious for mappers to describe for every single node and every single way why it is published. A more convenient approach is to package a group of related objects and assign the package a comment, not the individual objects. This way, if a mapper maps his or her neighborhood, he or she can upload a package of nodes and ways and assign it a comment "mapped and reviewed some ways in foo city".

In JOSM such a package is called a changeset. A changeset is a collection of related changes (new objects, object modifications, or object deletings) applied to OSM data.

Changesets and upload operations

A changeset is independent from an individual upload operation.

You can run multiple uploads with the same changeset. The changeset will then package the changes published in all uploads. A mapper can even stop JOSM, start it a day later and continue to publish to the changeset he or she has been using a day before, provided he or she didn't close the changeset.

Properties of changesets

A changeset is initially opened and it stays open until it is closed. A JOSM user can explicitly close one or more of his open changesets. If he doesn't close them, the OSM server will close open changeset automatically after a timeout. A changeset which isn't open is called closed. It stays closed forever and can't be reopened.

A changeset you open is owned by you. No other mapper can publish data in this changeset and you can't upload your data in other users changesets.

Upload comment and other changeset tags

Similar to nodes, ways, and relations, it is possible to decorate changesets with tags.

The most important and only compulsory tag is the so called upload comment. When you publish data in JOSM you are required to enter an upload comment with at least three characters. It is this comment which describes the published data for other mappers.

Advanced Preferences

You can set the advanced preference upload.comment.max-age to 0 if you do not want to get a pre-filled comment text field. You still can select a previous comment from the drop down box.

See also

• Help/Action/Upload - An in-depth article about upload process
• Conflict - explains the conflicts, why they occur, how they are detected and how you can resolve them
• Close Changeset
• ​Good Changeset comments page in OSM wiki

---

Back to Main Help