---

5.1.1 Status Sections ¶

The contents of status buffers is controlled using the hook magit-status-sections-hook. See Section Hooks to learn about such hooks and how to customize them.

User Option: magit-status-sections-hook ¶

Hook run to insert sections into a status buffer.

The first function on that hook by default is magit-insert-status-headers; it is described in the next section. By default the following functions are also members of that hook:

Function: magit-insert-merge-log ¶

Insert section for the on-going merge. Display the heads that are being merged. If no merge is in progress, do nothing.

Function: magit-insert-rebase-sequence ¶

Insert section for the on-going rebase sequence. If no such sequence is in progress, do nothing.

Function: magit-insert-am-sequence ¶

Insert section for the on-going patch applying sequence. If no such sequence is in progress, do nothing.

Function: magit-insert-sequencer-sequence ¶

Insert section for the on-going cherry-pick or revert sequence. If no such sequence is in progress, do nothing.

Function: magit-insert-bisect-output ¶

While bisecting, insert section with output from git bisect.

Function: magit-insert-bisect-rest ¶

While bisecting, insert section visualizing the bisect state.

Function: magit-insert-bisect-log ¶

While bisecting, insert section logging bisect progress.

Function: magit-insert-untracked-files ¶

Maybe insert a list or tree of untracked files.

Do so depending on the value of status.showUntrackedFiles. Note that even if the value is all, Magit still initially only shows directories. But the directory sections can then be expanded using TAB.

If the first element of magit-buffer-diff-files is a directory, then limit the list to files below that. The value of that variable can be set using D -- DIRECTORY RET g.

Function: magit-insert-unstaged-changes ¶

Insert section showing unstaged changes.

Function: magit-insert-staged-changes ¶

Insert section showing staged changes.

Function: magit-insert-stashes &optional ref heading ¶

Insert the stashes section showing reflog for "refs/stash". If optional REF is non-nil show reflog for that instead. If optional HEADING is non-nil use that as section heading instead of "Stashes:".

Function: magit-insert-unpulled-from-upstream ¶

Insert section showing commits that haven’t been pulled from the upstream branch yet.

Function: magit-insert-unpulled-from-pushremote ¶

Insert section showing commits that haven’t been pulled from the push-remote branch yet.

Function: magit-insert-unpushed-to-upstream ¶

Insert section showing commits that haven’t been pushed to the upstream yet.

Function: magit-insert-unpushed-to-pushremote ¶

Insert section showing commits that haven’t been pushed to the push-remote yet.

The following functions can also be added to the above hook:

Function: magit-insert-tracked-files ¶

Insert a tree of tracked files.

Function: magit-insert-ignored-files ¶

Insert a tree of ignored files. Its possible to limit the logs in the current buffer to a certain directory using D = f <DIRECTORY> RET g. If you do that, then that that also affects this command.

The log filter can be used to limit to multiple files. In that case this function only respects the first of the files and only if it is a directory.

Function: magit-insert-skip-worktree-files ¶

Insert a tree of skip-worktree files. If the first element of magit-buffer-diff-files is a directory, then limit the list to files below that. The value of that variable can be set using D -- DIRECTORY RET g.

Function: magit-insert-assumed-unchanged-files ¶

Insert a tree of files that are assumed to be unchanged. If the first element of magit-buffer-diff-files is a directory, then limit the list to files below that. The value of that variable can be set using D -- DIRECTORY RET g.

Function: magit-insert-unpulled-or-recent-commits ¶

Insert section showing unpulled or recent commits. If an upstream is configured for the current branch and it is ahead of the current branch, then show the missing commits. Otherwise, show the last magit-log-section-commit-count commits.

Function: magit-insert-recent-commits ¶

Insert section showing the last magit-log-section-commit-count commits.

User Option: magit-log-section-commit-count ¶

How many recent commits magit-insert-recent-commits and magit-insert-unpulled-or-recent-commits (provided there are no unpulled commits) show.

Function: magit-insert-unpulled-cherries ¶

Insert section showing unpulled commits. Like magit-insert-unpulled-commits but prefix each commit that has not been applied yet (i.e., a commit with a patch-id not shared with any local commit) with "+", and all others with "-".

Function: magit-insert-unpushed-cherries ¶

Insert section showing unpushed commits. Like magit-insert-unpushed-commits but prefix each commit which has not been applied to upstream yet (i.e., a commit with a patch-id not shared with any upstream commit) with "+" and all others with "-".

See References Buffer for some more section inserters, which could be used here.