Skip to content


A simple footer widget which is docked to the bottom of its parent container. Displays available keybindings for the currently focused widget.

  • Focusable
  • Container


The example below shows an app with a single keybinding that contains only a Footer widget. Notice how the Footer automatically displays the keybinding.

FooterApp  Q  Quit the app  ?  Show help screen 

from import App, ComposeResult
from textual.binding import Binding
from textual.widgets import Footer

class FooterApp(App):
    BINDINGS = [
        Binding(key="q", action="quit", description="Quit the app"),
            description="Show help screen",
        Binding(key="j", action="down", description="Scroll down", show=False),

    def compose(self) -> ComposeResult:
        yield Footer()

if __name__ == "__main__":
    app = FooterApp()

Reactive Attributes

Name Type Default Description
highlight_key str None Stores the currently highlighted key. This is typically the key the cursor is hovered over in the footer.


This widget sends no messages.

Additional Notes

  • You can prevent keybindings from appearing in the footer by setting the show argument of the Binding to False.
  • You can customize the text that appears for the key itself in the footer using the key_display argument of Binding.

See Also