The mode-line is the bar in Conkeror's gui between the browser and the minibuffer. With a default configuration, it tells the buffer's current url, the scroll position, and the current time. All of this can be customized. You can even disable the mode-line completely.

1. Enabling and Disabling the Mode Line

1.1. Interactively

The mode-line can be toggled on and off with the palindromic interactive command, mode-line-mode.

M-x mode-line-mode

1.2. With JavaScript

You can turn the mode-line on and off in your rc, too. Simply call the function mode_line_mode. If you pass no argument, it toggles the mode-line, as with the interactive command described earlier. If you pass true, it turns the mode line on, and if you pass false, it turns the mode line off. Since the mode-line is on by default, and most people who will come looking here will do so because they want to turn it off, here is the full code to turn off the mode-line in your rc.

mode_line_mode(false);

2. Configuring the Mode Line

The contents of a mode-line are called mode-line widgets. Certain widgets are there by default. Other widgets are available, but not enabled by default. You can even write your own widgets. Widgets can be added and removed from the mode-line by configuring mode_line_hook. Changes to this hook will not affect mode-lines that already exist, only future ones. So if you are configuring the mode-line interactive, you can make your changes take effect by calling:

M-x mode-line-mode
M-x mode-line-mode

or in javascript:

mode_line_mode(false);
mode_line_mode(true);

2.1. Widgets

2.1.1. Buffer Count

This widget shows how many buffers are in the current window, and which one is currently selected. To enable it:

2.1.5. Navigation Buttons

This is a row of buttons that call basic navigation commands for the current buffer. Hovering over them tells you the command and the corresponding keystroke. This widget is provided in a module in Conkeror's contrib directory.