forgejo-docs/docs/user/blame.md

---
title: 'Blame File View'
license: 'Apache-2.0'
origin_url: 'https://github.com/go-gitea/gitea/blob/e865de1e9d65dc09797d165a51c8e705d2a86030/docs/content/usage/blame.en-us.md'
---

Forgejo supports viewing the line-by-line revision history for a file also known as blame view.
You can also use [`git blame`](https://git-scm.com/docs/git-blame) on the command line to view the revision history of lines within a file.

![Blame view of a file](../_images/user/blame/view.png)

1. Navigate to and open the file whose line history you want to view.
1. Click the `Blame` button in the file header bar.
1. The new view shows the line-by-line revision history for a file with author and commit information on the left side.
1. To navigate to an older commit, click the icon.

## Ignore commits in the blame view

All revisions specified in the `.git-blame-ignore-revs` file are hidden from the blame view.
This is especially useful to hide reformatting changes and keep the benefits of `git blame`.
Lines that were changed or added by an ignored commit will be blamed on the previous commit that changed that line or nearby lines.
The `.git-blame-ignore-revs` file must be located in the root directory of the repository.
For more information like the file format, see [the `git blame --ignore-revs-file` documentation](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt).

### Bypassing `.git-blame-ignore-revs` in the blame view

If the blame view for a file shows a message about ignored revisions, you can see the normal blame view by appending the url parameter `?bypass-blame-ignore=true`.
user: blame: adapt to Forgejo (#146) Caution: it needs to be squashed before merge to be backported. It is kept as two commits to preserve the original version. Reviewed-on: https://codeberg.org/forgejo/docs/pulls/146 Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org> Co-authored-by: Earl Warren <contact@earl-warren.org> Co-committed-by: Earl Warren <contact@earl-warren.org> 2023-09-22 13:58:24 -04:00			`---`
			`title: 'Blame File View'`
			`license: 'Apache-2.0'`
sync with Gitea e865de1e9d65dc09797d165a51c8e705d2a86030 cd docs git diff d3982bcd814bac93e3cbce1c7eb749b17e413fbd..e865de1e9d65dc09797d165a51c8e705d2a86030 -- $(find . -type f -name 'en-us') 2024-04-21 09:56:01 -04:00			`origin_url: 'https://github.com/go-gitea/gitea/blob/e865de1e9d65dc09797d165a51c8e705d2a86030/docs/content/usage/blame.en-us.md'`
user: blame: adapt to Forgejo (#146) Caution: it needs to be squashed before merge to be backported. It is kept as two commits to preserve the original version. Reviewed-on: https://codeberg.org/forgejo/docs/pulls/146 Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org> Co-authored-by: Earl Warren <contact@earl-warren.org> Co-committed-by: Earl Warren <contact@earl-warren.org> 2023-09-22 13:58:24 -04:00			`---`

			`Forgejo supports viewing the line-by-line revision history for a file also known as blame view.`
			You can also use [`git blame`](https://git-scm.com/docs/git-blame) on the command line to view the revision history of lines within a file.

			`![Blame view of a file](../_images/user/blame/view.png)`

			`1. Navigate to and open the file whose line history you want to view.`
			1. Click the `Blame` button in the file header bar.
			`1. The new view shows the line-by-line revision history for a file with author and commit information on the left side.`
			`1. To navigate to an older commit, click the icon.`

			`## Ignore commits in the blame view`

			All revisions specified in the `.git-blame-ignore-revs` file are hidden from the blame view.
			This is especially useful to hide reformatting changes and keep the benefits of `git blame`.
			`Lines that were changed or added by an ignored commit will be blamed on the previous commit that changed that line or nearby lines.`
			The `.git-blame-ignore-revs` file must be located in the root directory of the repository.
			For more information like the file format, see [the `git blame --ignore-revs-file` documentation](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt).

			### Bypassing `.git-blame-ignore-revs` in the blame view

			If the blame view for a file shows a message about ignored revisions, you can see the normal blame view by appending the url parameter `?bypass-blame-ignore=true`.