How to use custom image in a DLT pipeline

Add the "dbr_version" tag in your JSON settings.

Last published at: July 25th, 2025

Introduction

You want to use a custom image in a DLT pipeline.

1. From your DLT pipeline UI, click Settings.

2. Click the JSON button in the pipeline settings view.

3. Add a new tag using "" with the custom image name (prefixed with custom:). The following code provides an example.

"dbr_version": "custom:15.4.16-delta-pipelines-dlt-release-dp-2025.23-rc0-commit-XXXXXXX-image-XXXXXXX",

"dbr_version" should be a JSON element at the same level as the “channel”, as demonstrated in the following screenshot.

4. Click Save.

5. Validate the "Databricks Runtime Version" in the cluster details of the running pipeline.