gitlab-org--gitlab-foss/doc/user/project/merge_requests/versions.md

# Merge requests versions

>**Notes:**
- [Introduced][ce-5467] in GitLab 8.12.
- Comments are disabled while viewing outdated merge versions or comparing to
  versions other than base.
- Merge request versions are based on push not on commit. So, if you pushed 5
  commits in a single push, it will be a single option in the dropdown. If you
  pushed 5 times, that will count for 5 options.

Every time you push to a branch that is tied to a merge request, a new version
of merge request diff is created. When you visit a merge request that contains
more than one pushes, you can select and compare the versions of those merge
request diffs.

![Merge request versions](img/versions.png)

---

By default, the latest version of changes is shown. However, you
can select an older one from version dropdown.

![Merge request versions dropdown](img/versions_dropdown.png)

---

You can also compare the merge request version with an older one to see what has
changed since then.

![Merge request versions compare](img/versions_compare.png)

---

Every time you push new changes to the branch, a link to compare the last
changes appears as a system note.

![Merge request versions system note](img/versions_system_note.png)

[ce-5467]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5467