---

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 ¶

This hook is run to insert sections into a status buffer.

The functions described in this section, and the functions magit-insert-status-headers and magit-insert-untracked-files, which are described in subsequent sections, are members of this hook.

Some additional functions that can be added to this hook, but are by default added to another hooks, are listed in References Buffer.

Function: magit-insert-status-headers ¶

Insert header sections appropriate for magit-status-mode buffers. The sections are inserted by running the functions on the hook magit-status-headers-hook. See Status Header Sections.

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-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-or-recent ¶

Insert section showing unpushed or other recent commits. If an upstream is configured for the current branch and it is behind of the current branch, then show the commits that have not yet been pushed into the upstream branch. If no upstream is configured or if the upstream is not behind of the current branch, then show the last magit-log-section-commit-count commits.

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.