Choose runtime version in AL

The runtime version determines the capabilities and features of AL for Business Central. You specify the runtime version in the app.json file for a project, for example, "runtime": "18.0". Choose a runtime supported by all environments where you plan to deploy the extension, including Business Central online environments.

An extension requires a server that supports the same or a later runtime version. Its platform, application, and other dependency requirements must also be met. If you don't specify runtime, the compiler defaults to the first runtime version of its current major release. The compiler doesn't detect the target server's runtime.

Currently available runtime versions

The most recent runtimes are listed here. For runtime version suggestions, use IntelliSense in the AL extension.

The Business Central version column identifies the product release, not the value for the runtime setting. In app.json, platform and application separately specify minimum versions of the System symbols and Application package. Learn more in App.json file settings.

Runtime versionShipped withBusiness Central version
16.0Business Central 2025 release wave 227.0
17.0Business Central 2026 release wave 128.0
18.0Business Central 2026 release wave 229.0

Setting the runtime version

If you have customers that run on older versions, set the runtime to the minimum version that supports the features your extension needs. Ensure that all target servers support that runtime. This approach prevents you from inadvertently using runtime features that aren't supported on an older server.

If you target an earlier runtime, consider a daily or weekly build with the latest AL compiler. Also compile for the latest runtime and test on a corresponding Business Central environment to detect runtime-gated diagnostics and platform behavior changes. Tracking these changes can help you make design decisions before you raise the runtime version.

Historical runtime versions

Runtime versionShipped withBusiness Central version
1.0Business Central April 2018 Release12.0
2.0Business Central Fall '18 Release13.0
3.0Business Central Spring '19 Release14.0
4.0Business Central 2019 release wave 215.0
5.0Business Central 2020 release wave 116.0
6.0Business Central 2020 release wave 217.0
6.1Business Central 2020 release wave 2 update 117.1
6.2Business Central 2020 release wave 2 update 217.2
6.3Business Central 2020 release wave 2 update 317.3
6.4Business Central 2020 release wave 2 update 417.4
7.0Business Central 2021 release wave 118.0
7.1Business Central 2021 release wave 1 update 118.1
7.2Business Central 2021 release wave 1 update 318.3
8.0Business Central 2021 release wave 219.0
9.0Business Central 2022 release wave 120.0
9.1Business Central 2022 release wave 1 update 120.1
9.2Business Central 2022 release wave 1 update 420.4
10.0Business Central 2022 release wave 221.0
11.0Business Central 2023 release wave 122.0
12.0Business Central 2023 release wave 223.0
13.0Business Central 2024 release wave 124.0
14.0Business Central 2024 release wave 225.0
15.0Business Central 2025 release wave 126.0

JSON files
Launch JSON file