docs: clarify parameter autofill documentation (#17728)

closes #17706 

Clarify that:
1. URL query parameters work without experiment flag
2. The 'populate recently used parameters' feature still requires the
auto-fill-parameters experiment flag

Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
This commit is contained in:
Edward Angert
2025-05-09 13:01:11 -04:00
committed by GitHub
parent 3ee95f14ce
commit 5c532779af

View File

@ -374,20 +374,20 @@ data "coder_parameter" "jetbrains_ide" {
## Create Autofill
When the template doesn't specify default values, Coder may still autofill
parameters.
parameters in one of two ways:
You need to enable `auto-fill-parameters` first:
- Coder will look for URL query parameters with form `param.<name>=<value>`.
This feature enables platform teams to create pre-filled template creation links.
- Coder can populate recently used parameter key-value pairs for the user.
This feature helps reduce repetition when filling common parameters such as
`dotfiles_url` or `region`.
To enable this feature, you need to set the `auto-fill-parameters` experiment flag:
```shell
coder server --experiments=auto-fill-parameters
```
Or set the [environment variable](../../setup/index.md), `CODER_EXPERIMENTS=auto-fill-parameters`
With the feature enabled:
1. Coder will look for URL query parameters with form `param.<name>=<value>`.
This feature enables platform teams to create pre-filled template creation
links.
2. Coder will populate recently used parameter key-value pairs for the user.
This feature helps reduce repetition when filling common parameters such as
`dotfiles_url` or `region`.