Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The runtime version determines the capabilities and features of AL for Business Central. The runtime version can be specified in the app.json file for a project. It's expressed with the following syntax, for example: "runtime": "15.0". Specifying the runtime version is mostly interesting for scenarios where you develop for on-premises or a mix of on-premises and SaaS. For SaaS only development, you'll most likely be interested in using the current runtime. If the runtime setting isn't specified, the compiler detects the runtime that matches the server.
The runtime version specified in the app.json file determines which runtime the project is targeting. An extension can be published to a server with the same or a later runtime version as the runtime version specified in the app.json file of the extension. In the absence of a specified runtime version, the compiler defaults to the latest major available version.
Currently available runtime versions
The most recent runtimes are listed here. For a full list of available runtimes, use IntelliSense in the AL Extension.
| Runtime version | Shipped with | Internal version |
|---|---|---|
13.0 |
Business Central 2024 release wave 1 | 24.0 |
14.0 |
Business Central 2024 release wave 2 | 25.0 |
15.0 |
Business Central 2025 release wave 1 | 26.0 |
16.0 |
Business Central 2025 release wave 2 | 27.0 |
Setting the runtime version
Selecting the runtime depends on the circumstances. If you, for example, have customers that run on older versions, you should set the runtime to be the minimum version that works to ensure compatibility. This prevents you from inadvertently using features that aren't supported on the older server.
If an earlier runtime is picked, it can be good idea to have a daily or weekly build that tests the extension against the latest version of the runtime. Testing against the latest runtime can detect new diagnostics, such as warnings or errors, that are introduced in the compiler or changes in the platform runtime. Though it might not be possible to refactor code for a future runtime, while using an older runtime, staying on top of these changes may help making design decisions early on.