Skip to main content

License Templates

The license subcommand provides functionality for managing license templates. License templates help you quickly add popular open-source licenses to your projects with proper formatting and legal text.

Usage

gh-templates license <COMMAND>

Available Commands

CommandDescription
addAdd one or more license templates to the repository
listList available license templates
previewPreview a specific license template

Examples

List Available Licenses

gh-templates license list

Preview a License

gh-templates license preview mit

Add Single License

gh-templates license add mit

Add Multiple Licenses

gh-templates license add mit apache-2.0 -o LICENSE-MIT LICENSE-APACHE-2.0

Common licenses available include:

  • MIT: Simple and permissive license
  • Apache-2.0: Apache License 2.0 with patent protection
  • GPL-3.0: GNU General Public License v3.0
  • BSD-3-Clause: 3-clause BSD license
  • ISC: Internet Systems Consortium license
  • Unlicense: Public domain dedication

Output Location

By default, license files are saved to the repository root as LICENSE (or with appropriate extensions). This follows standard conventions for license placement.

License Customization

Many license templates include placeholder fields that may need customization:

  • Copyright holder name: Your name or organization
  • Year: Current year or range of years
  • Project name: Name of your project

Next Steps