From a71e116a29085b2e2ffb44db2580779a88ccf2fb Mon Sep 17 00:00:00 2001 From: kburym <57193032+kburym@users.noreply.github.com> Date: Tue, 13 Oct 2026 22:49:01 +0200 Subject: [PATCH 1/2] Document description, default and options for workflow_dispatch inputs --- .../workflows-and-actions/workflow-syntax.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md index 0953709ba987..c61799f1922e 100644 --- a/content/actions/reference/workflows-and-actions/workflow-syntax.md +++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md @@ -337,6 +337,18 @@ A boolean specifying whether the input must be supplied. The value of this parameter is a string specifying the data type of the input. This must be one of: `boolean`, `choice`, `number`, `environment` or `string`. +## `on.workflow_dispatch.inputs..description` + +A string description of the input parameter. + +## `on.workflow_dispatch.inputs..default` + +The default value is used when an input parameter isn't specified in a workflow file. + +## `on.workflow_dispatch.inputs..options` + +A sequence of strings that sets the options of the dropdown list. This applies only when the input `type` is `choice`. + ## `permissions` {% data reusables.actions.jobs.section-assigning-permissions-to-jobs %} From be3b5eeffa69777ca11b6ed2686d945c1d67578a Mon Sep 17 00:00:00 2001 From: Kateryna Burym Date: Wed, 4 Nov 2026 15:20:23 +0100 Subject: [PATCH 2/2] Clarify workflow_dispatch input default and options Co-Authored-By: Claude Sonnet 5.5 --- .../reference/workflows-and-actions/workflow-syntax.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md index c61799f1922e..b8c64dd852c5 100644 --- a/content/actions/reference/workflows-and-actions/workflow-syntax.md +++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md @@ -343,11 +343,11 @@ A string description of the input parameter. ## `on.workflow_dispatch.inputs..default` -The default value is used when an input parameter isn't specified in a workflow file. +The default value used when the input is not specified when the workflow is triggered manually. For inputs with `type: choice`, the default must be one of the values listed in `options`. ## `on.workflow_dispatch.inputs..options` -A sequence of strings that sets the options of the dropdown list. This applies only when the input `type` is `choice`. +A sequence of strings that sets the options of the dropdown list. A dropdown list is only shown for inputs with `type: choice`; `options` is ignored for all other input types. ## `permissions`