This is an automated email from the ASF dual-hosted git repository.
kaxilnaik pushed a commit to branch v3-0-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-0-test by this push:
new 535128df066 [v3-0-test] Correct Trigger-Form UI Docs for current
Airflow 3 features (#54799) (#54806)
535128df066 is described below
commit 535128df066118bebeb8b3f6069868b100fa523f
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Aug 22 01:06:37 2025 +0100
[v3-0-test] Correct Trigger-Form UI Docs for current Airflow 3 features
(#54799) (#54806)
(cherry picked from commit 2b10f1a420b397d5d63f4bef4d1b99d3b371d3d4)
Co-authored-by: Jens Scheffler <[email protected]>
---
airflow-core/docs/core-concepts/params.rst | 5 +----
1 file changed, 1 insertion(+), 4 deletions(-)
diff --git a/airflow-core/docs/core-concepts/params.rst
b/airflow-core/docs/core-concepts/params.rst
index f313f0bd159..ac42a527c9c 100644
--- a/airflow-core/docs/core-concepts/params.rst
+++ b/airflow-core/docs/core-concepts/params.rst
@@ -349,10 +349,7 @@ The following features are supported in the Trigger UI
Form:
- If you want to have params not being displayed, use the ``const`` attribute.
These Params will be submitted but hidden in the Form.
The ``const`` value must match the default value to pass `JSON Schema
validation
<https://json-schema.org/understanding-json-schema/reference/generic.html#constant-values>`_.
- On the bottom of the form the generated JSON configuration can be expanded.
- If you want to change values manually, the JSON configuration can be
adjusted. Changes are overridden when form fields change.
-- To pre-populate values in the form when publishing a link to the trigger
form you can call the trigger URL ``/dags/<dag_name>/trigger``
- and add query parameter to the URL in the form ``name=value``, for example
``/dags/example_params_ui_tutorial/trigger?required_field=some%20text``.
- To pre-define the run id of the DAG run, use the URL parameter ``run_id``.
+ If you want to change values manually, the JSON configuration can be
adjusted. Changes in the JSON will be reflected in the form fields.
- Fields can be required or optional. Typed fields are required by default to
ensure they pass JSON schema validation. To make typed fields optional, you
must allow the "null" type.
- Fields without a "section" will be rendered in the default area. Additional
sections will be collapsed by default.
