Query Parameters

When writing some queries that you’d like to reuse later, you may find a reason to want to pass-in a parameter at query runtime instead of altering the query directly. You can use query parameters for that.

For a contrived example, the below query will require that you specify a query parameter project that will be used when interpreting the query.

select:
  Issue Key: key
from: issues
where:
- project = "{params.project}"
- updated > "2023-01-01"

Note

See the “Can use query parameters?” section of Query Structure Overview for information about where these may be used.

You can specify the parameters to use via the --param command-line argument like so:

jira-select run-query --param="project=MYPROJECT" my-query.yaml