use-package User Manual
The use-package macro allows you to set up package customization
in your init file in a declarative way. It reduces the need for
repetitive boilerplate code by handling many common customization tasks
for you. These include binding keys, setting hooks, customizing user
options and faces, setting up autoloading, and more. It also helps you
keep Emacs startup fast, even when you use many (even hundreds) of
packages.
Note that use-package is not a package manager. While it provides convenient integration with Emacs’s built-in package manager, its primary purpose is to help with configuring and loading packages, not with downloading, upgrading, or installing them.
This manual is for use-package 2.4.5 as distributed with Emacs 30.2.
Copyright © 2022–2025 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover Texts being “A GNU Manual”, and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License”.
(a) The FSF’s Back-Cover Text is: “You have the freedom to copy and modify this GNU manual.”