> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Alias Expansion

Warp will automatically expand your aliases as you type in the input editor.

## How to use it

-   [macOS](#tab-panel-743)
-   [Windows](#tab-panel-744)
-   [Linux](#tab-panel-745)

When Alias Expansion is enabled, type an alias and then hit `SPACE` will expand the alias.

To insert a space without expanding an alias, the default keybinding is `OPT-SPACE`.

When Alias Expansion is enabled, type an alias and then hit `SPACE` will expand the alias.

To insert a space without expanding an alias, the default keybinding is `ALT-SPACE`.

When Alias Expansion is enabled, type an alias and then hit `SPACE` will expand the alias.

To insert a space without expanding an alias, the default keybinding is `ALT-SPACE`.

Note

Aliases will not be expanded when the command in the expanded form is the same as the alias itself. e.g. if you have an alias `ls='ls -G'`, `ls` will not be expanded in the input editor.

## How to access it

Alias expansion is disabled by default. There are two ways to toggle this on and off:

-   From Settings: Navigate to **Settings** > **Features** > **Terminal Input** and toggle “Expand aliases as you type”.
-   From the [Command Palette](/terminal/command-palette/#windows): Search for the “Enable/disable alias expansion” option and hit `ENTER`.

## How it works