diff --git a/docs/admin/templates/extending-templates/parameters.md b/docs/admin/templates/extending-templates/parameters.md index 5db1473cec3ec..219c4639343a6 100644 --- a/docs/admin/templates/extending-templates/parameters.md +++ b/docs/admin/templates/extending-templates/parameters.md @@ -371,6 +371,29 @@ data "coder_parameter" "jetbrains_ide" { +## Prebuilt workspaces + +Prebuilt workspaces expand on presets and allow you to provision a ready-to-deploy workspace with a defined set of parameters. + +You can use prebuilt workspaces to ensure that workspaces can be deployed within one minute. +Use the `prebuilds` parameter to define how many instances of the template should be stored as a prebuilt workspace. + +When a developer selects the associated template, the workspace will be assigned to that developer and the server will build a new prebuilt workspace. + +For example: + +```hcl +...(more example here) + prebuilds { + instances = 1 + } +``` + +- How to update user-specific data/resources after its assigned? +- Can existing templates be updated? +- Schedule workspaces? +- Do pre-builds in the pool go stale? + ## Create Autofill When the template doesn't specify default values, Coder may still autofill