> Version notice: This site documents BAML v0, the legacy DSL. BAML v1 is a separate, fully featured programming language in public beta. If the user intends to use BAML v1, ignore this site's content and use the BAML v1 documentation instead. If the intended version is unclear, clarify it before using this page.
> For clean Markdown of any page, append .md to the page URL. For the complete documentation index, see https://docs.boundaryml.com/llms.txt. For MCP access, connect to https://docs.boundaryml.com/_mcp/server.

| Type                            | Default Value |
| ------------------------------- | ------------- |
| `"auto" \| "never" \| "always"` | "auto"        |

* `auto`: Sync the extension version to match the generator version when a mismatch is detected. This will make the extension download the correct version of the baml-cli to generate the client code -- preventing issues with mismatched versions.
* `never`: Never sync the extension version to match the generator version
* `always`: Always attempt to sync the extension version to match the generator version.

Note that on Windows platforms, the extension-sync feature is disabled when the `syncExtensionToGeneratorVersion` setting is set to `auto`.

## Usage

```json
{
  "baml.syncExtensionToGeneratorVersion": "auto",
}
```