Skip to content

Add help to argument parameter #2983

Closed

Description

@Rowlando13

We are now open to a PR for adding a help kwarg to arguments in the same way that there is for options and adjusting the help pages to account for this.

Help Pages

@click.command()
@click.argument('name', help='The name to print')
@click.option('--count', default=1, help='number of greetings')
def hello(name: str, count: int):
    """This script prints hello and a name one or more times."""
    for x in range(count):
        if name:
            click.echo(f"Hello {name}!")
        else:
            click.echo("Hello!")

Activity

  1. KarinaNi commented on Jun 26, 2025

    @KarinaNi
  2. Rowlando13 commented on Jun 26, 2025

    @Rowlando13
    MemberAuthor

    @KarinaNi Let's try the other issue first. It is a bit more approachable.

  3. yurishevtsov commented on May 19, 2026

    @yurishevtsov
    Contributor

    @Rowlando13 PR open and ready for review. Let me know if you have any feedback.

  4. added this to the 8.5.0 milestone on May 23, 2026
  5. changed the title [-]Add help kwarg to argument parameter[/-] [+]Add `help` to argument parameter[/+] on May 23, 2026
  6. linked a pull request that will close this issueSupport help message for argument #1051on May 23, 2026
  7. added a commit that references this issue on May 28, 2026
    684b3f5
  8. locked as resolved and limited conversation to collaborators on Jul 24, 2026
  9. added
    parsingParsing, parameters, commands, chaining, context
    and removed on Aug 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    help outputHelp text formatting, layout, and --help renderingparsingParsing, parameters, commands, chaining, context

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions