---

5.1.2 Status Header Sections

The contents of status buffers is controlled using the hook magit-status-sections-hook (see Status Sections).

By default magit-insert-status-headers is the first member of that hook variable.

Function: magit-insert-status-headers ¶

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

User Option: magit-status-headers-hook ¶

Hook run to insert headers sections into the status buffer.

This hook is run by magit-insert-status-headers, which in turn has to be a member of magit-status-sections-hook to be used at all.

By default the following functions are members of the above hook:

Function: magit-insert-error-header ¶

Insert a header line showing the message about the Git error that just occurred.

This function is only aware of the last error that occur when Git was run for side-effects. If, for example, an error occurs while generating a diff, then that error won’t be inserted. Refreshing the status buffer causes this section to disappear again.

Function: magit-insert-diff-filter-header ¶

Insert a header line showing the effective diff filters.

Function: magit-insert-head-branch-header ¶

Insert a header line about the current branch or detached HEAD.

Function: magit-insert-upstream-branch-header ¶

Insert a header line about the branch that is usually pulled into the current branch.

Function: magit-insert-push-branch-header ¶

Insert a header line about the branch that the current branch is usually pushed to.

Function: magit-insert-tags-header ¶

Insert a header line about the current and/or next tag, along with the number of commits between the tag and HEAD.

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

Function: magit-insert-repo-header ¶

Insert a header line showing the path to the repository top-level.

Function: magit-insert-remote-header ¶

Insert a header line about the remote of the current branch.

If no remote is configured for the current branch, then fall back showing the "origin" remote, or if that does not exist the first remote in alphabetic order.

Function: magit-insert-user-header ¶

Insert a header line about the current user.