ST Community Docs

Appearance

Command Palette ​

See Also

Reference for Command Palette
Complete documentation on the command palette options.

Overview ​

The command palette bound to Ctrl ⇧ P is an interactive list whose purpose is to execute commands. The command palette is fed by entries in .sublime-commands files. Usually, commands that don't warrant creating a key binding of their own are good candidates for inclusion in a .sublime-commands files.

By default, the command palette includes many useful commands, and provides convenient access to individual settings as well as settings files.

File Format (Commands Files) ​

Commands files use JSON and have the .sublime-commands extension.

Here's an excerpt from Packages/Default/Default.sublime-commands:

json
[
    { "caption": "Project: Save As", "command": "save_project_as" },
    { "caption": "Project: Close", "command": "close_project" },
    { "caption": "Project: Add Folder", "command": "prompt_add_folder" },

    { "caption": "Preferences: Default File Settings", "command": "open_file", "args": {"file": "${packages}/Default/Base File.sublime-settings"} },
    { "caption": "Preferences: User File Settings", "command": "open_file", "args": {"file": "${packages}/User/Base File.sublime-settings"} },
    { "caption": "Preferences: Default Global Settings", "command": "open_file", "args": {"file": "${packages}/Default/Global.sublime-settings"} },
    { "caption": "Preferences: User Global Settings", "command": "open_file", "args": {"file": "${packages}/User/Global.sublime-settings"} },
    { "caption": "Preferences: Browse Packages", "command": "open_dir", "args": {"dir": "$packages"} }
]
caption
Text for display in the command palette.
command
Command to be executed.
args
Arguments to pass to command.

How to Use the Command Palette ​

  1. Press Ctrl ⇧ P
  2. Select command

The command palette filters entries by context. This means that whenever you open it, you won't always see all the commands defined in every .sublime-commands file.